{"id":48009281,"url":"https://github.com/firelock-ai/kin-db","last_synced_at":"2026-04-04T13:28:23.252Z","repository":{"id":345654744,"uuid":"1181572235","full_name":"firelock-ai/kin-db","owner":"firelock-ai","description":"Embeddable graph engine for code-aware tools. Purpose-built in Rust. Apache-2.0.","archived":false,"fork":false,"pushed_at":"2026-03-28T12:05:40.000Z","size":1277,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-28T15:37:37.139Z","etag":null,"topics":["apache-2-0","code-analysis","code-intelligence","embedded","graph-database","kin","rust","semantic","semantic-graph","tree-sitter"],"latest_commit_sha":null,"homepage":"https://firelock.ai/labs/kin-db","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/firelock-ai.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-14T10:24:16.000Z","updated_at":"2026-03-28T12:05:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/firelock-ai/kin-db","commit_stats":null,"previous_names":["firelock-ai/kin-db"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/firelock-ai/kin-db","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firelock-ai%2Fkin-db","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firelock-ai%2Fkin-db/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firelock-ai%2Fkin-db/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firelock-ai%2Fkin-db/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/firelock-ai","download_url":"https://codeload.github.com/firelock-ai/kin-db/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firelock-ai%2Fkin-db/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31402268,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T10:20:44.708Z","status":"ssl_error","status_checked_at":"2026-04-04T10:20:06.846Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apache-2-0","code-analysis","code-intelligence","embedded","graph-database","kin","rust","semantic","semantic-graph","tree-sitter"],"created_at":"2026-04-04T13:28:22.600Z","updated_at":"2026-04-04T13:28:23.245Z","avatar_url":"https://github.com/firelock-ai.png","language":"Rust","readme":"\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\".github/kindb-lockup-dark.png\"\u003e\n    \u003csource media=\"(prefers-color-scheme: light)\" srcset=\".github/kindb-lockup-light.png\"\u003e\n    \u003cimg src=\".github/kindb-lockup-light.png\" height=\"64\" alt=\"KinDB\"\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\n# KinDB\n\n**Embeddable graph engine for code-aware tools.**\n\nKinDB is a purpose-built graph engine in Rust. It provides the storage, indexing, and retrieval substrate for the [Kin](https://github.com/firelock-ai/kin) semantic version control system and now ships as its own Apache-licensed repo.\n\n\u003e **Alpha** -- APIs will evolve. Proven now: the core engine is exercised by Kin's 1,400+ test suite, current validated benchmark sweeps, and standalone source builds from this repo. Still hardening: API shape, embedding/vector tuning, and surfaces above the substrate.\n\n[![CI](https://github.com/firelock-ai/kin-db/actions/workflows/ci.yml/badge.svg)](https://github.com/firelock-ai/kin-db/actions/workflows/ci.yml)\n[![codecov](https://codecov.io/gh/firelock-ai/kin-db/branch/main/graph/badge.svg)](https://codecov.io/gh/firelock-ai/kin-db)\n[![License: Apache-2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)\n[![Rust](https://img.shields.io/badge/Rust-2021_edition-orange.svg)](https://www.rust-lang.org/)\n[![Status: Alpha](https://img.shields.io/badge/Status-Alpha-yellow.svg)](#status)\n\n---\n\n## What KinDB Does\n\n- **In-memory graph engine** with HashMap-based adjacency lists and compiled Rust queries (no query language, zero parsing overhead)\n- **Snapshot persistence** with atomic writes, mmap-backed loads, and an RCU-style snapshot manager\n- **Full-text search** via Tantivy\n- **Vector similarity search** via HNSW index\n- **Incremental indexing** for graph updates without full rebuilds\n- **Static schema** -- Entity and Relation types known at compile time\n\n---\n\n## Quick Start\n\n```bash\n# Prerequisites: Rust stable\ngit clone https://github.com/firelock-ai/kin-db.git\ncd kin-db\ncargo build --release\n\n# Run tests\ncargo test -p kin-db\n```\n\nThis repo now builds standalone. The repo-owned `kin-model` crate lives here too, so fresh clones do not need any sibling checkout.\n\n---\n\n## Repo Layout\n\n```\ncrates/kin-db/       # Main Rust crate\n  src/\n    types.rs         # Re-exports of canonical types from kin-model\n    store.rs         # Re-export of the local GraphStore trait surface\n    engine/          # In-memory graph, indexes, traversal\n    storage/         # mmap persistence, RCU snapshots\n    vector/          # HNSW vector similarity search\n    search/          # Full-text search via Tantivy\ndocs/\n  ARCHITECTURE.md    # Current-state notes plus historical KuzuDB-\u003eKinDB migration rationale\n  EVALUATION.md      # Historical database comparison that led to building KinDB\n  ZERO_COPY_PLAN.md  # Performance and memory direction\ncrates/kin-model/    # Shared canonical types consumed by kin-db and Kin\n```\n\nOptional feature flags in `crates/kin-db/Cargo.toml` enable Metal, CUDA, and Accelerate-backed embedding/runtime paths.\n\n---\n\n## Design Principles\n\n- **Batch write, continuous read** -- optimized for bulk indexing (like `kin commit`) followed by many reads.\n- **No query language** -- all queries are compiled Rust functions. No parsing overhead, no runtime interpretation.\n- **Static schema** -- Entity/Relation types known at compile time. No runtime schema discovery.\n- **Narrow scope** -- storage and low-level query capability live here. Semantic rules, review logic, and ranking strategy stay in higher layers.\n\n---\n\n## Status\n\n**Proven now:**\n- In-memory graph with snapshot persistence\n- Mixed-language persistence/reload plus entity and graph-root verification coverage\n- Checksum-protected snapshots plus fail-closed recovery from marked atomic-write tmp files\n- Concurrent read access via RCU\n- Tantivy-backed full-text search\n- Vector similarity search with save/load coherence and marker-proven fail-closed key-map sidecars\n- Used as the storage engine for Kin's full test and benchmark suite\n\n**Still hardening:**\n- Embedding and vector-search tuning\n- Zero-copy read path optimizations\n- API surface outside Kin\n\n---\n\n## Ecosystem\n\nThe substrate is shipping now. The rest of the stack is active infrastructure around it, with some surfaces still hardening rather than speculative.\n\n| Component | Status | Description |\n|-----------|--------|-------------|\n| **[kin](https://github.com/firelock-ai/kin)** | Shipping now | Semantic VCS -- primary consumer of KinDB |\n| **[kin-db](https://github.com/firelock-ai/kin-db)** | Shipping now | Graph engine substrate (this repo) |\n| **[kin-vfs](https://github.com/firelock-ai/kin-vfs)** | Alpha | Virtual filesystem -- serves files from blob store |\n| **[kin-editor](https://github.com/firelock-ai/kin-editor)** | Active | VS Code extension -- entity explorer, semantic search, trace |\n| **[KinLab](https://kinlab.ai)** | Hardening | Hosted collaboration layer |\n\nKinDB exists as a separate repo because storage, indexing, retrieval, and the shared `kin-model` surface are foundational concerns that sit below the higher-level Kin product layers.\n\n---\n\n## Contributing\n\nContributions welcome. Please open an issue before submitting large changes.\n\n## License\n\nApache-2.0.\n\n---\n\nCreated by [Troy Fortin](https://www.linkedin.com/in/troy-fortin-jr/) at [Firelock, LLC](https://firelock.ai).\n\n---\n\n*\"So neither the one who plants nor the one who waters is anything, but only God, who makes things grow.\" — 1 Corinthians 3:7*\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffirelock-ai%2Fkin-db","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffirelock-ai%2Fkin-db","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffirelock-ai%2Fkin-db/lists"}