docs.rs failed to build rullama-rag-0.12.0
Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.

rullama-rag

Codebase indexing and hybrid retrieval (vector + BM25) for rullama agents. Includes AST-aware chunking via tree-sitter (12 languages), Git history search, and reranking via spectral diversity / cross-encoder.

What lives here

rag::client::RagClient — hybrid retrieval over a LanceDB-backed index.
rag::indexer — file walking, AST-based chunking (Rust, Python, JavaScript, TypeScript, Go, Java, Swift, C, C++, C#, Ruby, PHP).
rag::embedding::FastEmbedManager — local FastEmbed embeddings (all-MiniLM-L6-v2 by default).
rag::git — Git-aware indexing + commit history search.
rag::documents — PDF / DOCX / Markdown / plaintext ingestion (PDF behind the pdf-extract-feature feature).

Two RAG-internal subdomains travel inside this crate (no public API extracted because nothing outside the RAG client uses them):

spectral — log-determinant diversity reranking + cross-encoder reranker.
code_analysis — AST symbol / definition / reference graphs.

Features

Feature	Notes
(default)	RagClient + indexer + embeddings + git + spectral + code_analysis. Tree-sitter language parsers always-on.
`documents`	DOCX / Markdown ingestion (zip-based)
`pdf-extract-feature`	PDF text extraction via `pdf-extract`
`qdrant-backend`	Forward `qdrant-backend` to `rullama-storage`

Heavy deps

This crate pulls lancedb, tantivy, git2, tree-sitter + 12 grammar crates, rmcp, rayon, and friends. Consumers that only want rullama-knowledge (BKS / PKS / brain client) or rullama-prompting should depend on those crates directly to avoid the RAG dep weight.

Usage

[dependencies]
rullama-rag = "0.12"

use rullama_rag::{RagClient, IndexRequest, QueryRequest};

let client = RagClient::new(/* config */).await?;
client.index(IndexRequest { /* ... */ }).await?;
let results = client.query(QueryRequest { /* ... */ }).await?;

License

MIT OR Apache-2.0