---
id: meilisearch-python-sdk
version: "7.5.0"
license: MIT License Copyright (c) 2021 Paul Sanders Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# meilisearch-python-sdk — A Python client providing both async and sync support for the Meilisearch API

License: permissive · Maintenance: active · Downloads: 192.5K/mo

## What it is and what it does

This package is a Python wrapper around the Meilisearch search engine API, offering both synchronous and asynchronous client implementations. It handles document indexing, search queries with filtering and highlighting, and task status tracking. The async client is designed for use in asyncio-based applications like FastAPI, while the sync client works in traditional blocking code; both expose the same underlying functionality through their respective calling conventions.

The SDK depends on aiofiles, camel-converter, httpx2, and pydantic to manage async file operations, data transformation, HTTP communication, and request validation. It is actively maintained, supports Python 3.10 through 3.14, and carries no known security vulnerabilities. The library is positioned as a community alternative to the official Meilisearch Python client, with independent benchmarks suggesting performance advantages in async scenarios.

Use it for:

- Building a FastAPI application that indexes and searches documents asynchronously without blocking the event loop.
- Adding full-text search to a web application by managing document ingestion and query execution through a Python client.
- Batch-indexing large document collections using the async client for improved throughput over the sync alternative.
- Implementing search with custom filters and highlighting (e.g., filtering by date range and highlighting matching terms).
- Monitoring indexing progress by retrieving task status after submitting documents for processing.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides both async and sync Python clients for the Meilisearch search API, enabling document indexing and full-text search operations.

Yes. The package is actively maintained, carries no known vulnerabilities, installs with low friction, and offers both sync and async interfaces for Meilisearch integration. Choose it if you need a Python client for Meilisearch and prefer async support or community-driven development; the official Meilisearch Python library is the alternative if you prefer an officially maintained option.

## Install

pip install meilisearch-python-sdk
uv add meilisearch-python-sdk
poetry add meilisearch-python-sdk

## Installing meilisearch-python-sdk

Before you install: Low install friction with a pure-wheel distribution. Active maintenance with a release 3 days ago and commits through 2026-08-14. Supports modern Python versions (3.10–3.14) and is marked Production/Stable.

License in practice: MIT License permits unrestricted use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart:

pip install meilisearch-python-sdk

from meilisearch_python_sdk import Client

with Client('http://127.0.0.1:7700', 'masterKey') as client:
    index = client.index('books')
    index.add_documents([{'id': 1, 'title': 'Ready Player One'}])
    results = index.search('ready player')

Requires a running Meilisearch server instance (e.g., via Docker or local installation) accessible at the specified URL.

Verify before relying:

- Whether the optional orjson extra measurably improves performance in typical workloads.
- Compatibility guarantees with Meilisearch server versions beyond those tested in CI.

## Package facts

- License: MIT License Copyright (c) 2021 Paul Sanders Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 192.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

meilisearch python client, async search api sdk, full-text search indexing, document search library, meilisearch integration, python search client, search-engine, async-first

[View on SkillFed](https://skillfed.io/packages/meilisearch-python-sdk) · [View on PyPI](https://pypi.org/project/meilisearch-python-sdk/)