danvics/haiku.rag
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
haiku.rag/haiku_rag_slim
History
Yiorgis Gozadinos 5de04b0108
ARM ONLY, NEVER MERGE: retrieval score first, RRF rank second 
Merge-and-sort discards rank, so where raw scores tie exactly it falls back
to lancedb.databases declaration order. Rank and score are independent
discriminators, not the same information at different resolution: a
single-branch rank-0 candidate and a rank-2 candidate with two both-branch
candidates above it can carry the same score.

So keep score primary, which is what buys merge-and-sort its recall, and
resolve score ties by within-database position instead of by YAML order.
That prefers the candidate nothing in its own collection beat, which is
signal.

Measures whether merge-and-sort's order sensitivity at n=4 (1.49pp against
the tie-break's 0.56pp) is reducible without moving to continuous scores.

Claude-Session: https://claude.ai/code/session_01WhudUtZm6qqiuv8Y1sbwSc
2026-08-31 19:10:19 +03:00
..
haiku/rag ARM ONLY, NEVER MERGE: retrieval score first, RRF rank second 2026-08-31 19:10:19 +03:00
LICENSE Restructure into uv workspace to support minimal and full installations 2025-11-04 17:59:12 +02:00
pyproject.toml Update lancedb to 0.37.1 2026-08-31 18:54:48 +03:00
README.md Give the docs an architecture page and one extras list 2026-08-20 15:07:06 +03:00

README.md

haiku.rag-slim

Opinionated agentic RAG powered by LanceDB, Pydantic AI, and Docling - Core package with minimal dependencies.

haiku.rag-slim is the core package for users who want to install only the dependencies they need. Document processing (docling), and reranker support are all optional extras.

For most users, we recommend installing haiku.rag instead, which includes all features out of the box.

Installation

Python 3.12 or newer required

Minimal Installation

uv pip install haiku.rag-slim

Core functionality with OpenAI/Ollama support, MCP server, and Logfire observability. Document processing (docling) is optional.

With Document Processing

uv pip install haiku.rag-slim[docling]

Adds support for 40+ file formats including PDF, DOCX, HTML, and more.

Available Extras

docling, tui, voyageai, cohere, zeroentropy, cross-encoder, jina, s3, ingester, and one per model provider: anthropic, google, groq, mistral, bedrock, vertexai. Ollama and any OpenAI-compatible endpoint need no extra.

What each provides, and which ones the full haiku.rag package already includes: Installation.

# Common combinations
uv pip install 'haiku.rag-slim[docling,anthropic,cross-encoder]'
uv pip install 'haiku.rag-slim[docling,groq]'

Usage

See the main haiku.rag repository for:

  • Quick start guide
  • CLI examples
  • Python API usage
  • MCP server setup

Documentation

Full documentation: https://ggozad.github.io/haiku.rag/