Omnigraph

Lakehouse native graph engine built for context assembly

Omnigraph acts as operational state & coordination layer for agents. Hundreds of agents can enrich the graph on parallel isolated branches and changes can be reviewed and merged safely.

• Git-style versioning & branching
• Multimodal retrieval (graph+vector/fts+filters) optimized for context assembly
• Object storage native (S3, RustFS)
• Native blob-as-data support (docs, images, videos, etc)
• VPC, On-prem, hybrid deployment
• Lance format as open storage layer

AS CODE	What it means
Schema AS CODE	Typed .pg schemas, planned, applied, enforced
Context AS CODE	Linted queries & agentic nudges, versioned and reusable
Security AS CODE	Cedar policies enforced server-side on every mutation
Dashboards AS CODE	Declarative views & controls over the graph (coming)

Core Use Cases

Use case	What it's for
Company brain	Org knowledge unified into one queryable graph
Context graph	Decision traces and codified tribal knowledge
Agentic memory	Durable, versioned memory for long-running agents
Dev graph	Issues & dependency model for coding agents
R&D data layer	Experiments & trials data written into branches
ML workflows	Versioned, branchable graphs for training & eval
Karpathy's LLM wiki	A living, agent-updatable knowledge base

Quick Install

curl -fsSL https://raw.githubusercontent.com/ModernRelay/omnigraph/main/scripts/install.sh | bash

This installs omnigraph and omnigraph-server into ~/.local/bin from published release binaries.

Or install with Homebrew:

brew tap ModernRelay/tap
brew install ModernRelay/tap/omnigraph

For starter graphs and agent skills to bootstrap and operate Omnigraph, see ModernRelay/omnigraph-cookbooks.

One-Command Local RustFS Bootstrap

curl -fsSL https://raw.githubusercontent.com/ModernRelay/omnigraph/main/scripts/local-rustfs-bootstrap.sh | bash

That bootstrap:

• starts RustFS on 127.0.0.1:9000
• creates a bucket and S3-backed graph
• loads the checked-in context fixture
• launches omnigraph-server on 127.0.0.1:8080

Docker must be installed and running first.

The RustFS bootstrap prefers the rolling edge binaries and only falls back to source builds when release assets are unavailable.

If a previous run left objects under the same graph prefix but did not finish initializing the graph, rerun with RESET_REPO=1 or set PREFIX to a new value.

Common Commands

Every command declares the capability it needs and how it's addressed. Direct storage (init, load, branch, …) takes a positional file:///s3:// URI or --store <uri>; a served graph is addressed with --server <name|url> (never a positional http(s):// URI). query/mutate invoke a stored query by name (the positional is the query name, not a graph URI).

# Create a graph and load data (--mode is required; overwrite is destructive)
omnigraph init --schema ./schema.pg ./graph.omni
omnigraph load --data ./data.jsonl --mode merge --store ./graph.omni

# Read / write — ad-hoc .gq against a local store (positional selects the query)
omnigraph query  --query ./queries.gq get_person    --params '{"name":"Alice"}' --store ./graph.omni
omnigraph mutate --query ./queries.gq insert_person  --params '{"name":"Mina"}'  --store ./graph.omni

# Branch and merge (Git-style, across the whole graph)
omnigraph branch create --from main feature-x --store ./graph.omni
omnigraph branch merge  feature-x --into main --store ./graph.omni

# Against a running server: invoke a stored query by name from the catalog
omnigraph query find_people --server prod --graph knowledge --params '{"q":"AI safety"}'

Operator settings (identity, named servers/clusters, credentials, defaults) live in ~/.omnigraph/config.yaml; with a default scope set, the addressing flags can be omitted. See docs/user/cli/index.md and the CLI reference for schema apply, snapshots, commits, profiles, and policy/queries tooling.

Serving (cluster-first)

A deployment is a cluster: a cluster.yaml (graphs, schemas, stored queries, policies, storage) that you converge with cluster apply, then serve. The server boots from the cluster only — it has no single-graph mode — and serves every graph under /graphs/{id}/….

omnigraph cluster apply  --config ./company-brain          # converge the declared state
omnigraph-server --cluster ./company-brain --bind 0.0.0.0:8080
# or config-free from object storage — the bucket IS the deployment:
omnigraph-server --cluster s3://my-bucket/company-brain --bind 0.0.0.0:8080

See the cluster guide and deployment guide.

Clients

For programmatic access to a running omnigraph-server:

• TypeScript SDK — @modernrelay/omnigraph (source). Instance-per-client, typed errors, camelCase types, async-iterator streaming export.

  npm install @modernrelay/omnigraph
  

• Model Context Protocol server — @modernrelay/omnigraph-mcp (source). Bridges Omnigraph to LLM hosts (Claude Desktop, Claude Code, …) over stdio. Exposes tools and resources for schema, branches, queries, mutations, ingest, and bundles curated best-practices guidance from the cookbook.

  npm install -g @modernrelay/omnigraph-mcp
  

Both packages are versioned in lockstep with omnigraph-server on major.minor: @modernrelay/omnigraph@X.Y.* targets omnigraph-server@X.Y.*. See ModernRelay/omnigraph-ts for the monorepo.

Docs

• Install guide
• Deployment guide

Build And Test

cargo build --workspace
cargo check --workspace
cargo test --workspace

Notes:

• Rust stable toolchain, edition 2024
• CI runs cargo test --workspace --locked
• Full CI and some local test flows require protobuf-compiler
• S3 integration tests expect an S3-compatible endpoint such as RustFS

Workspace Crates

• crates/omnigraph-compiler: shared schema/query parser, typechecker, catalog, and IR lowering (zero Lance dependency)
• crates/omnigraph (package omnigraph-engine): storage/runtime, branching, merge, change detection, query execution, and embeddings
• crates/omnigraph-policy: Cedar policy compilation and enforcement
• crates/omnigraph-api-types: shared HTTP wire DTOs used by both the server and the CLI
• crates/omnigraph-cluster: cluster config validation, planning, and apply (the control plane)
• crates/omnigraph-server: Axum HTTP server — cluster-first, serving N graphs under /graphs/{id}/…
• crates/omnigraph-cli: CLI for graph lifecycle (init/load), query/mutate, branch/commit/merge, schema/lint, snapshot/export, cluster control, policy/queries, profiles, and maintenance (optimize/repair/cleanup)

Contributing

Please open an issue, spec, or design discussion before sending large code changes. Design feedback and concrete problem statements are the fastest way to collaborate on the roadmap.

Community

Join the Omnigraph Slack community to ask questions, share feedback, and follow development.