haiku.rag 0.3.3__tar.gz → 0.4.0__tar.gz

{haiku_rag-0.3.3 → haiku_rag-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: haiku.rag
-Version: 0.3.3
+Version: 0.4.0
 Summary: Retrieval Augmented Generation (RAG) with SQLite
 Author-email: Yiorgis Gozadinos <ggozadinos@gmail.com>
 License: MIT
@@ -21,6 +21,7 @@ Requires-Python: >=3.10
 Requires-Dist: fastmcp>=2.8.1
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: markitdown[audio-transcription,docx,pdf,pptx,xlsx]>=0.1.2
+Requires-Dist: mxbai-rerank>=0.1.6
 Requires-Dist: ollama>=0.5.1
 Requires-Dist: pydantic>=2.11.7
 Requires-Dist: python-dotenv>=1.1.0
@@ -31,6 +32,8 @@ Requires-Dist: typer>=0.16.0
 Requires-Dist: watchfiles>=1.1.0
 Provides-Extra: anthropic
 Requires-Dist: anthropic>=0.56.0; extra == 'anthropic'
+Provides-Extra: cohere
+Requires-Dist: cohere>=5.16.1; extra == 'cohere'
 Provides-Extra: openai
 Requires-Dist: openai>=1.0.0; extra == 'openai'
 Provides-Extra: voyageai
@@ -49,6 +52,7 @@ Retrieval-Augmented Generation (RAG) library on SQLite.
 - **Multiple embedding providers**: Ollama, VoyageAI, OpenAI
 - **Multiple QA providers**: Ollama, OpenAI, Anthropic
 - **Hybrid search**: Vector + full-text search with Reciprocal Rank Fusion
+- **Reranking**: Default search result reranking with MixedBread AI or Cohere
 - **Question answering**: Built-in QA agents on your documents
 - **File monitoring**: Auto-index files when run as server
 - **40+ file formats**: PDF, DOCX, HTML, Markdown, audio, URLs
@@ -88,7 +92,7 @@ async with HaikuRAG("database.db") as client:
     # Add document
     doc = await client.create_document("Your content")
 
-    # Search
+    # Search (reranking enabled by default)
     results = await client.search("query")
     for chunk, score in results:
         print(f"{score:.3f}: {chunk.content}")

{haiku_rag-0.3.3 → haiku_rag-0.4.0}/README.md

@@ -10,6 +10,7 @@ Retrieval-Augmented Generation (RAG) library on SQLite.
 - **Multiple embedding providers**: Ollama, VoyageAI, OpenAI
 - **Multiple QA providers**: Ollama, OpenAI, Anthropic
 - **Hybrid search**: Vector + full-text search with Reciprocal Rank Fusion
+- **Reranking**: Default search result reranking with MixedBread AI or Cohere
 - **Question answering**: Built-in QA agents on your documents
 - **File monitoring**: Auto-index files when run as server
 - **40+ file formats**: PDF, DOCX, HTML, Markdown, audio, URLs
@@ -49,7 +50,7 @@ async with HaikuRAG("database.db") as client:
     # Add document
     doc = await client.create_document("Your content")
 
-    # Search
+    # Search (reranking enabled by default)
     results = await client.search("query")
     for chunk, score in results:
         print(f"{score:.3f}: {chunk.content}")

{haiku_rag-0.3.3 → haiku_rag-0.4.0}/docs/benchmarks.md

@@ -12,16 +12,19 @@ In order to calculate recall, we load the `News Stories` from `repliqa_3` which
 
 The recall obtained is ~0.73 for matching in the top result, raising to ~0.75 for the top 3 results.
 
-| Model                                 | Document in top 1 | Document in top 3 |
-|---------------------------------------|-------------------|-------------------|
-| Ollama / `mxbai-embed-large`          | 0.73              | 0.75              |
-| OpenAI / `text-embeddings-3-small`    | 0.75              | 0.88              |
+| Model                                 | Document in top 1 | Document in top 3 | Reranker             |
+|---------------------------------------|-------------------|-------------------|----------------------|
+| Ollama / `mxbai-embed-large`          | 0.77              | 0.89              | None                 |
+| Ollama / `mxbai-embed-large`          | 0.81              | 0.91              | mxbai-rerank-base-v2 |
+| Ollama / `nomic-embed-text`           | 0.74              | 0.88              | None                 |
+| OpenAI / `text-embeddings-3-small`    | 0.75              | 0.88              | None                 |
 
 ## Question/Answer evaluation
 
 Again using the same dataset, we use a QA agent to answer the question. In addition we use an LLM judge (using the Ollama `qwen3`) to evaluate whether the answer is correct or not. The obtained accuracy is as follows:
 
-| Embedding Model              | QA Model                          | Accuracy  |
-|------------------------------|-----------------------------------|-----------|
-| Ollama / `mxbai-embed-large` | Ollama / `qwen3`                  | 0.64      |
-| Ollama / `mxbai-embed-large` | Anthropic / `Claude Sonnet 3.7`   | 0.79      |
+| Embedding Model              | QA Model                          | Accuracy  | Reranker             |
+|------------------------------|-----------------------------------|-----------|----------------------|
+| Ollama / `mxbai-embed-large` | Ollama / `qwen3`                  | 0.64      | None                 |
+| Ollama / `mxbai-embed-large` | Ollama / `qwen3`                  | 0.72      | mxbai-rerank-base-v2 |
+| Ollama / `mxbai-embed-large` | Anthropic / `Claude Sonnet 3.7`   | 0.79      | None                 |

{haiku_rag-0.3.3 → haiku_rag-0.4.0}/docs/configuration.md

@@ -2,6 +2,9 @@
 
 Configuration is done through the use of environment variables.
 
+!!! note
+    If you create a db with certain settings and later change them, `haiku.rag` will detect incompatibilities (for example, if you change embedding provider) and will exit. You can **rebuild** the database to apply the new settings, see [Rebuild Database](./cli.md#rebuild-database).
+
 ## File Monitoring
 
 Set directories to monitor for automatic indexing:
@@ -100,6 +103,39 @@ QA_MODEL="claude-3-5-haiku-20241022"  # or claude-3-5-sonnet-20241022, etc.
 ANTHROPIC_API_KEY="your-api-key"
 ```
 
+## Reranking
+
+Reranking is **enabled by default** and improves search quality by re-ordering the initial search results using specialized models. When enabled, the system retrieves more candidates (3x the requested limit) and then reranks them to return the most relevant results.
+
+If you use the default reranked (running locally), it can slow down searching significantly. To disable reranking for faster searches:
+
+```bash
+RERANK=false
+```
+
+### MixedBread AI (Default)
+
+```bash
+RERANK_PROVIDER="mxbai"
+RERANK_MODEL="mixedbread-ai/mxbai-rerank-base-v2"
+```
+
+### Cohere
+
+For Cohere reranking, install with Cohere extras:
+
+```bash
+uv pip install haiku.rag --extra cohere
+```
+
+Then configure:
+
+```bash
+RERANK_PROVIDER="cohere"
+RERANK_MODEL="rerank-v3.5"
+COHERE_API_KEY="your-api-key"
+```
+
 ## Other Settings
 
 ### Database and Storage

{haiku_rag-0.3.3 → haiku_rag-0.4.0}/docs/index.md

@@ -1,13 +1,13 @@
 # haiku.rag
 
-`haiku.rag` is a Retrieval-Augmented Generation (RAG) library built to work on SQLite alone without the need for external vector databases. It uses [sqlite-vec](https://github.com/asg017/sqlite-vec) for storing the embeddings and performs semantic (vector) search as well as full-text search combined through Reciprocal Rank Fusion. Both open-source (Ollama) as well as commercial (OpenAI, VoyageAI) embedding providers are supported.
-
+`haiku.rag` is a Retrieval-Augmented Generation (RAG) library built to work on SQLite alone without the need for external vector databases. It uses [sqlite-vec](https://github.com/asg017/sqlite-vec) for storing the embeddings and performs semantic (vector) search as well as full-text search combined through Reciprocal Rank Fusion. Both open-source (Ollama, MixedBread AI) as well as commercial (OpenAI, VoyageAI) embedding providers are supported.
 
 ## Features
 
 - **Local SQLite**: No need to run additional servers
 - **Support for various embedding providers**: Ollama, VoyageAI, OpenAI or add your own
 - **Hybrid Search**: Vector search using `sqlite-vec` combined with full-text search `FTS5`, using Reciprocal Rank Fusion
+- **Reranking**: Optional result reranking with MixedBread AI or Cohere
 - **Question Answering**: Built-in QA agents using Ollama, OpenAI, or Anthropic.
 - **File monitoring**: Automatically index files when run as a server
 - **Extended file format support**: Parse 40+ file formats including PDF, DOCX, HTML, Markdown, audio and more. Or add a URL!
@@ -34,7 +34,7 @@ async with HaikuRAG("database.db") as client:
     results = await client.search("query")
 
     # Ask questions
-    answer = await client.ask("Who is the author of haiku.rag?")
+    answer = await client.ask("Who is the author of haiku.rag?", rerank=False)
 ```
 
 Or use the CLI:

{haiku_rag-0.3.3 → haiku_rag-0.4.0}/docs/python.md

@@ -76,7 +76,9 @@ async for doc_id in client.rebuild_database():
 
 ## Searching Documents
 
-Basic search:
+The search method performs hybrid search (vector + full-text) with **reranking enabled by default** for improved relevance:
+
+Basic search (with reranking):
 ```python
 results = await client.search("machine learning algorithms", limit=5)
 for chunk, score in results:
@@ -90,7 +92,8 @@ With options:
 results = await client.search(
     query="machine learning",
     limit=5,  # Maximum results to return
-    k=60      # RRF parameter for reciprocal rank fusion
+    k=60,     # RRF parameter for reciprocal rank fusion
+    rerank=False  # Disable reranking for faster search
 )
 
 # Process results

{haiku_rag-0.3.3 → haiku_rag-0.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "haiku.rag"
-version = "0.3.3"
+version = "0.4.0"
 description = "Retrieval Augmented Generation (RAG) with SQLite"
 authors = [{ name = "Yiorgis Gozadinos", email = "ggozadinos@gmail.com" }]
 license = { text = "MIT" }
@@ -25,6 +25,7 @@ dependencies = [
     "fastmcp>=2.8.1",
     "httpx>=0.28.1",
     "markitdown[audio-transcription,docx,pdf,pptx,xlsx]>=0.1.2",
+    "mxbai-rerank>=0.1.6",
     "ollama>=0.5.1",
     "pydantic>=2.11.7",
     "python-dotenv>=1.1.0",
@@ -39,6 +40,7 @@ dependencies = [
 voyageai = ["voyageai>=0.3.2"]
 openai = ["openai>=1.0.0"]
 anthropic = ["anthropic>=0.56.0"]
+cohere = ["cohere>=5.16.1"]
 
 [project.scripts]
 haiku-rag = "haiku.rag.cli:cli"
@@ -56,7 +58,7 @@ dev = [
     "mkdocs>=1.6.1",
     "mkdocs-material>=9.6.14",
     "pre-commit>=4.2.0",
-    "pyright>=1.1.402",
+    "pyright>=1.1.403",
     "pytest>=8.4.0",
     "pytest-asyncio>=1.0.0",
     "pytest-cov>=6.2.1",

{haiku_rag-0.3.3 → haiku_rag-0.4.0}/src/haiku/rag/app.py

@@ -74,7 +74,7 @@ class HaikuRAGApp:
                 self.console.print(f"[red]Error: {e}[/red]")
 
     async def rebuild(self):
-        async with HaikuRAG(db_path=self.db_path) as client:
+        async with HaikuRAG(db_path=self.db_path, skip_validation=True) as client:
             try:
                 documents = await client.list_documents()
                 total_docs = len(documents)

{haiku_rag-0.3.3 → haiku_rag-0.4.0}/src/haiku/rag/chunker.py

@@ -6,15 +6,11 @@ from haiku.rag.config import Config
 
 
 class Chunker:
-    """
-    A class that chunks text into smaller pieces for embedding and retrieval.
-
-    Parameters
-    ----------
-    chunk_size : int
-        The maximum size of a chunk in characters.
-    chunk_overlap : int
-        The number of characters of overlap between chunks.
+    """A class that chunks text into smaller pieces for embedding and retrieval.
+
+    Args:
+        chunk_size: The maximum size of a chunk in tokens.
+        chunk_overlap: The number of tokens of overlap between chunks.
     """
 
     encoder: ClassVar[tiktoken.Encoding] = tiktoken.encoding_for_model("gpt-4o")
@@ -28,18 +24,13 @@ class Chunker:
         self.chunk_overlap = chunk_overlap
 
     async def chunk(self, text: str) -> list[str]:
-        """
-        Split the text into chunks.
+        """Split the text into chunks based on token boundaries.
 
-        Parameters
-        ----------
-        text : str
-            The text to be split into chunks.
+        Args:
+            text: The text to be split into chunks.
 
-        Returns
-        -------
-        list
-            A list of text chunks.
+        Returns:
+            A list of text chunks with token-based boundaries and overlap.
         """
         if not text:
             return []

{haiku_rag-0.3.3 → haiku_rag-0.4.0}/src/haiku/rag/cli.py

@@ -5,7 +5,7 @@ import typer
 from rich.console import Console
 
 from haiku.rag.app import HaikuRAGApp
-from haiku.rag.utils import get_default_data_dir
+from haiku.rag.utils import get_default_data_dir, is_up_to_date
 
 cli = typer.Typer(
     context_settings={"help_option_names": ["-h", "--help"]}, no_args_is_help=True
@@ -15,6 +15,23 @@ console = Console()
 event_loop = asyncio.get_event_loop()
 
 
+async def check_version():
+    """Check if haiku.rag is up to date and show warning if not."""
+    up_to_date, current_version, latest_version = await is_up_to_date()
+    if not up_to_date:
+        console.print(
+            f"[yellow]Warning: haiku.rag is outdated. Current: {current_version}, Latest: {latest_version}[/yellow]"
+        )
+        console.print("[yellow]Please update.[/yellow]")
+
+
+@cli.callback()
+def main():
+    """haiku.rag CLI - SQLite-based RAG system"""
+    # Run version check before any command
+    event_loop.run_until_complete(check_version())
+
+
 @cli.command("list", help="List all stored documents")
 def list_documents(
     db: Path = typer.Option(

{haiku_rag-0.3.3 → haiku_rag-0.4.0}/src/haiku/rag/client.py

@@ -10,6 +10,7 @@ import httpx
 
 from haiku.rag.config import Config
 from haiku.rag.reader import FileReader
+from haiku.rag.reranking import get_reranker
 from haiku.rag.store.engine import Store
 from haiku.rag.store.models.chunk import Chunk
 from haiku.rag.store.models.document import Document
@@ -24,12 +25,18 @@ class HaikuRAG:
         self,
         db_path: Path | Literal[":memory:"] = Config.DEFAULT_DATA_DIR
         / "haiku.rag.sqlite",
+        skip_validation: bool = False,
     ):
-        """Initialize the RAG client with a database path."""
+        """Initialize the RAG client with a database path.
+
+        Args:
+            db_path: Path to the SQLite database file or ":memory:" for in-memory database.
+            skip_validation: Whether to skip configuration validation on database load.
+        """
         if isinstance(db_path, Path):
             if not db_path.parent.exists():
                 Path.mkdir(db_path.parent, parents=True)
-        self.store = Store(db_path)
+        self.store = Store(db_path, skip_validation=skip_validation)
         self.document_repository = DocumentRepository(self.store)
         self.chunk_repository = ChunkRepository(self.store)
 
@@ -45,7 +52,16 @@ class HaikuRAG:
     async def create_document(
         self, content: str, uri: str | None = None, metadata: dict | None = None
     ) -> Document:
-        """Create a new document with optional URI and metadata."""
+        """Create a new document with optional URI and metadata.
+
+        Args:
+            content: The text content of the document.
+            uri: Optional URI identifier for the document.
+            metadata: Optional metadata dictionary.
+
+        Returns:
+            The created Document instance.
+        """
         document = Document(
             content=content,
             uri=uri,
@@ -165,29 +181,26 @@ class HaikuRAG:
 
             # Create a temporary file with the appropriate extension
             with tempfile.NamedTemporaryFile(
-                mode="wb", suffix=file_extension, delete=False
+                mode="wb", suffix=file_extension
             ) as temp_file:
                 temp_file.write(response.content)
+                temp_file.flush()  # Ensure content is written to disk
                 temp_path = Path(temp_file.name)
 
-            try:
                 # Parse the content using FileReader
                 content = FileReader.parse_file(temp_path)
 
-                # Merge metadata with contentType and md5
-                metadata.update({"contentType": content_type, "md5": md5_hash})
-
-                if existing_doc:
-                    existing_doc.content = content
-                    existing_doc.metadata = metadata
-                    return await self.update_document(existing_doc)
-                else:
-                    return await self.create_document(
-                        content=content, uri=url, metadata=metadata
-                    )
-            finally:
-                # Clean up temporary file
-                temp_path.unlink(missing_ok=True)
+            # Merge metadata with contentType and md5
+            metadata.update({"contentType": content_type, "md5": md5_hash})
+
+            if existing_doc:
+                existing_doc.content = content
+                existing_doc.metadata = metadata
+                return await self.update_document(existing_doc)
+            else:
+                return await self.create_document(
+                    content=content, uri=url, metadata=metadata
+                )
 
     def _get_extension_from_content_type_or_url(
         self, url: str, content_type: str
@@ -221,11 +234,25 @@ class HaikuRAG:
         return ".html"
 
     async def get_document_by_id(self, document_id: int) -> Document | None:
-        """Get a document by its ID."""
+        """Get a document by its ID.
+
+        Args:
+            document_id: The unique identifier of the document.
+
+        Returns:
+            The Document instance if found, None otherwise.
+        """
         return await self.document_repository.get_by_id(document_id)
 
     async def get_document_by_uri(self, uri: str) -> Document | None:
-        """Get a document by its URI."""
+        """Get a document by its URI.
+
+        Args:
+            uri: The URI identifier of the document.
+
+        Returns:
+            The Document instance if found, None otherwise.
+        """
         return await self.document_repository.get_by_uri(uri)
 
     async def update_document(self, document: Document) -> Document:
@@ -239,32 +266,55 @@ class HaikuRAG:
     async def list_documents(
         self, limit: int | None = None, offset: int | None = None
     ) -> list[Document]:
-        """List all documents with optional pagination."""
+        """List all documents with optional pagination.
+
+        Args:
+            limit: Maximum number of documents to return.
+            offset: Number of documents to skip.
+
+        Returns:
+            List of Document instances.
+        """
         return await self.document_repository.list_all(limit=limit, offset=offset)
 
     async def search(
-        self, query: str, limit: int = 5, k: int = 60
+        self, query: str, limit: int = 3, k: int = 60, rerank=Config.RERANK
     ) -> list[tuple[Chunk, float]]:
-        """Search for relevant chunks using hybrid search (vector similarity + full-text search).
+        """Search for relevant chunks using hybrid search (vector similarity + full-text search) with reranking.
 
         Args:
-            query: The search query string
-            limit: Maximum number of results to return
-            k: Parameter for Reciprocal Rank Fusion (default: 60)
+            query: The search query string.
+            limit: Maximum number of results to return.
+            k: Parameter for Reciprocal Rank Fusion (default: 60).
 
         Returns:
-            List of (chunk, score) tuples ordered by relevance
+            List of (chunk, score) tuples ordered by relevance.
         """
-        return await self.chunk_repository.search_chunks_hybrid(query, limit, k)
+
+        if not rerank:
+            return await self.chunk_repository.search_chunks_hybrid(query, limit, k)
+
+        # Get more initial results (3X) for reranking
+        search_results = await self.chunk_repository.search_chunks_hybrid(
+            query, limit * 3, k
+        )
+
+        # Apply reranking
+        reranker = get_reranker()
+        chunks = [chunk for chunk, _ in search_results]
+        reranked_results = await reranker.rerank(query, chunks, top_n=limit)
+
+        # Return reranked results with scores from reranker
+        return reranked_results
 
     async def ask(self, question: str) -> str:
         """Ask a question using the configured QA agent.
 
         Args:
-            question: The question to ask
+            question: The question to ask.
 
         Returns:
-            The generated answer as a string
+            The generated answer as a string.
         """
         from haiku.rag.qa import get_qa_agent
 
@@ -277,12 +327,16 @@ class HaikuRAG:
         Yields:
             int: The ID of the document currently being processed
         """
-        documents = await self.list_documents()
+        await self.chunk_repository.delete_all()
+        self.store.recreate_embeddings_table()
 
-        if not documents:
-            return
+        # Update settings to current config
+        from haiku.rag.store.repositories.settings import SettingsRepository
 
-        await self.chunk_repository.delete_all()
+        settings_repo = SettingsRepository(self.store)
+        settings_repo.save()
+
+        documents = await self.list_documents()
 
         for doc in documents:
             if doc.id is not None:

{haiku_rag-0.3.3 → haiku_rag-0.4.0}/src/haiku/rag/config.py

@@ -19,6 +19,10 @@ class AppConfig(BaseModel):
     EMBEDDINGS_MODEL: str = "mxbai-embed-large"
     EMBEDDINGS_VECTOR_DIM: int = 1024
 
+    RERANK: bool = True
+    RERANK_PROVIDER: str = "mxbai"
+    RERANK_MODEL: str = "mixedbread-ai/mxbai-rerank-base-v2"
+
     QA_PROVIDER: str = "ollama"
     QA_MODEL: str = "qwen3"
 
@@ -31,6 +35,7 @@ class AppConfig(BaseModel):
     VOYAGE_API_KEY: str = ""
     OPENAI_API_KEY: str = ""
     ANTHROPIC_API_KEY: str = ""
+    COHERE_API_KEY: str = ""
 
     @field_validator("MONITOR_DIRECTORIES", mode="before")
     @classmethod
@@ -52,3 +57,5 @@ if Config.VOYAGE_API_KEY:
     os.environ["VOYAGE_API_KEY"] = Config.VOYAGE_API_KEY
 if Config.ANTHROPIC_API_KEY:
     os.environ["ANTHROPIC_API_KEY"] = Config.ANTHROPIC_API_KEY
+if Config.COHERE_API_KEY:
+    os.environ["CO_API_KEY"] = Config.COHERE_API_KEY

{haiku_rag-0.3.3 → haiku_rag-0.4.0}/src/haiku/rag/embeddings/base.py

@@ -1,6 +1,9 @@
+from haiku.rag.config import Config
+
+
 class EmbedderBase:
-    _model: str = ""
-    _vector_dim: int = 0
+    _model: str = Config.EMBEDDINGS_MODEL
+    _vector_dim: int = Config.EMBEDDINGS_VECTOR_DIM
 
     def __init__(self, model: str, vector_dim: int):
         self._model = model

{haiku_rag-0.3.3 → haiku_rag-0.4.0}/src/haiku/rag/embeddings/ollama.py

@@ -5,9 +5,6 @@ from haiku.rag.embeddings.base import EmbedderBase
 
 
 class Embedder(EmbedderBase):
-    _model: str = Config.EMBEDDINGS_MODEL
-    _vector_dim: int = 1024
-
     async def embed(self, text: str) -> list[float]:
         client = AsyncClient(host=Config.OLLAMA_BASE_URL)
         res = await client.embeddings(model=self._model, prompt=text)

{haiku_rag-0.3.3 → haiku_rag-0.4.0}/src/haiku/rag/embeddings/openai.py

@@ -1,13 +1,9 @@
 try:
     from openai import AsyncOpenAI
 
-    from haiku.rag.config import Config
     from haiku.rag.embeddings.base import EmbedderBase
 
     class Embedder(EmbedderBase):
-        _model: str = Config.EMBEDDINGS_MODEL
-        _vector_dim: int = 1536
-
         async def embed(self, text: str) -> list[float]:
             client = AsyncOpenAI()
             response = await client.embeddings.create(

{haiku_rag-0.3.3 → haiku_rag-0.4.0}/src/haiku/rag/embeddings/voyageai.py

@@ -1,13 +1,9 @@
 try:
     from voyageai.client import Client  # type: ignore
 
-    from haiku.rag.config import Config
     from haiku.rag.embeddings.base import EmbedderBase
 
     class Embedder(EmbedderBase):
-        _model: str = Config.EMBEDDINGS_MODEL
-        _vector_dim: int = 1024
-
         async def embed(self, text: str) -> list[float]:
             client = Client()
             res = client.embed([text], model=self._model, output_dtype="float")

{haiku_rag-0.3.3 → haiku_rag-0.4.0}/src/haiku/rag/qa/prompts.py

@@ -6,7 +6,7 @@ Your process:
 2. Search with specific keywords and phrases from the user's question
 3. Review the search results and their relevance scores
 4. If you need additional context, perform follow-up searches with different keywords
-5. Provide a comprehensive answer based only on the retrieved documents
+5. Provide a short and to the point comprehensive answer based only on the retrieved documents
 
 Guidelines:
 - Base your answers strictly on the provided document content
@@ -15,6 +15,7 @@ Guidelines:
 - Indicate when information is incomplete or when you need to search for additional context
 - If the retrieved documents don't contain sufficient information, clearly state: "I cannot find enough information in the knowledge base to answer this question."
 - For complex questions, consider breaking them down and performing multiple searches
+- Stick to the answer, do not ellaborate or provde context unless asked for it.
 
 Be concise, and always maintain accuracy over completeness. Prefer short, direct answers that are well-supported by the documents.
 """

haiku_rag-0.4.0/src/haiku/rag/reranking/__init__.py

@@ -0,0 +1,37 @@
+from haiku.rag.config import Config
+from haiku.rag.reranking.base import RerankerBase
+
+try:
+    from haiku.rag.reranking.cohere import CohereReranker
+except ImportError:
+    pass
+
+_reranker: RerankerBase | None = None
+
+
+def get_reranker() -> RerankerBase:
+    """
+    Factory function to get the appropriate reranker based on the configuration.
+    """
+    global _reranker
+    if _reranker is not None:
+        return _reranker
+    if Config.RERANK_PROVIDER == "mxbai":
+        from haiku.rag.reranking.mxbai import MxBAIReranker
+
+        _reranker = MxBAIReranker()
+        return _reranker
+
+    if Config.RERANK_PROVIDER == "cohere":
+        try:
+            from haiku.rag.reranking.cohere import CohereReranker
+        except ImportError:
+            raise ImportError(
+                "Cohere reranker requires the 'cohere' package. "
+                "Please install haiku.rag with the 'cohere' extra:"
+                "uv pip install haiku.rag --extra cohere"
+            )
+        _reranker = CohereReranker()
+        return _reranker
+
+    raise ValueError(f"Unsupported reranker provider: {Config.RERANK_PROVIDER}")

haiku_rag-0.4.0/src/haiku/rag/reranking/base.py

@@ -0,0 +1,13 @@
+from haiku.rag.config import Config
+from haiku.rag.store.models.chunk import Chunk
+
+
+class RerankerBase:
+    _model: str = Config.RERANK_MODEL
+
+    async def rerank(
+        self, query: str, chunks: list[Chunk], top_n: int = 10
+    ) -> list[tuple[Chunk, float]]:
+        raise NotImplementedError(
+            "Reranker is an abstract class. Please implement the rerank method in a subclass."
+        )