grounded-graph
Graph traversal and context queries over code metadata. grounded-graph reads a
grounded-index SQLite database
and exposes call graphs, impact analysis, test discovery, and token-bounded
context packs for AI coding agents.
Two storage backends:
- Pure-Python (
--backend python) — fast in-memory, no extra dependencies. - sqlitegraph (
--backend sqlitegraph) — file-backed Rust graph with HNSW semantic search and persistent indexes.
Quick start
# 1. Index your project (produces .grounded-index.db)
grounded-index index .
# 2. Load the graph and check stats
grounded-graph index --backend python
# 3. Query
grounded-graph callers --symbol my_function
grounded-graph tests-for --symbol CustomerService
grounded-graph neighborhood --symbol my_function --depth 2 --budget 4000
What it does
| Capability | Description |
|---|---|
| Call graph | callers, callees, impact, affected with kind-filtered traversal |
| Test mapping | tests-for links tests to the symbols they exercise |
| Shortest path | path --from A --to B between any two symbols |
| Context packs | neighborhood returns priority-ranked, token-bounded symbol context |
| Semantic search | HNSW-backed similarity search over symbol embeddings (sqlitegraph only) |
| Multi-kind edges | Same node pair can carry call, defines, imports, and tests edges |
See MANUAL.md for full CLI documentation and API.md for the Python API.
Install
pip install grounded-graph
Requires Python >= 3.10.
Version
Current version: 0.4.1
1 maintainer
Metadata
1 maintainer
Release files for grounded-graph 0.4.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| grounded_graph-0.4.1.tar.gz | 44.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| grounded_graph-0.4.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 66.9 kB
Release files / grounded_graph-0.4.1.tar.gz
| Download URL | grounded_graph-0.4.1.tar.gz |
|---|---|
| Size | 44.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
825d6e94612b50fcc84344c112394d65c8f896a8a0e5a1a73772b082371f68fc
|
|
BLAKE2b-256 checksum How to use checksums |
b04a2695337fb4fdbce90cfa1d5c3ee0e9f01dde574021dee4fb299ea4a9daad
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"CachyOS Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / grounded_graph-0.4.1-py3-none-any.whl
| Download URL | grounded_graph-0.4.1-py3-none-any.whl |
|---|---|
| Size | 22.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
81c08d69465fd47499fc83c62cf6ca6171bca87de5d35b3f0d92ace67010e66d
|
|
BLAKE2b-256 checksum How to use checksums |
4fabac4b1940f81c66fe7f9f81dfb810214628befb18969c06cbab592b4f6593
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"CachyOS Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
