Meilisearch Open-Source Engine

✨ Enhancement

• Add filter condition to DSRs by @dureuill in https://github.com/meilisearch/meilisearch/pull/6505

#### New filter rule activation condition

Dynamic search rules (DSR) can now declare a new filter condition: it contains a single values key, whose value is a JSON object.

The keys of this values JSON object are the facet names (e.g., color, genres, ...), while their values are the values that a filter must resolve to for these facets, so that the rule is active.

<details>

<summary>Example of sending a DSR with a filter condition</summary>

	// PATCH /dynamic-search-rules/test-filter

	{
	  "conditions": {
	    "filter": {
	      "values": {
	        "color": "red",
	        "category": "shirt"
	      }
	    }
	  },
	  "actions": [
	    {
	      "selector": { "id": "red shirt on sales" },
	      "action": { "type": "pin", "position": 0 }
	    }
	  ]
	}

</details>

<details>

<summary>Example of search query that enables the DSR above</summary>

	{
	  "filter": "(category = shirt AND color = red) OR (category = jeans AND color = blue)"
	}

</details>

Note that the filter only needs to have one branch resolving to all the facet values declared in the rule for the rule to be active.

#### New lastUpdatedAt field

Dynamic search rules returned by GET /dynamic-search-rules/{:ruleUid} and POST /dynamic-search-rules contain an additional lastUpdatedAt field.

This field is automatically updated with the enqueuedAt value of the last task that modified the rule.

#### Rules are listed with the most recently updated first

POST /dynamic-search-rules now lists rules in descending lastUpdatedAt order, meaning that the most recently updated rules will be listed first.

#### New environment variables

New environment variables are defined to control the behavior of the DSR fuel:

• MEILI_EXPERIMENTAL_DSR_FUEL_FILTER_FUEL (in range 0..4294967296): controls how many filter constraint combinations Meilisearch will attempt to resolve at search time before giving up and applying partial rules.
• MEILI_EXPERIMENTAL_DSR_FUEL_FILTER_OR_FUEL (in range 0..65536): controls how many filter disjunctions Meilisearch will build when turning a filter to its canonical shape
• MEILI_EXPERIMENTAL_DSR_FUEL_FILTER_AND_FUEL (in range 0..65536): controls how many filter conjunctions Meilisearch will build in total when turning a filter to its canonical shape
• MEILI_EXPERIMENTAL_DSR_FUEL_FILTER_DEPTH_FUEL (in range 0..256): controls the maximum recursive depth that Meilisearch allows when turning a filter to its canonical shape

• Speed up search requests by @Kerollmops in https://github.com/meilisearch/meilisearch/pull/6528

Improves Meilisearch search speed by avoiding unnecessary internal work. We drastically reduced the number of times we retrieve data from disk to a single time across the whole search pipeline. This improvement will have the greatest effect on datasets with a large number of distinct fields across documents. We have seen search speeds up to 5.4x on a dataset with more than 14k different fields.

• Stabilize dumpless upgrade by @curquiza in https://github.com/meilisearch/meilisearch/pull/6486

⚠️ Breaking change following the stabilization of an experimental feature ⚠️

The flag —-experimental-dumpless-upgrade is renamed —-upgrade-db, keeping the exact same behavior.

• Remove unused experimental features by @curquiza in https://github.com/meilisearch/meilisearch/pull/6489

⚠️ Breaking change: removing the following experimental features ⚠️

