Metadata-Version: 2.4
Name: nexor-mneme
Version: 0.1.14
Summary: Open memory engine + code intelligence for AI agents
Project-URL: Homepage, https://github.com/nexorhq/nexor-mneme
Project-URL: Repository, https://github.com/nexorhq/nexor-mneme
Author: Giovanni Consiglio
License-Expression: MIT
Keywords: ai-agents,code-intelligence,knowledge-graph,memory,nexor,rag,scip
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.12
Requires-Dist: asyncpg>=0.29
Requires-Dist: httpx>=0.27
Requires-Dist: nexor-core>=0.1.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: qdrant-client>=1.7
Requires-Dist: redis>=5.0
Provides-Extra: codegraph
Requires-Dist: tree-sitter-languages>=1.10; extra == 'codegraph'
Requires-Dist: tree-sitter<0.22,>=0.21; extra == 'codegraph'
Provides-Extra: hybrid
Requires-Dist: flagembedding>=1.2; extra == 'hybrid'
Provides-Extra: mcp
Requires-Dist: httpx>=0.27; extra == 'mcp'
Requires-Dist: mcp>=1.2; extra == 'mcp'
Provides-Extra: scip
Requires-Dist: protobuf>=5; extra == 'scip'
Provides-Extra: server
Requires-Dist: fastapi>=0.110; extra == 'server'
Requires-Dist: uvicorn>=0.30; extra == 'server'
Description-Content-Type: text/markdown

# nexor-mneme

> Persistent memory + code-intelligence for AI agents — a knowledge layer you self-host.

`nexor-mneme` is the open memory engine of the [Nexor](https://github.com/nexorhq) project
(*mneme*, μνήμη — "memory"). It gives agents long-term semantic memory **and** a queryable
structural map of your codebase, so they answer *"what did we decide"* and *"what calls this
function / what's the blast radius"* without re-reading everything.

Dependency-light core; heavier capabilities are optional extras. Run it standalone — **no
dependency on anyone's personal orchestrator or daemon**.

## What's inside

- **Semantic memory** — hybrid (dense+sparse) retrieval over Qdrant, cross-encoder reranking,
  forgetting, contradiction & entity resolution, auto-profile.
- **Progressive layering (L0→L3)** — a semantic pyramid with provenance + deterministic
  drill-down from an abstraction to its evidence.
- **Code structure graph** — multi-language (Python via stdlib `ast`; JS/TS/Go via tree-sitter),
  precise resolution via **SCIP** ingest, blast-radius queries, PageRank repo-map, community
  detection, incremental cache — landed in Apache AGE.
- **Symbolic task memory** — Mermaid task canvases with offload-by-reference.
- **Obsidian export** — a human-browsable, interlinked vault of the whole graph.
- **Standalone service** — a FastAPI server + docker-compose (`server` extra).

## Install

```bash
pip install nexor-mneme                 # core memory + code graph (Python)
pip install "nexor-mneme[codegraph]"    # + tree-sitter (JS/TS/Go)
pip install "nexor-mneme[scip]"         # + SCIP precise resolution
pip install "nexor-mneme[server]"       # + FastAPI standalone service
```

## Run your own instance

```bash
git clone https://github.com/nexorhq/nexor-mneme && cd nexor-mneme/deploy
docker compose up -d                    # API on http://localhost:8200
curl http://localhost:8200/health
```

See the [deploy guide](https://github.com/nexorhq/nexor-mneme/blob/main/deploy/README.md).

## License

MIT — see [LICENSE](https://github.com/nexorhq/nexor-mneme/blob/main/LICENSE).
