ModernRelay/omnigraph

▲ 800 stars today★ 2,098⑂ 283

Object-storage native graph database with branching and typed ontology

About ModernRelay/omnigraph

ModernRelay/omnigraph is an open-source project on GitHub, mainly written in Rust. Object-storage native graph database with branching and typed ontology It currently holds 2,098 stars and 283 forks with 175 open issues, and was last pushed on 2026-11-13 (repository created 2026-04-10).

Project Overview

Git Homed tracks it on the Today's Trending board.

GitHub Repository Details

Repository ModernRelay/omnigraph · default branch main · size 41410 KB · watchers 25 · source: GitHub REST API and repository README

README

https://github.com/ModernRelay/omnigraph/blob/HEAD/OMNIGRAPH https://github.com/ModernRelay/omnigraph/blob/HEAD/OMNIGRAPH

Object-storage native graph database with branching and typed ontology.
Unified retrieval engine (vector/BM25/graph) · Git-style workflows · Open data format (Lance)

Quickstart  ·  Docs  ·  Cookbooks  ·  CLI  ·  Studio  ·  llms.txt

https://github.com/ModernRelay/omnigraph/blob/HEAD/License: MIT https://github.com/ModernRelay/omnigraph/blob/HEAD/Rust

https://github.com/ModernRelay/omnigraph/blob/HEAD/Omnigraph on Product Hunt


Omnigraph is engineered for the new workload introduced by long-horizon agents: multiple agents sharing a typed world model to continuously retrieve and update context and coordinate work. Agents and UIs can become thin stateless consumers of durable state.

Omnigraph Cloud is in private preview: join the waitlist.

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

Capabilities

| Capability | What it gives you | |---|---| | Typed ontology | Agents share one enforceable model of the domain. .pg schemas declare node and edge types, keys and constraints, and the engine enforces them on every write. | | Multimodal retrieval | Agents assemble high-precision & recall context in one query: graph traversal + vector ANN + full-text + Reciprocal Rank Fusion in one runtime, with filtering. | | Branching | Agents propose reviewable changes instead of writing to main: a branch per agent or task, three-way merge, time travel across the whole graph. | | Declared as code | A cluster.yaml declares graphs, schemas, stored queries, embedding providers and policies. cluster plan previews, cluster apply converges, Terraform-style. | | Security as code | Cedar policy enforced server-side on every mutation, per graph or server-wide; bearer auth, server-resolved actors, audit tracking. | | Object-storage native, open format | Decoupled storage and compute. Store graphs on local disk or S3-compatible storage: RustFS / MinIO, AWS S3 / R2, or Azure preview. Graph data uses open, versioned Lance, including Blob values. |

What you can build

| Use case | What it's for | |---|---| | Company brain | Org knowledge unified into one graph every agent can query | | Agentic memory | Durable, versioned memory: a branch per agent or per task, merged on review | | Context graph | Decision traces and codified tribal knowledge for retrieval | | Dev graph | Issues & dependency model that coding agents read and write | | R&D / ML data layer | Experiments and trials written into branches, versioned for training & eval |

Install

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

This installs omnigraph (CLI) and omnigraph-server into ~/.local/bin from published release binaries. Or with Homebrew:

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

Studio

Omnigraph Studio is the desktop app for your graphs. Browse each type as a table, follow relationships on a canvas, write queries with the compiler's errors as you type, and review what a branch changes before you merge it. It is a native Rust app on GPUI, the framework behind Zed, for macOS, Windows and Linux.

https://github.com/ModernRelay/omnigraph/blob/HEAD/Omnigraph Studio showing what a branch adds, changes and removes, inline in a table

Open a graph on one of your server targets in Studio:

omnigraph studio --target  --graph 

Download Studio or read its source.

Set it up with an AI agent

Omnigraph is built to be run by coding agents. Two ways in:

Teach your agent the playbook. The omnigraph binary carries the omnigraph agent skill written for it: the operational playbook covering cluster mode, the two config surfaces, schema evolution, query linting, data writes, branches, Cedar policy, and the common gotchas. Export it where your agent loads skills, so the skill always matches the installed CLI:

omnigraph skill export ~/.claude/skills/omnigraph --force

With an older CLI that has no skill command, or none installed, npx skills add ModernRelay/omnigraph@omnigraph installs the copy on the default branch instead.

Or have an agent set it up from scratch. Paste this into Claude Code, Codex, or any agent that can read a URL and run a shell command:

Read https://github.com/ModernRelay/omnigraph/blob/main/skills/omnigraph/references/onboarding.md and follow it to set up Omnigraph for me.

The agent installs the CLI, asks what the graph is for, builds and queries a small local graph, and then points to the cookbooks, a cluster or Omnigraph Cloud.

