Metadata-Version: 2.4
Name: hora-graph-core
Version: 1.0.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Rust
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Database
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Summary: Bio-inspired embedded knowledge graph engine — pure Rust, zero runtime deps
Keywords: knowledge-graph,graph-database,memory,embedded,vector-search
Author: Vivien Martin
License: MIT OR Apache-2.0
Requires-Python: >=3.9
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Documentation, https://github.com/Vivien83/hora-graph-core#python
Project-URL: Homepage, https://github.com/Vivien83/hora-graph-core
Project-URL: Repository, https://github.com/Vivien83/hora-graph-core

# hora-graph-core

Bio-inspired embedded knowledge graph engine for Python — powered by Rust via [PyO3](https://pyo3.rs) + [maturin](https://maturin.rs).

## Install

```bash
pip install hora-graph-core
```

## Quick start

```python
from hora_graph_core import HoraCore

graph = HoraCore()

# Add entities
alice = graph.add_entity("person", {"name": "Alice"})
bob = graph.add_entity("person", {"name": "Bob"})

# Add edge
graph.add_edge(alice, bob, "knows", {"since": 2024})

# Traverse
friends = graph.neighbors(alice, edge_type="knows")
```

## Features

- **Knowledge graph** — entities, edges, properties, bi-temporal versioning
- **Vector search** — SIMD-accelerated cosine similarity
- **BM25 full-text** — Okapi BM25+ ranking
- **Hybrid search** — RRF fusion of vector + text
- **Memory model** — ACT-R activation, spreading, FSRS scheduling
- **Consolidation** — SHY downscaling, interleaved replay, dream cycle
- **Storage** — embedded pages, SQLite, PostgreSQL

## Supported platforms

- Linux x86_64 / aarch64
- macOS x86_64 / arm64
- Windows x86_64

Python 3.9+

## License

MIT OR Apache-2.0

