chore: add pyproject.toml

pyproject.toml

@@ -0,0 +1,117 @@
+[build-system]
+requires = ["hatchling>=1.21.0"]
+build-backend = "hatchling.build"
+
+[project]
+name = "engram-kv"
+version = "1.0.0"
+description = "KV cache fingerprinting for persistent cross-session LLM memory. Fourier decomposition achieves 98% Recall@1 at 51µs."
+readme = "README.md"
+license = "Apache-2.0"
+requires-python = ">=3.11"
+authors = [{name = "ENIGMA"}]
+keywords = ["engram", "kv-cache", "llm", "inference", "fourier", "fingerprint", "retrieval", "hnsw", "cross-model", "session-memory"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+
+dependencies = [
+    # ── Serialization ─────────────────────────────────────────
+    "safetensors>=0.4.5,<0.5",
+
+    # ── Tensor operations ─────────────────────────────────────
+    "torch>=2.3.0,<3.0",
+    "numpy>=1.26.0,<2.0",
+    "einops>=0.7.0,<1.0",
+
+    # ── API server ────────────────────────────────────────────
+    "fastapi>=0.115.0,<1.0",
+    "uvicorn[standard]>=0.30.0,<1.0",
+    "pydantic>=2.7.0,<3.0",
+    "pydantic-settings>=2.3.0,<3.0",
+    "httpx>=0.27.0,<1.0",
+
+    # ── FAISS — MKL build only (pip, NOT conda-forge) ─────────
+    # conda-forge faiss-cpu lacks MKL → 18x slower (GitHub #2499)
+    # Install: pip install faiss-cpu
+    # Verify:  python -c "import faiss; assert faiss.get_compile_options().find('AVX') != -1"
+    "faiss-cpu>=1.8.0,<2.0",
+
+    # ── SVD / linear algebra for EGR state extraction ─────────
+    "scikit-learn>=1.4.0,<2.0",
+
+    # ── LLM runtime (D1: llama-cpp-python direct) ─────────────
+    "llama-cpp-python>=0.3.0,<1.0",
+
+    # ── Config ────────────────────────────────────────────────
+    "python-dotenv>=1.0.0,<2.0",
+]
+
+[project.optional-dependencies]
+# Phase 2: semantic search via external embeddings
+semantic = [
+    "qdrant-client>=1.9.0,<2.0",
+    "cohere>=5.5.0,<6.0",
+]
+# Phase 2: remote storage backends
+remote = [
+    "redis>=5.0.0,<6.0",
+    "boto3>=1.34.0,<2.0",
+]
+# Phase 2: TurboQuant PolarQuant Triton kernels (CUDA only)
+turboquant = [
+    "triton>=3.0.0,<4.0",
+]
+# Hyperbolic geometry (Phase 3)
+hyperbolic = [
+    "geoopt>=0.5.0,<1.0",
+]
+# Sentence-transformers embedder (default fallback when no GGUF model)
+sbert = [
+    "sentence-transformers>=2.7.0,<4.0",
+]
+# MCP server for Claude Code integration
+mcp = [
+    "mcp>=1.0.0,<2.0",
+]
+# Development
+dev = [
+    "pytest>=8.0.0,<9.0",
+    "pytest-asyncio>=0.23.0,<1.0",
+    "pytest-cov>=5.0.0,<6.0",
+    "ruff>=0.5.0,<1.0",
+    "mypy>=1.10.0,<2.0",
+]
+
+[project.scripts]
+engram-server = "kvcos.api.server:main"
+engram-demo = "scripts.demo_agent_session:main"
+
+[project.urls]
+Repository = "https://github.com/infraax/engram"
+Documentation = "https://github.com/infraax/engram#readme"
+
+[tool.hatch.build.targets.wheel]
+packages = ["kvcos"]
+
+[tool.ruff]
+target-version = "py311"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W", "UP"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+warn_return_any = true
+warn_unused_configs = true