How modernrelay/omnigraph works
Omnigraph is an object-storage-native graph database for typed, versioned data and unified retrieval. A user works through the CLI or server; cluster configuration declares graphs, schemas, stored queries, and policies, then deployment applies them before queries and mutations run. The README also highlights branch-and-merge workflows, multimodal retrieval, security, and blob data. Several internal links below reflect documented capabilities; unsampled implementation details are not treated as verified call paths.
Main entry points: handlers.rs Graph server · run.rs Query engine · omnigraph.rs Graph operations · deployment.rs Cluster deploy
Components 17
User interfaces
- CLI commands
crates/omnigraph-cli/src/main.rs - Graph client
crates/omnigraph-cli/src/client.rs - Graph server
crates/omnigraph-server/src/handlers.rs - API contracts
crates/omnigraph-api-types/src/lib.rs
Cluster governance
- Cluster deploy
crates/omnigraph-cluster/src/deployment.rs - Schema compiler
crates/omnigraph-compiler/src/schema/parser.rs
Query runtime
- Query compiler
crates/omnigraph-compiler/src/query/parser.rs - Query planner
crates/omnigraph-planner/src/optimizer.rs - Query engine
crates/omnigraph/src/engine/run.rs - Query entry points
crates/omnigraph/src/exec/query_doors.rs
Graph state and storage
- Graph operations
crates/omnigraph/src/db/omnigraph.rs - Branch catalog
crates/omnigraph-catalog/src/commit_graph.rs - Staged table storage
crates/omnigraph/src/storage_layer.rs - Lance storage backend
crates/omnigraph-storage/src/lib.rs
Security and data
- Cedar policies
crates/omnigraph-policy/src/lib.rs - Blob transport
crates/omnigraph-server/src/blob_transport.rs
Other components
- Agent or UI
Connections 19
- Agent or UI → CLI commands: issues commands
README.md - Agent or UI → Graph server: sends requests
README.md - CLI commands → Graph client: dispatches commands
crates/omnigraph-cli/src/main.rs - Graph client → Graph server: uses HTTP
crates/omnigraph-cli/src/client.rs - Graph client → Graph operations: uses embedded engine
crates/omnigraph-cli/src/client.rs - Cluster deploy → Schema compiler: applies schemas
README.md - Cluster deploy → Cedar policies: publishes policies
README.md - Cluster deploy → Graph operations: creates graphs
README.md - Graph server → Graph operations: serves graph operations
README.md - Graph server → Cedar policies: enforces policies
README.md - Graph server → Blob transport: transfers blobs
- Query entry points → Query engine: enters runtime
crates/omnigraph/src/exec/query_doors.rs - Query engine → Query compiler: uses compiled queries
- Query compiler → Query planner: supplies query plans
- Query planner → Query engine: plans execution
- Query engine → Staged table storage: reads and writes
- Graph operations → Branch catalog: tracks branch history
- Staged table storage → Lance storage backend: persists tables
crates/omnigraph/src/storage_layer.rs - CLI commands → API contracts: uses API contracts