https://github.com/ModernRelay/omnigraph
Typed property graph database with Git-style workflows, local or S3 storage, and typed queries.
https://github.com/ModernRelay/omnigraph
Last synced: 28 days ago
JSON representation
Typed property graph database with Git-style workflows, local or S3 storage, and typed queries.
- Host: GitHub
- URL: https://github.com/ModernRelay/omnigraph
- Owner: ModernRelay
- License: mit
- Created: 2026-04-10T17:50:30.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-25T22:03:00.000Z (about 1 month ago)
- Last Synced: 2026-04-25T23:31:10.368Z (about 1 month ago)
- Language: Rust
- Homepage: https://omnigraph.dev
- Size: 1.62 MB
- Stars: 41
- Watchers: 2
- Forks: 6
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-data-engineering - Omnigraph - Typed graph database where agents branch and merge like Git. S3-native, Rust, traversal + vector + BM25 in one runtime. (Databases)
- awesome-rust-tools - omnigraph - native, traversal + vector + BM25 in one runtime." (Dev-Utilities)
- awesome-llmops - Omnigraph - native, Rust, traversal + vector + BM25 in one runtime. |  | (Search / Vector search)
- awesome-rust - omnigraph - native, traversal + vector + BM25 in one runtime (Libraries / Database)
- awesome-llm-prod - Omnigraph - Versioning, Graph-Database, Agent-Memory|Typed property graph database with Git-style workflows, S3-native storage, and typed queries| (5. **Data Generation, Processing and Management**)
- awesome-search - Omnigraph - Typed graph database where agents branch and merge like Git. S3-native, Rust, traversal + vector + BM25 in one runtime. (Industry players / Products and services)
README
# Omnigraph
[](LICENSE)
[](rust-toolchain.toml)
[](https://crates.io/crates/omnigraph-cli)
[](https://github.com/ModernRelay/omnigraph/actions/workflows/ci.yml)
**Lakehouse-native graph engine with git-style workflows.**
Branch, commit, and merge typed graph data like source code. Multi-modal, self-hosted, open source.
## Use Cases
- On-prem & hybrid context graphs
- Backbone for multi-agent research
- Incident response graphs
- Compliance & audit graphs
- Enterprise knowledge systems
## Capabilities
- Typed schema, typed queries, and typed mutations
- Schema-as-code, query validation and linting
- Git-style graph workflows: branches, commits, merges, and transactional runs
- Local, on-prem & cloud S3-native storage with snapshot-pinned reads
- Graph traversal + text, fuzzy, BM25, vector, and RRF search in one runtime
- Policy-as-code for server-side access control
- Single CLI for multiple deployments
## Quick Install
```bash
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:
```bash
brew tap ModernRelay/tap
brew install ModernRelay/tap/omnigraph
```
For starter graphs and agent skills to bootstrap and operate Omnigraph, see [`ModernRelay/omnigraph-cookbooks`](https://github.com/ModernRelay/omnigraph-cookbooks).
## One-Command Local RustFS Bootstrap
```bash
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 repo
- 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 repo prefix but did not finish
initializing the repo, rerun with `RESET_REPO=1` or set `PREFIX` to a new
value.
## Common Commands
The same URI works for local paths, `s3://…`, or `http://host:port`.
```bash
omnigraph init --schema ./schema.pg ./repo.omni
omnigraph load --data ./data.jsonl ./repo.omni
omnigraph read --query ./queries.gq --name get_person --params '{"name":"Alice"}' ./repo.omni
omnigraph change --query ./queries.gq --name insert_person --params '{"name":"Mina"}' ./repo.omni
omnigraph branch create --from main feature-x ./repo.omni
omnigraph branch merge feature-x --into main ./repo.omni
```
See [docs/cli.md](docs/cli.md) for schema apply, snapshots, ingest, runs, and policy commands.
## Docs
- [Install guide](docs/install.md)
- [CLI guide](docs/cli.md)
- [Deployment guide](docs/deployment.md)
## Build And Test
```bash
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
- `crates/omnigraph`: storage/runtime, branching, merge, change detection, and query execution
- `crates/omnigraph-cli`: CLI for init/load/ingest/read/change/branch/snapshot/export/policy operations
- `crates/omnigraph-server`: Axum HTTP server for remote reads, changes, ingest, export, branches, commits, and runs
## 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](https://join.slack.com/t/omnigraphworkspace/shared_invite/zt-3wfpglyxj-lHvJGhuySPfqLtN35uJZNw)
to ask questions, share feedback, and follow development.