# xerj-org/xerj

XERJ is the new way for AI to search data. Its autoindex capability activates agents to know your data without the token waste of grep and sed. One command indexes code, docs, logs and PDFs for search, RAG, security audits and agent memory, using 40x fewer tokens than grep. Elasticsearch compatible, so existing clients just work.

Repository: https://github.com/xerj-org/xerj
Canonical: https://ross.abutalabs.com/products/xerj
Homepage: https://xerj.org
Language: Rust
License: Apache-2.0
License Family: permissive
Topics: ai-search, ai-search-algorithms, ai-search-engine, ai-search-free, ai-search-module, ai-search-optimization, ai-searchengine, bm25-search, elastic-search, elasticsearch, elasticstack, graph-search, graph-semantic-search, hybrid-search, hybrid-semantic-search, search-api, search-engine, semantic-search, vector-database, vector-search
Last push: 2026-08-26T19:34:50+00:00

## Health v2 (maintenance only)
Score: 76/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 87, longevity 4
- inputs: {"age_days": 64, "days_push": 7, "days_rel": 7, "gap_med": 0, "n_releases_24m": 70}
- flags: young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1670, forks 249 (observed 2026-08-28T04:05:20.044940+00:00)

## What it is
XERJ is a Rust-based, single-binary search engine built for AI agents, offering BM25, kNN vector, and hybrid search with Elasticsearch-compatible APIs. It indexes code, docs, logs, and PDFs with one zero-config command, enabling token-efficient retrieval, RAG, agent memory, and security analytics without a JVM or separate vector database.

## Use cases
- reduce coding agent token usage by retrieving exact code instead of grep
- index a mixed-format folder of logs, PDFs, and CSVs with one command
- give AI agents long-term memory with per-agent isolation
- build semantic search and RAG without a separate vector database
- run SIEM and log analytics on a single node
- drop in an Elasticsearch replacement for existing clients

## When to choose
- you want an Elasticsearch-compatible search engine that runs as a single static binary without a JVM
- your AI coding agent wastes tokens reading files via grep and sed
- you need combined BM25, kNN, and hybrid search plus agent memory in one datastore
- you want zero-config indexing of heterogeneous local files

## When to avoid
- you rely on whole-index scroll reads or parent/child joins, which are unsupported or capped
- you need a fully managed multi-region cluster today (HA and multi-region tiers are commercial or upcoming)
- you require 100% Elasticsearch API coverage rather than the documented subset

## Facets
- artifact type: service
- maturity: active
- function: search-engine, vector-database, rag, agent-framework, mcp, logging, analytics
- domain: databases, artificial-intelligence, developer-tools, self-hosted, analytics
- platform: windows, rust, cli, self-hosted
- tags: elasticsearch-compatible, bm25, hybrid-search, semantic-search, knn, agent-memory, autoindex, token-efficiency, single-binary, siem, log-analytics, search, ai-agents, retrieval-augmented-generation, linux, macos, docker

## Member repositories
- xerj-org/xerj (main) score 76

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:20.044940+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:42:45.502374+00:00, confidence not recorded.
  - readme: https://github.com/xerj-org/xerj (fetched 2026-08-28T04:05:20.044940+00:00, sha 808ae079e78b)
  - homepage: https://xerj.org (fetched 2026-08-29T11:16:03.222939+00:00, sha eea2cc69a475)
  - site_page: https://xerj.org/docs (fetched 2026-08-29T11:16:03.226052+00:00, sha 9c86035caffa)
  - site_page: https://xerj.org/docs/recipes (fetched 2026-08-29T11:16:03.228223+00:00, sha 30b83f018334)
  - site_page: https://xerj.org/docs/recipes/zero-config-autoindex (fetched 2026-08-29T11:16:03.230065+00:00, sha 8beaee837c61)
  - site_page: https://xerj.org/docs/recipes/agentic-memory (fetched 2026-08-29T11:16:03.232405+00:00, sha e4286298b8ca)
  - site_page: https://xerj.org/docs/quickstart (fetched 2026-08-29T11:16:03.236120+00:00, sha b799e5a56677)
  - site_page: https://xerj.org/docs/install (fetched 2026-08-29T11:16:03.237762+00:00, sha 682910f8f385)
  - site_page: https://xerj.org/docs/migration-from-es (fetched 2026-08-29T11:16:03.242867+00:00, sha e60fc8ab829e)
  - site_page: https://xerj.org/pricing (fetched 2026-08-29T11:16:03.234343+00:00, sha 1fbc3ba5018d)
- Data as of 2026-08-30T08:39:29.467469+00:00.