Metadata-Version: 2.4
Name: engramedb
Version: 0.1.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Rust
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
License-File: LICENSE
Summary: Real-time Code-Native Graph Database Engine (Rust Core)
Author: Ghassen Saidi
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM

# engramdb

**Real-time Code-Native Graph Database Engine** — a Rust-powered Python library for building and querying code knowledge graphs.

## What it is

EngramDB indexes code into a graph database with:

- **Metadata engine**: stores code nodes (files, functions, classes) with rich metadata
- **CSR graph**: compressed sparse row graph for fast call-graph traversal
- **Blast radius analysis**: find all transitive callers/callees of any node
- **Zero-copy storage**: memory-mapped persistent snapshots

## Quick start

```python
from engramdb import PyMetadataEngine

engine = PyMetadataEngine("/path/to/workspace")
engine.add_node("my_file:func1", "function", "func1", "my_file.py")
engine.build()
```

## Requirements

- Python ≥ 3.10
- Pre-built wheels available for Linux, macOS, Windows (no Rust needed)

## License

MIT

