mem01-engine 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (63) hide show
  1. mem01_engine-0.1.0/.env.example +18 -0
  2. mem01_engine-0.1.0/.gitignore +15 -0
  3. mem01_engine-0.1.0/Dockerfile +18 -0
  4. mem01_engine-0.1.0/IMPLEMENTATION_PLAN.md +753 -0
  5. mem01_engine-0.1.0/LICENSE +21 -0
  6. mem01_engine-0.1.0/PKG-INFO +352 -0
  7. mem01_engine-0.1.0/PRODUCT.md +379 -0
  8. mem01_engine-0.1.0/README.md +297 -0
  9. mem01_engine-0.1.0/docker-compose.yml +48 -0
  10. mem01_engine-0.1.0/examples/basic_usage.py +214 -0
  11. mem01_engine-0.1.0/pyproject.toml +56 -0
  12. mem01_engine-0.1.0/src/mem01/__init__.py +51 -0
  13. mem01_engine-0.1.0/src/mem01/api/__init__.py +1 -0
  14. mem01_engine-0.1.0/src/mem01/api/app.py +247 -0
  15. mem01_engine-0.1.0/src/mem01/client.py +240 -0
  16. mem01_engine-0.1.0/src/mem01/embeddings/__init__.py +7 -0
  17. mem01_engine-0.1.0/src/mem01/embeddings/base.py +22 -0
  18. mem01_engine-0.1.0/src/mem01/embeddings/fake.py +40 -0
  19. mem01_engine-0.1.0/src/mem01/embeddings/openai_embedder.py +83 -0
  20. mem01_engine-0.1.0/src/mem01/env.py +52 -0
  21. mem01_engine-0.1.0/src/mem01/ids.py +15 -0
  22. mem01_engine-0.1.0/src/mem01/llm/__init__.py +10 -0
  23. mem01_engine-0.1.0/src/mem01/llm/anthropic.py +93 -0
  24. mem01_engine-0.1.0/src/mem01/llm/base.py +30 -0
  25. mem01_engine-0.1.0/src/mem01/llm/fake.py +35 -0
  26. mem01_engine-0.1.0/src/mem01/llm/openai_compat.py +83 -0
  27. mem01_engine-0.1.0/src/mem01/metrics.py +42 -0
  28. mem01_engine-0.1.0/src/mem01/read/__init__.py +15 -0
  29. mem01_engine-0.1.0/src/mem01/read/conflict.py +85 -0
  30. mem01_engine-0.1.0/src/mem01/read/pack.py +73 -0
  31. mem01_engine-0.1.0/src/mem01/read/rank.py +100 -0
  32. mem01_engine-0.1.0/src/mem01/read/recall.py +83 -0
  33. mem01_engine-0.1.0/src/mem01/read/search.py +127 -0
  34. mem01_engine-0.1.0/src/mem01/runtime.py +102 -0
  35. mem01_engine-0.1.0/src/mem01/store/__init__.py +20 -0
  36. mem01_engine-0.1.0/src/mem01/store/base.py +95 -0
  37. mem01_engine-0.1.0/src/mem01/store/factory.py +68 -0
  38. mem01_engine-0.1.0/src/mem01/store/memory_store.py +211 -0
  39. mem01_engine-0.1.0/src/mem01/store/postgres_store.py +511 -0
  40. mem01_engine-0.1.0/src/mem01/tokens.py +19 -0
  41. mem01_engine-0.1.0/src/mem01/types.py +234 -0
  42. mem01_engine-0.1.0/src/mem01/write/__init__.py +6 -0
  43. mem01_engine-0.1.0/src/mem01/write/apply_ops.py +356 -0
  44. mem01_engine-0.1.0/src/mem01/write/extractor.py +171 -0
  45. mem01_engine-0.1.0/tests/conftest.py +23 -0
  46. mem01_engine-0.1.0/tests/test_api.py +168 -0
  47. mem01_engine-0.1.0/tests/test_apply_ops.py +315 -0
  48. mem01_engine-0.1.0/tests/test_client.py +251 -0
  49. mem01_engine-0.1.0/tests/test_configuration_docs.py +36 -0
  50. mem01_engine-0.1.0/tests/test_conflict.py +96 -0
  51. mem01_engine-0.1.0/tests/test_conflict_suite.py +180 -0
  52. mem01_engine-0.1.0/tests/test_extractor.py +209 -0
  53. mem01_engine-0.1.0/tests/test_factory.py +26 -0
  54. mem01_engine-0.1.0/tests/test_llm_adapters_unit.py +59 -0
  55. mem01_engine-0.1.0/tests/test_memory_store.py +228 -0
  56. mem01_engine-0.1.0/tests/test_multi_signal.py +142 -0
  57. mem01_engine-0.1.0/tests/test_postgres_store.py +502 -0
  58. mem01_engine-0.1.0/tests/test_rank_pack.py +79 -0
  59. mem01_engine-0.1.0/tests/test_recall.py +131 -0
  60. mem01_engine-0.1.0/tests/test_runtime.py +148 -0
  61. mem01_engine-0.1.0/tests/test_scaffold.py +17 -0
  62. mem01_engine-0.1.0/tests/test_search.py +149 -0
  63. mem01_engine-0.1.0/tests/test_types.py +151 -0
@@ -0,0 +1,18 @@
1
+ # Copy to .env (never commit .env)
2
+ # cp .env.example .env
3
+
4
+ # Required for real extract+embed
5
+ OPENAI_API_KEY=sk-your-key-here
6
+
7
+ # Postgres + pgvector (required for real runs — same in docker compose)
8
+ # Host machine talking to compose Postgres:
9
+ DATABASE_URL=postgresql://mem01:mem01@localhost:5433/mem01
10
+ #
11
+ # Neon (hosted Postgres + pgvector) — same app code:
12
+ # DATABASE_URL=postgresql://user:pass@ep-xxx.neon.tech/neondb?sslmode=require
13
+
14
+ MEM01_EMBEDDING_DIM=1536
15
+ # Extraction model used by the mem01 API and embedded Mem01Session runtime.
16
+ MEM01_LLM_MODEL=gpt-5.6-sol
17
+ MEM01_EMBEDDING_MODEL=text-embedding-3-small
18
+ # Unit tests only (no Postgres): MEM01_STORE=memory
@@ -0,0 +1,15 @@
1
+ .venv/
2
+ __pycache__/
3
+ *.py[cod]
4
+ *.egg-info/
5
+ .eggs/
6
+ dist/
7
+ build/
8
+ .pytest_cache/
9
+ .mypy_cache/
10
+ .ruff_cache/
11
+ *.db
12
+ .DS_Store
13
+ .env
14
+ .env.*
15
+ !.env.example
@@ -0,0 +1,18 @@
1
+ FROM python:3.12-slim
2
+
3
+ WORKDIR /app
4
+
5
+ RUN apt-get update && apt-get install -y --no-install-recommends \
6
+ curl \
7
+ && rm -rf /var/lib/apt/lists/*
8
+
9
+ COPY pyproject.toml README.md ./
10
+ COPY src ./src
11
+
12
+ RUN pip install --no-cache-dir -e ".[openai]"
13
+
14
+ ENV PYTHONUNBUFFERED=1
15
+ EXPOSE 8080
16
+
17
+ # Wait for postgres then start API (compose healthcheck also gates start)
18
+ CMD ["uvicorn", "mem01.api.app:app", "--host", "0.0.0.0", "--port", "8080"]