Add hybrid search

Author: Strift

README.md

@@ -143,6 +143,27 @@ JSON output:
 }
 ```
 
+#### Hybrid Search <!-- omit in toc -->
+
+Hybrid search combines traditional keyword search with semantic search for more relevant results. You need to have an embedder configured in your index settings to use this feature.
+
+```python
+# Using hybrid search with the search method
+index.search(
+  'action movie',
+  {
+    "hybrid": {"semanticRatio": 0.5, "embedder": "default"}
+  }
+)
+```
+
+The `semanticRatio` parameter (between 0 and 1) controls the balance between keyword search and semantic search:
+- 0: Only keyword search
+- 1: Only semantic search
+- Values in between: A mix of both approaches
+
+The `embedder` parameter specifies which configured embedder to use for the semantic search component.
+
 #### Custom Search With Filters <!-- omit in toc -->
 
 If you want to enable filtering, you must add your attributes to the `filterableAttributes` index setting.

meilisearch/index.py

@@ -280,14 +280,15 @@ def get_stats(self) -> IndexStats:
     def search(self, query: str, opt_params: Optional[Mapping[str, Any]] = None) -> Dict[str, Any]:
         """Search in the index.
 
+        https://www.meilisearch.com/docs/reference/api/search
+
         Parameters
         ----------
         query:
             String containing the searched word(s)
         opt_params (optional):
             Dictionary containing optional query parameters.
-            Note: The vector parameter is only available in Meilisearch >= v1.13.0
-            https://www.meilisearch.com/docs/reference/api/search#search-in-an-index
+            For hybrid search, include a 'hybrid' object with 'semanticRatio' and 'embedder' fields.
 
         Returns
         -------
@@ -301,7 +302,9 @@ def search(self, query: str, opt_params: Optional[Mapping[str, Any]] = None) ->
         """
         if opt_params is None:
             opt_params = {}
+
         body = {"q": query, **opt_params}
+
         return self.http.post(
             f"{self.config.paths.index}/{self.uid}/{self.config.paths.search}",
             body=body,

meilisearch/models/__init__.py

@@ -0,0 +1 @@
+

tests/index/test_index_search_meilisearch.py

@@ -503,13 +503,22 @@ def test_show_ranking_score(index_with_documents):
 
 
 def test_vector_search(index_with_documents_and_vectors):
+    """Tests vector search with hybrid parameters."""
     response = index_with_documents_and_vectors().search(
         "",
         opt_params={"vector": [0.1, 0.2], "hybrid": {"semanticRatio": 1.0, "embedder": "default"}},
     )
     assert len(response["hits"]) > 0
 
 
+def test_hybrid_search(index_with_documents_and_vectors):
+    """Tests hybrid search with semantic ratio and embedder."""
+    response = index_with_documents_and_vectors().search(
+        "movie", opt_params={"hybrid": {"semanticRatio": 0.5, "embedder": "default"}}
+    )
+    assert len(response["hits"]) > 0
+
+
 def test_search_distinct(index_with_documents):
     index_with_documents().update_filterable_attributes(["genre"])
     response = index_with_documents().search("with", {"distinct": "genre"})