Engram-protocol/engram

1[build-system]2requires = ["hatchling>=1.21.0"]3build-backend = "hatchling.build"4 5[project]6name = "engram-kv"7version = "1.0.0"8description = "KV cache fingerprinting for persistent cross-session LLM memory. Fourier decomposition achieves 98% Recall@1 at 51µs."9readme = "README.md"10license = "Apache-2.0"11requires-python = ">=3.11"12authors = [{name = "ENIGMA"}]13keywords = ["engram", "kv-cache", "llm", "inference", "fourier", "fingerprint", "retrieval", "hnsw", "cross-model", "session-memory"]14classifiers = [15    "Development Status :: 3 - Alpha",16    "Intended Audience :: Developers",17    "License :: OSI Approved :: Apache Software License",18    "Programming Language :: Python :: 3.11",19    "Programming Language :: Python :: 3.12",20    "Topic :: Scientific/Engineering :: Artificial Intelligence",21]22 23dependencies = [24    # ── Serialization ─────────────────────────────────────────25    "safetensors>=0.4.5,<0.5",26 27    # ── Tensor operations ─────────────────────────────────────28    "torch>=2.3.0,<3.0",29    "numpy>=1.26.0,<2.0",30    "einops>=0.7.0,<1.0",31 32    # ── API server ────────────────────────────────────────────33    "fastapi>=0.115.0,<1.0",34    "uvicorn[standard]>=0.30.0,<1.0",35    "pydantic>=2.7.0,<3.0",36    "pydantic-settings>=2.3.0,<3.0",37    "httpx>=0.27.0,<1.0",38 39    # ── FAISS — MKL build only (pip, NOT conda-forge) ─────────40    # conda-forge faiss-cpu lacks MKL → 18x slower (GitHub #2499)41    # Install: pip install faiss-cpu42    # Verify:  python -c "import faiss; assert faiss.get_compile_options().find('AVX') != -1"43    "faiss-cpu>=1.8.0,<2.0",44 45    # ── SVD / linear algebra for EGR state extraction ─────────46    "scikit-learn>=1.4.0,<2.0",47 48    # ── LLM runtime (D1: llama-cpp-python direct) ─────────────49    "llama-cpp-python>=0.3.0,<1.0",50 51    # ── Config ────────────────────────────────────────────────52    "python-dotenv>=1.0.0,<2.0",53]54 55[project.optional-dependencies]56# Phase 2: semantic search via external embeddings57semantic = [58    "qdrant-client>=1.9.0,<2.0",59    "cohere>=5.5.0,<6.0",60]61# Phase 2: remote storage backends62remote = [63    "redis>=5.0.0,<6.0",64    "boto3>=1.34.0,<2.0",65]66# Phase 2: TurboQuant PolarQuant Triton kernels (CUDA only)67turboquant = [68    "triton>=3.0.0,<4.0",69]70# Hyperbolic geometry (Phase 3)71hyperbolic = [72    "geoopt>=0.5.0,<1.0",73]74# Sentence-transformers embedder (default fallback when no GGUF model)75sbert = [76    "sentence-transformers>=2.7.0,<4.0",77]78# MCP server for Claude Code integration79mcp = [80    "mcp>=1.0.0,<2.0",81]82# Development83dev = [84    "pytest>=8.0.0,<9.0",85    "pytest-asyncio>=0.23.0,<1.0",86    "pytest-cov>=5.0.0,<6.0",87    "ruff>=0.5.0,<1.0",88    "mypy>=1.10.0,<2.0",89]90 91[project.scripts]92engram-server = "kvcos.api.server:main"93engram-demo = "scripts.demo_agent_session:main"94 95[project.urls]96Repository = "https://github.com/infraax/engram"97Documentation = "https://github.com/infraax/engram#readme"98 99[tool.hatch.build.targets.wheel]100packages = ["kvcos"]101 102[tool.ruff]103target-version = "py311"104line-length = 100105 106[tool.ruff.lint]107select = ["E", "F", "I", "N", "W", "UP"]108 109[tool.pytest.ini_options]110testpaths = ["tests"]111asyncio_mode = "auto"112 113[tool.mypy]114python_version = "3.11"115strict = true116warn_return_any = true117warn_unused_configs = true118