$git clone https://github.com/ModernRelay/omnigraph<hr>
| 1 | <p align="center"> |
| 2 | <picture> |
| 3 | <source media="(prefers-color-scheme: dark)" srcset="assets/omnigraph-wordmark-dark.svg"> |
| 4 | <img alt="OMNIGRAPH" src="assets/omnigraph-wordmark.svg" width="420"> |
| 5 | </picture> |
| 6 | </p> |
| 7 | |
| 8 | <p align="center"> |
| 9 | <strong>Lakehouse graph database for context assembly & multi-agent coordination</strong><br> |
| 10 | <sub>Multimodal retrieval · Git-style branching · object-storage native</sub> |
| 11 | </p> |
| 12 | |
| 13 | <p align="center"> |
| 14 | <a href="docs/user/quickstart.md">Quickstart</a> · |
| 15 | <a href="docs/user/clusters/index.md">Docs</a> · |
| 16 | <a href="https://github.com/ModernRelay/omnigraph-cookbooks">Cookbooks</a> · |
| 17 | <a href="docs/user/cli/reference.md">CLI</a> |
| 18 | </p> |
| 19 | |
| 20 | <p align="center"> |
| 21 | <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-1b1b1f?style=flat-square&labelColor=1b1b1f"></a> |
| 22 | <a href="https://crates.io/crates/omnigraph-cli"><img alt="crates.io" src="https://img.shields.io/crates/v/omnigraph-cli?style=flat-square&color=d71921&labelColor=1b1b1f"></a> |
| 23 | <a href="rust-toolchain.toml"><img alt="Rust" src="https://img.shields.io/badge/rust-stable-1b1b1f?style=flat-square&labelColor=1b1b1f"></a> |
| 24 | </p> |
| 25 | |
| 26 | <hr> |
| 27 | |
| 28 | Omnigraph is the operational state and coordination layer for fleets of agents.\ |
| 29 | Run it as a server, declared as code; hundreds of agents operate and enrich the graph on parallel isolated branches, and every change is reviewed and merged safely. |
| 30 | |
| 31 | Join the [Omnigraph Slack community](https://join.slack.com/t/omnigraphworkspace/shared_invite/zt-3wfpglyxj-lHvJGhuySPfqLtN35uJZNw) |
| 32 | to ask questions, share feedback, and follow development. |
| 33 | |
| 34 | ## Key capabilities |
| 35 | |
| 36 | | Capability | What it gives you | |
| 37 | |---|---| |
| 38 | | **Declared as code** | A `cluster.yaml` declares graphs, schemas, stored queries, embedding providers, and policies; `cluster apply` converges it and `omnigraph-server` brings every graph online at `/graphs/{id}/…`. | |
| 39 | | **Built for fleets of agents** | Hundreds of agents enrich the graph on **parallel isolated branches**; changes are reviewed and merged safely, Git-style, across the whole graph. | |
| 40 | | **Multimodal retrieval** | Graph traversal + vector ANN + full-text + Reciprocal Rank Fusion in **one** query runtime, for context assembly. | |
| 41 | | **Security as code** | Cedar policy enforced **server-side on every mutation**, per-graph and server-wide; bearer auth; actor/audit tracking. | |
| 42 | | **Runs on your infrastructure** | Any S3-compatible object store: **on-prem via RustFS / MinIO**, or AWS S3 / R2 / GCS. VPC, on-prem, hybrid; your data never leaves your store. | |
| 43 | | **Open, versioned storage** | [`Lance`](https://github.com/lance-format/lance) columnar format: branchable, time-travelable, with native blob-as-data (docs, images, video). | |
| 44 | |
| 45 | ## What you can build |
| 46 | |
| 47 | | Use case | What it's for | |
| 48 | |---|---| |
| 49 | | **Company brain** | Org knowledge unified into one graph every agent can query | |
| 50 | | **Agentic memory** | Durable, versioned memory: a branch per agent or per task, merged on review | |
| 51 | | **Context graph** | Decision traces and codified tribal knowledge for retrieval | |
| 52 | | **Dev graph** | Issues & dependency model that coding agents read and write | |
| 53 | | **R&D / ML data layer** | Experiments and trials written into branches, versioned for training & eval | |
| 54 | |
| 55 | ## Install |
| 56 | |
| 57 | ```bash |
| 58 | curl -fsSL https://raw.githubusercontent.com/ModernRelay/omnigraph/main/scripts/install.sh | bash |
| 59 | ``` |
| 60 | |
| 61 | This installs `omnigraph` (CLI) and `omnigraph-server` into `~/.local/bin` from |
| 62 | published release binaries. Or with Homebrew: |
| 63 | |
| 64 | ```bash |
| 65 | brew tap ModernRelay/tap |
| 66 | brew install ModernRelay/tap/omnigraph |
| 67 | ``` |
| 68 | |
| 69 | ## Set it up with an AI agent |
| 70 | |
| 71 | Omnigraph is built to be run by coding agents. Two ways in: |
| 72 | |
| 73 | **Teach your agent the playbook.** This repo ships the |
| 74 | [**`omnigraph` agent skill**](skills/omnigraph): the operational playbook |
| 75 | covering cluster mode, the two config surfaces, schema evolution, query linting, |
| 76 | data writes, branches, Cedar policy, and the common gotchas. |
| 77 | |
| 78 | ```bash |
| 79 | npx skills add ModernR |