Repo brief: cozodb/cozo

Generated by RepoPilot · document generated 2026-09-16 · concise human review Evidence snapshot · analyzed 2026-09-16T09:14:38.936Z · commit 481af058abac

Verdict

Mixed — Stale — last commit 2y ago

• 15 active contributors
• MPL-2.0 licensed
• CI configured
• Tests present

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against dependency CVEs from deps.dev and OpenSSF Scorecard

What it is

CozoDB is a transactional relational-graph-vector database that uses Datalog as its query language, enabling seamless integration of traditional SQL-like queries, graph algorithms, and vector similarity search within a single query framework. It targets AI applications by providing a unified data layer (the 'hippocampus') that combines structured data, graph relationships, and embedding vectors without requiring separate databases. Monorepo with cozo-core as the query engine and storage layer, cozo-bin as the CLI/REPL/server wrapper, cozorocks as the embedded RocksDB backend, and language bindings in separate crates (cozo-lib-python, cozo-lib-wasm, cozo-lib-swift, cozo-lib-nodejs,…

Start here

Read these in order:

• cozo-bin/src/client.rs — Foundation: doesn't import anything internally and is imported by 1 other file. Read first to learn the vocabulary.
• cozo-bin/src/repl.rs — Foundation: imported by 1, no internal dependencies of its own.
• cozo-core/src/data/tests/mod.rs — Built on the foundation; imported by 1 downstream file.
• cozo-core/src/fts/tokenizer/stop_word_filter/mod.rs — Built on the foundation; imported by 1 downstream file.
• cozo-core/src/data/mod.rs — Layer 2 — application-level code that wires the lower layers together.

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

Clone: git clone https://github.com/cozodb/cozo.git && cd cozo. Install Rust if needed. Build core: cargo build -p cozo-core --release. Build CLI: cargo build -p cozo-bin --release. Run REPL: `cargo run -p cozo-bi…

Daily commands:

Dev server: cargo run -p cozo-bin -- --server (inferred from cozo-bin/src/server.rs). REPL: cargo run -p cozo-bin -- --repl. Examples: cargo run --bin run --manifest-path cozo-core-examples/Cargo.toml.…

…shortened for this brief.

Key cautions & unknowns

• Stale — last commit 2y ago
• Concentrated ownership — top contributor handles 72% of recent commits
• Scorecard: marked unmaintained (0/10)
• RocksDB dependency: cozorocks crate wraps native RocksDB; build requires C++ compiler and build tools. Workspace resolver: Cargo.toml uses resolver = 2; older Rust toolchains may fail. Grammar regeneration:…
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.