# Omnigraph

> Open-source versioned graph database on object storage with git-style branching and hybrid vector, full-text and graph retrieval for agents.

Omnigraph is an open-source, MIT-licensed graph engine from Modern Relay, built around the Lance format and object storage. It gives agents a typed, versioned graph they can read as context and write to through reviewable branches. It ships a CLI, a server, a TypeScript SDK and an MCP server, and a hosted Omnigraph Cloud is listed as a private-preview waitlist.

## What It Is

Omnigraph is a lakehouse-native graph database designed for context assembly and as an operational state and coordination layer for agents. Schemas (.pg files) declare node and edge types, keys and constraints, and the engine enforces them on every write. Data, catalog and state live in a local folder or any S3-compatible bucket in the open Lance format.

## Git-style workflows for agents

Each agent or task can fork its own branch from main, write typed changes in isolation, and have the diff reviewed by a human or another agent before a three-way merge. Commits are atomic across the whole graph, every version stays queryable through time travel, and each commit records its actor, resolved server-side. Destructive changes can require explicit approval before apply runs.

## Retrieval and declarative configuration

Queries are stored, linted .gq files. A single query can combine vector similarity, BM25 full-text and graph traversal, fused with Reciprocal Rank Fusion via rrf(). A cluster.yaml declares graphs, schemas, stored queries, embedding providers and policies, and the cluster plan and cluster apply commands preview and converge changes in a Terraform-style loop. Cedar policies are enforced in-engine on writes.

## Deployment and setup path

Install with a curl script or Homebrew, which provides the omnigraph CLI and omnigraph-server. Run it locally, on your own servers with an S3-compatible store, or follow AWS and Railway blueprints in the cookbooks repository. The cookbooks provide runnable example graphs such as industry intel, pharma intel, context graph, VC OS, biomed research and second brain. The engine is written in Rust on Arrow, DataFusion, Lance and Cedar.

## Features
- Hybrid retrieval combining vector, full-text and graph traversal fused with rrf()
- Typed .pg schemas enforced on every write
- Git-style branching with three-way row-level merge
- Atomic whole-graph commits
- Time travel across every version
- Approval-gated destructive operations
- Cedar policy enforced in-engine with actor audit
- Declarative cluster.yaml with plan and apply workflow
- Object-storage native on S3-compatible stores in open Lance format
- Exportable agent skill for coding agents
- Runnable cookbook example graphs

## Integrations
Lance, Apache Arrow, DataFusion, Cedar, S3-compatible storage, AWS S3, Cloudflare R2, Google Cloud Storage, Azure Blob (preview), RustFS, MinIO, Railway, Model Context Protocol, Claude Code, Codex, TypeScript SDK

## Platforms
MACOS, LINUX, WEB, API, DEVELOPER_SDK, CLI

## Pricing
Open Source

## Version
v0.13.0

## Links
- Website: https://www.omnigraph.dev
- Documentation: https://www.omnigraph.dev/docs
- Repository: https://github.com/ModernRelay/omnigraph
- EveryDev.ai: https://www.everydev.ai/tools/omnigraph