edgequake

Pin a version: EDGEQUAKE_VERSION=0.40.7 sh quickstart.sh. More options: Docker deployment options · Enable login.

Pick your LLM

EdgeQuake is not tied to one vendor. Configure a Connection (URL + key, encrypted at rest) in Settings → Connections, or by environment variable.

Each workspace can assign a different model to every role (extract, query, keyword, summary, embedding, vision). POST /api/v1/providers/test and edgequake doctor tell you what is actually reachable instead of guessing.

Connections, doctor, and encrypted keys land with v0.33.0 (schema 169, already on main). See upgrade-to-0.33.0.

Why Graph-RAG

Vector search finds similar text. It struggles when the answer lives in the relationships between things: "who reports to whom", "which contract affects which product", "what themes run across these 200 papers".

EdgeQuake implements the LightRAG algorithm in Rust. Documents become entities and relationships; at query time it combines vector search with graph traversal.

How it works

Document ─► chunks ─► LLM entity + relation extraction ─► knowledge graph
                                                   │            │
                                          pgvector (embeddings) + Apache AGE (graph)
                                                   │            │
Question ─► keywords ─► vector search + graph walk ─► LLM ─► answer with sources

Details: feature tour · LightRAG deep dive · architecture.

Honest numbers

We publish what we measured, including where we tie. Benchmark: GraphRAG-Bench medical-mid, EdgeQuake vs LightRAG, same corpus and models (make bench, n=200).

So the pitch is not "more accurate than LightRAG". It is the same retrieval quality, productionised: a single Rust binary, Postgres as the only datastore, multi-tenant isolation, auth, a web UI, MCP, SDKs, and explicit, tested upgrades. Methodology and caveats: EQ vs LightRAG · vs GraphRAG · vs traditional RAG.

Built for production

• One datastore for the graph. PostgreSQL 16/17/18 with pgvector. No separate vector DB or graph DB to run. PDF bytes, uploads, page images, and extracted markdown can move to a private bucket. Text and chunks stay in Postgres. The default is still the database. See originals.
• Safe upgrades. The API never migrates your database. edgequake migrate is explicit, progressive, and replay-tested from every published release (SPEC-150, upgrading).
• Secure defaults. Quickstart binds to loopback; secrets are generated; connection keys are AES-256-GCM encrypted and write-only (SECURITY.md, SPEC-163).
• Multi-tenant. Fail-closed workspace isolation for query, delete, and recovery. Built-in auth, SSO (Keycloak/OIDC), and audit logging.
• PDF vision pipeline. Text mode by default (pdfium embedded); vision mode for tables, scans, and complex layouts, with automatic fallback.
• Honest health. /health probes real providers; edgequake doctor checks DB, schema, roles, and security posture.
• Multi-arch images. linux/amd64 + linux/arm64 on GHCR, every release.

Integrations

Documentation

Contributing

Contributions are welcome, from typo fixes to new providers. Start with CONTRIBUTING.md; for a local build run make install && make dev (see AGENTS.md and the pre-delivery checklist).

• Found a bug or want a feature? Open an issue.
• Questions or show-and-tell? GitHub Discussions.
• Like it? A ⭐ helps others find the project.

Acknowledgments

EdgeQuake implements the LightRAG algorithm by Zirui Guo, Lianghao Xia, Yanhua Yu, Tu Ao, and Chao Huang. Also inspired by Microsoft's GraphRAG.

License

Apache License 2.0, see LICENSE. Copyright 2024-2026 Raphaël MANSUY

Star History