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
Metadata
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 | Provenance | Actions |
|---|---|---|---|---|
| grounded_graph-0.4.1.tar.gz | 44.4 kB | Without provenance | Details for grounded_graph-0.4.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| grounded_graph-0.4.1-py3-none-any.whl | Python 3 | none | any | Details for grounded_graph-0.4.1-py3-none-any.whl |
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}
|
Security for grounded-graph 0.4.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.