Read the source.
Every key, every flag, every default in these docs comes out of the Rust crates under engine/crates/. If the docs and the code disagree, the code is right. File a bug; we'll reconcile the docs.
Playbooks
The top Elasticsearch use cases, written as complete recipes: a schema, an ingest command, a query, and the dashboard to visualize it.
Detect auth spikes, top attacker IPs, and anomalies at millions of events per second.
02 Log AnalyticsNginx, JSON, syslog, OTLP — ingest at line rate, query hot logs, drop cold to cheap storage.
03 Vector · RAGEmbed, index with HNSW, retrieve with hybrid BM25 + kNN — all on one box.
04 Full-Text SearchClassic inverted-index search with BM25, analyzers, highlighters, and query-time boosting.
05 ObservabilityMetrics + traces + logs as one queryable store. Prometheus scrape endpoint built in.
AI & search recipes
Task-oriented guides for building real things — every one verified end-to-end against a live XERJ, stdlib-only, reproducible. Browse all recipes →
Retrieval by meaning with semantic_text — auto-embed on ingest, no separate vector DB.
Long-term memory for agents via the /_memory API — store, recall, forget, per-agent isolation.
Auto-chunk long docs; a doc competes on its best passage via max-sim scoring.
04 Vector search · kNNNearest-neighbor similarity over dense_vector (HNSW), with filters.
Opt a dense_vector into int8_hnsw — smaller vectors, recall measured in the recipe.
Keyword + vector in one query — results neither BM25 nor kNN ranks first alone.
07 Log analyticsFrom raw logs to dashboards — error rates, p95 latency, top services via aggregations.
08 Anomaly detectionStatistical _ml detectors that flag spikes in metrics and logs.
A live _ml datafeed re-scores an index on a timer and stores anomaly records you poll.
Point your existing ES client at XERJ — same wire, change the URL.
Start here
New to XERJ? Pick a path below. The quickstart is the fastest way to see something work; the install guide is for a real deployment.
Source · engine/README.md · engine/xerj.default.toml · engine/crates/*