For ready-to-run graphs with real seed data (company brain, VC operating system, pharma & industry intel), ModernRelay/omnigraph-cookbooks is the fastest way to see Omnigraph shaped to a real domain.

Deploy

A cluster declares graphs, schemas, stored queries, and policies in a configuration bundle. cluster plan previews changes and cluster apply submits them to the selected destination. The cluster-only HTTP server exposes graphs at /graphs/{id}/… and activates applied changes without a restart.

Keep desired configuration separate from its destination:

company-brain/
├── cluster.yaml
├── people.pg          # schema for the "knowledge" graph
├── queries/           # stored queries: the .gq files ARE the declaration
│   └── people.gq
├── cluster.policy.yaml # deployment permissions
└── graph.policy.yaml   # graph permissions
# cluster.yaml
version: 1
metadata:
  name: company-brain
graphs:
  knowledge:
    schema: people.pg
    queries: queries/                          # every query  in queries/*.gq registers
policies:
  cluster-access:
    file: cluster.policy.yaml
    applies_to: [cluster]
  graph-access:
    file: graph.policy.yaml
    applies_to: [knowledge]

For first boot, follow the cluster guide, including writer ownership transfer and authentication. The deployment guide covers containers and object stores; Azure writers require its admission wrapper.

The applied cluster policy must grant the authenticated operator config_manage. Schema changes also require read and schema_apply on the affected graphs. With those grants and a server target named production, deploy local edits:

omnigraph cluster validate --config ./company-brain
omnigraph cluster plan --target production --config ./company-brain
omnigraph cluster apply --target production --config ./company-brain

--config names the source bundle; --target names the destination. Omitting storage from the bundle uses the selected destination's root. If present, storage must match that root; it never selects or redirects the target. Apply prints a deployment ID. If delivery is interrupted, inspect that ID before submitting again; see deployment recovery.

Query and mutate

Define a server target with default_graph and set defaults.target once in ~/.omnigraph/config.yaml (configuration), and the everyday commands stay short. Stored queries and mutations run by name:

omnigraph query  search_docs --params '{"q":"AI safety"}'
omnigraph mutate add_person  --params '{"name":"Mina"}'

Branch, review and merge across the whole graph, so agents write in isolation:

omnigraph branch create --from main agent/ingest-42
omnigraph branch merge  agent/ingest-42 --into main

An alias is shorter still: bind a target, graph, and stored query to one name, then omnigraph alias triage runs it. Data commands use --target NAME for a configured server or managed resource, plus --graph ID when needed. Use --target ./graph.omni for a standalone local graph. Control-plane login and organization operations use --profile; see operator configuration.

Security & governance

See the policy guide.

Clients & SDKs

| Client | Use it for | Where | |---|---|---| | TypeScript SDK | typed access from Node / TS | @modernrelay/omnigraph · source | | Built-in MCP | connect an agent to the server's /mcp, directly or through omnigraph mcp --target NAME | MCP guide | | Omnigraph Studio | browse, query and review a graph in a desktop app | download · source | | HTTP / OpenAPI | use the wire contract from any language | HTTP guide · OpenAPI |

Match the client's HTTP contract to the server's. The 0.14 server requires contract 0.14; see client availability before selecting an npm package.

Docs

Build and test

cargo build --workspace --locked
cargo test --workspace --exclude omnigraph-gqt --exclude omnigraph-gqt-served --exclude omnigraph-dst --locked \
  --features omnigraph-engine/failpoints,omnigraph-cluster/failpoints

Notes:

Contributing

Please open an issue before sending large code changes — a maintainer triages it, and the accepted label is the green light for a PR (see GOVERNANCE.md). 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.

GitHub Stars & Activity

2,098Stars
283Forks
175Open issues
RustLanguage

GitHub Popularity

GitHub stars2,098
Forks283
Open issues175
Primary languageRust
LicenseMIT
Stars gained today800
Created2026-04-10
Last pushed2026-11-13

Trending History

Weekly boardrank #57 · ▲ 800 stars

Related GitHub Projects

1

farion1231 / cc-switch

Rust★ 155,112⑂ 10,154▲ 312 stars
→
2

pbakaus / impeccable

Rust★ 111,729⑂ 6,673▲ 693 stars
→
3

rustfs / rustfs

Rust★ 36,197⑂ 1,679▲ 55 stars
→
4

t8y2 / dbx

Rust★ 30,593⑂ 2,785▲ 101 stars
→
5

PrimeIntellect-ai / prime-agent

Rust★ 22,795⑂ 2,530▲ 67 stars
→
6

anomalyco / hex

Rust★ 7,199⑂ 469▲ 198 stars
→
7

NVIDIA-NeMo / Switchyard

Rust★ 3,616⑂ 374▲ 41 stars
→
8

BurntSushi / jiff

Rust★ 3,116⑂ 141▲ 61 stars
→

More Trending Repositories