summa

Documentation and blog · Summa 2 migration

Embeddable Rust search engine: BM25 and phrase search, sparse vectors (BMP, MaxScore, Seismic), dense search (flat, TQ, IVF-TQ, binary IVF, ScaNN), and hybrid ranking. Run locally, behind gRPC, or in a browser over HTTP/IPFS with WASM.

• Chunked and multi-value fields, filters, fusion, formula ranking, and reranking.
• Primary-key deletion, full-document upserts, content-hash deduplication, and compaction.
• Sharded search through a broker with shared BM25 statistics.
• A separate MAL-defined Transformer/Mamba stack for training, inference, and inspection.

Documentation · Schema · Query syntax · Contributing

Quick start

Run in a new working directory:

cargo install summa-tool
summa-tool init -i ./articles --sdl 'index articles {
    field id: text<raw> [primary, stored]
    field title: text<en_stem> [indexed, stored]
}'
printf '%s\n' '{"id":"1","title":"Hybrid search with Summa"}' |
  summa-tool index -i ./articles --stdin
summa-tool search -i ./articles --query 'title:hybrid' --limit 10

index commits before returning. For remote access:

cargo install summa-server
summa-server --data-dir . --addr 127.0.0.1:50051