• Replication parameters: removing --experimental-replication-parameters because outdated. We now have another way to handle replication.
• [Import dumps with old document inde

<p align="center">

<a href="https://www.meilisearch.com/?utm_campaign=oss&utm_source=github&utm_medium=meilisearch&utm_content=logo#gh-light-mode-only" target="_blank">

<img src="assets/meilisearch-logo-light.svg?sanitize=true#gh-light-mode-only">

</a>

<a href="https://www.meilisearch.com/?utm_campaign=oss&utm_source=github&utm_medium=meilisearch&utm_content=logo#gh-dark-mode-only" target="_blank">

<img src="assets/meilisearch-logo-dark.svg?sanitize=true#gh-dark-mode-only">

</a>

</p>

<h4 align="center">

<a href="https://www.meilisearch.com/?utm_campaign=oss&utm_source=github&utm_medium=meilisearch&utm_content=nav">Website</a> |

<a href="https://roadmap.meilisearch.com/tabs/1-under-consideration">Roadmap</a> |

<a href="https://www.meilisearch.com/pricing?utm_campaign=oss&utm_source=github&utm_medium=meilisearch&utm_content=nav">Meilisearch Cloud</a> |

<a href="https://blog.meilisearch.com/?utm_campaign=oss&utm_source=github&utm_medium=meilisearch&utm_content=nav">Blog</a> |

<a href="https://www.meilisearch.com/docs?utm_campaign=oss&utm_source=github&utm_medium=meilisearch&utm_content=nav">Documentation</a> |

<a href="https://www.meilisearch.com/docs/faq?utm_campaign=oss&utm_source=github&utm_medium=meilisearch&utm_content=nav">FAQ</a> |

<a href="https://discord.meilisearch.com/?utm_campaign=oss&utm_source=github&utm_medium=meilisearch&utm_content=nav">Discord</a>

</h4>

<p align="center">

<a href="https://deps.rs/repo/github/meilisearch/meilisearch"><img src="https://deps.rs/repo/github/meilisearch/meilisearch/status.svg" alt="Dependency status"></a>

<a href="https://github.com/meilisearch/meilisearch/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-informational" alt="License"></a>

<a href="https://github.com/meilisearch/meilisearch/queue"><img alt="Merge Queues enabled" src="https://img.shields.io/badge/Merge_Queues-enabled-%2357cf60?logo=github"></a>

</p>

<p align="center">⚡ A lightning-fast search engine that fits effortlessly into your apps, websites, and workflow 🔍</p>

Meilisearch helps you shape a delightful search experience in a snap, offering features that work out of the box to speed up your workflow.

<p align="center" name="demo">

<a href="https://where2watch.meilisearch.com/?utm_campaign=oss&utm_source=github&utm_medium=meilisearch&utm_content=demo-gif#gh-light-mode-only" target="_blank">

<img src="assets/demo-light.gif#gh-light-mode-only" alt="A bright colored application for finding movies screening near the user">

</a>

<a href="https://where2watch.meilisearch.com/?utm_campaign=oss&utm_source=github&utm_medium=meilisearch&utm_content=demo-gif#gh-dark-mode-only" target="_blank">

<img src="assets/demo-dark.gif#gh-dark-mode-only" alt="A dark colored application for finding movies screening near the user">

</a>

</p>

🖥 Examples

• Movies — An application to help you find streaming platforms to watch movies using hybrid search.
• Flickr — Search and explore one hundred million Flickr images with semantic search.
• Ecommerce — Ecommerce website using disjunctive facets, range and rating filtering, and pagination.
• Home Booking - A conversational search demo for finding holiday rentals using natural language.
• Search Playground — An interactive playground to explore Meilisearch search features.
• Personalization — A demo showcasing personalized search results tailored to individual users.
• SaaS — Search for contacts, deals, and companies in this multi-tenant CRM application.

See the list of all our example apps in our demos repository.

✨ Features

• Hybrid search: Combine the best of both semantic & full-text search to get the most relevant results
• Search-as-you-type: Find & display results in less than 50 milliseconds to provide an intuitive experience
• Typo tolerance: get relevant matches even when queries contain typos and misspellings
• Filtering and faceted search: enhance your users' search experience with custom filters and build a faceted search interface in a few lines of code
• Sorting: sort results based on price, date, or pretty much anything else your users need
• Synonym support: configure synonyms to include more relevant content in your search results
• Geosearch: filter and sort documents based on geographic data
• Extensive language support: search datasets in any language, with optimized support for Chinese, Japanese, Hebrew, and languages using the Latin alphabet
• Security management: control which users can access what data with API keys that allow fine-grained permissions handling
• Multi-Tenancy: personalize search results for any number of application tenants
• Highly Customizable: customize Meilisearch to your specific needs or use our out-of-the-box and hassle-free presets
• RESTful API: integrate Meilisearch in your technical stack with our plugins and SDKs
• Conversational search: let users ask questions in natural language and get AI-generated answers grounded in your search results
• Personalization: tailor search results to individual users based on their preferences and behavior
• Search rules: define custom rules to dynamically adjust search behavior based on context
• Document relations: link documents across indexes to enrich search results with related data
• Replication & sharding: scale horizontally by distributing your data across multiple nodes
• AI-ready: works out of the box with LangChain and the Model Context Protocol (MCP)
• Easy to install, deploy, and maintain

📖 Documentation

You can consult Meilisearch's documentation at meilisearch.com/docs.

🚀 Getting started

For basic instructions on how to set up Meilisearch, add documents to an index, and search for documents, take a look at our documentation guide.

🌍 Supercharge your Meilisearch experience

Say goodbye to server deployment and manual updates with Meilisearch Cloud. Additional features include analytics & monitoring in many regions around the world. No credit card is required.

🧰 SDKs & integration tools

Install one of our SDKs in your project for seamless integration between Meilisearch and your favorite language or framework!

Take a look at the complete Meilisearch integration list.

Logos belonging to different languages and frameworks supported by Meilisearch, including React, Ruby on Rails, Go, Rust, and PHP

⚙️ Advanced usage

Experienced users will want to keep our API Reference close at hand.

We also offer a wide range of dedicated guides to all Meilisearch features, such as filtering, sorting, geosearch, API keys, and tenant tokens.

Finally, for more in-depth information, refer to our articles explaining fundamental Meilisearch concepts such as documents and indexes.

🧾 Editions & Licensing

Meilisearch is available in two editions:

🧪 Community Edition (CE)

• Fully open source under the MIT license
• Core search engine with fast and relevant full-text, semantic or hybrid search
• Free to use for anyone, including commercial usage

🏢 Enterprise Edition (EE)

• Includes advanced features such as:
• Sharding
• S3-streaming snapshots
• Governed by a commercial license or the Business Source License 1.1
• Not allowed in production without a commercial agreement with Meilisearch.
• You may use, modify, and distribute the Licensed Work for non-production purposes only, such as testing, development, or evaluation.

Want access to Enterprise features? → Contact us at sales@meilisearch.com.

📦 External crates

Meilisearch vendors the following MIT-licensed external crates with code modifications to use the HTTP client located in crates/http-clients:

• external-crates/async-openai and external-crates/async-openai-macros from <https://github.com/64bit/async-openai>
• external-crates/reqwest-eventsource from <https://github.com/jpopesculian/reqwest-eventsource>

📊 Telemetry

Meilisearch collects anonymized user data to help us improve our product. You can deactivate this whenever you want.

To request deletion of collected data, please write to us at privacy@meilisearch.com. Remember to include your Instance UID in the message, as this helps us quickly find and delete your data.

If you want to know more about the kind of data we collect and what we use it for, check the telemetry section of our documentation.

#