pyproject.toml

[build-system]
requires = ["setuptools>=77.0", "wheel"]
build-backend = "setuptools.build_meta"

[project]
name = "engraphis"
version = "0.9.6"
description = "Local-first AI memory engine for agents — Ebbinghaus decay, interaction-aware recall, bi-temporal facts, hybrid retrieval, and an MCP server. You bring the LLM."
readme = "README.md"
license = "Apache-2.0"
license-files = ["LICENSE", "NOTICE"]
requires-python = ">=3.9"
authors = [{ name = "The Engraphis Authors" }]
keywords = ["ai", "agents", "memory", "mcp", "rag", "vector-search", "llm", "retrieval"]
classifiers = [
    "Development Status :: 4 - Beta",
    "Intended Audience :: Developers",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3.9",
    "Programming Language :: Python :: 3.10",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
    "Topic :: Scientific/Engineering :: Artificial Intelligence",
    "Topic :: Software Development :: Libraries",
]
dependencies = [
    "numpy>=1.24",
]

[project.optional-dependencies]
# The REST server + real embeddings (the full self-hosted stack).
server = [
    "fastapi>=0.110",
    "uvicorn[standard]>=0.29",
    "httpx>=0.25",
    "pydantic>=2.0",
    "python-dotenv>=1.0",
    "sentence-transformers>=2.7",
]
# The MCP server — plug Engraphis into Claude Code, Cursor, Cline, Zed, etc.
# The upstream MCP SDK requires Python 3.10+; the numpy-only core remains Python 3.9.
mcp = [
    "mcp>=1.2.0; python_version >= '3.10'",
    "pydantic>=2.0",
    "sentence-transformers>=2.7",
]
# Code-symbol graph indexing. Optional: index_repo()/search_code()
# fall back to a dependency-free regex indexer without this — see backends/codegraph.py.
code = [
    "tree-sitter>=0.23",
    "tree-sitter-language-pack>=0.2",
]
# Local resource extraction. Text/code/HTML/DOCX remain stdlib-only; this adds PDF
# extraction and image OCR bindings (the Tesseract executable is installed separately).
documents = [
    "pypdf>=4.0",
    "Pillow>=10.0",
    "pytesseract>=0.3.10",
]
transcription = [
    "faster-whisper>=1.0",
    # onnxruntime 1.24+ dropped CPython 3.10 wheels; keep the advertised 3.10
    # install path resolvable while faster-whisper still supports it.
    "onnxruntime<1.24; python_version < '3.11'",
]
postgres = [
    "psycopg[binary]>=3.1",
]
# Encryption at rest for the memory database (SQLCipher / AES-256). Opt-in: set
# ENGRAPHIS_DB_KEY (or ENGRAPHIS_DB_KEY_FILE). Without this the DB is plaintext.
encryption = [
    "sqlcipher3-binary>=0.5.0",
]
# Everything available on the current platform, for a full self-hosted install.
# sqlcipher3-binary currently publishes Linux wheels only; Windows users can still
# install ``all`` and add a separately provisioned SQLCipher driver if desired.
all = [
    "fastapi>=0.110",
    "uvicorn[standard]>=0.29",
    "httpx>=0.25",
    "pydantic>=2.0",
    "python-dotenv>=1.0",
    "sentence-transformers>=2.7",
    "mcp>=1.2.0; python_version >= '3.10'",
    "tree-sitter>=0.23",
    "tree-sitter-language-pack>=0.2",
    "pypdf>=4.0",
    "Pillow>=10.0",
    "pytesseract>=0.3.10",
    "faster-whisper>=1.0",
    "onnxruntime<1.24; python_version < '3.11'",
    "psycopg[binary]>=3.1",
    "sqlcipher3-binary>=0.5.0; platform_system != 'Windows'",
]
dev = ["pytest>=8.0", "pytest-asyncio>=0.23", "ruff>=0.4"]
# Everything needed to run the FULL offline gate in CI (lint + all extras-gated tests)
# WITHOUT pulling torch/sentence-transformers — no test needs the real embedder.
test = [
    "pytest>=8.0",
    "pytest-asyncio>=0.23",
    "ruff>=0.4",
    "fastapi>=0.110",
    "httpx>=0.25",
    "mcp>=1.2.0; python_version >= '3.10'",
    "tree-sitter>=0.23",
    "tree-sitter-language-pack>=0.2",
    "pypdf>=4.0",
    "Pillow>=10.0",
    "pytesseract>=0.3.10",
    "faster-whisper>=1.0",
    "onnxruntime<1.24; python_version < '3.11'",
    "psycopg[binary]>=3.1",
    "sqlcipher3-binary>=0.5.0; platform_system != 'Windows'",
]

[project.urls]
Homepage = "https://github.com/Coding-Dev-Tools/engraphis"
Repository = "https://github.com/Coding-Dev-Tools/engraphis"
Issues = "https://github.com/Coding-Dev-Tools/engraphis/issues"

[project.scripts]
engraphis-server = "scripts.start_server:main"
engraphis-cli = "scripts.cli:main"
engraphis-mcp = "engraphis.mcp_server:main"
engraphis-inspector = "scripts.inspector:main"
engraphis-dashboard = "scripts.start_dashboard:main"
engraphis-consolidate = "scripts.consolidate:main"
engraphis-graph = "scripts.graph_cli:main"
engraphis-graph-server = "scripts.graph_server:main"
engraphis-init = "scripts.init:main"
engraphis-update = "scripts.update:main"

[tool.setuptools]
include-package-data = false

[tool.setuptools.packages.find]
include = ["engraphis*", "scripts*"]

[tool.setuptools.package-data]
"engraphis.inspector" = ["index.html"]
# Keep the shipped dashboard assets explicit. A recursive catch-all also packages ignored
# runtime artifacts such as static/__pycache__/*.pyc after a local compile check.
# vendor/**/* covers nested vendor assets too (vendor/* alone doesn't cross "/").
"engraphis.static" = ["*.html", "*.png", "*.ico", "vendor/*", "vendor/**/*"]

[tool.setuptools.exclude-package-data]
"*" = ["*.pyc", "*.pyo", "__pycache__/*"]

[tool.ruff]
line-length = 100
target-version = "py39"

[tool.pytest.ini_options]
testpaths = ["tests"]
addopts = "-q"
filterwarnings = [
    # Third-party (Starlette's TestClient), not our code and not fixable without a
    # dependency bump — silence just this one message so the suite output stays clean.
    "ignore:Using `httpx` with `starlette.testclient` is deprecated",
]