memomate 0.4.6__py3-none-any.whl

memomate-0.4.6.dist-info/METADATA

@@ -0,0 +1,183 @@
+Metadata-Version: 2.4
+Name: memomate
+Version: 0.4.6
+Summary: 长时记忆系统（Long-Term Memory System）— 轻量级 RAG 引擎
+Author: MEMOS Team
+License: MIT
+Project-URL: Homepage, https://github.com/laofisher/memos
+Project-URL: Documentation, https://github.com/laofisher/memos
+Project-URL: Source, https://github.com/laofisher/memos
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: chromadb>=0.4.22
+Requires-Dist: sentence-transformers>=2.2.2
+Requires-Dist: mcp>=1.27.0
+Requires-Dist: rank-bm25>=0.2.2
+Requires-Dist: fastapi>=0.110
+Requires-Dist: uvicorn>=0.29
+Requires-Dist: requests>=2.31
+Requires-Dist: huggingface-hub>=0.20
+Provides-Extra: test
+Requires-Dist: pytest>=8.0; extra == "test"
+Dynamic: license-file
+
+# MEMOS — Active Memory System for AI Coding Assistants
+
+[![Python](https://img.shields.io/badge/Python-3.12+-blue)](https://www.python.org)
+[![License](https://img.shields.io/badge/License-MIT-green)](LICENSE)
+[![Version](https://img.shields.io/badge/version-0.4.6-lightgrey)](https://pypi.org/project/memomate/)
+
+> 📖 [中文文档](README.zh.md)
+
+**MEMOS** is a lightweight RAG engine designed for AI coding assistants. It provides **cross-session memory** — remembering technical decisions, bug fixes, user preferences, and code conventions from past conversations. Built on ChromaDB + bge-large-zh-v1.5 with a built-in MCP server.
+
+## Features
+
+- **🧠 Cross-Session Memory** — Captures knowledge from conversations, retrieves it across sessions
+- **🔌 MCP Server** — 11 tools for AI assistant integration (Claude Code, etc.)
+- **🔍 Hybrid Search** — Vector similarity (1024-dim) × BM25 keyword scoring, time-decay ranking
+- **📊 Web Dashboard** — Browse, search, manage memories; visual configuration editor
+- **🏗️ 4 Pipelines** — AI-suggested + direct-write + auto-harvest + manual curation
+- **🗂️ Multi-Project** — Scoped by working directory, contexts stay separate
+- **⚡ Lightweight** — Local-only, single process, no external services
+
+## Quick Start
+
+```bash
+pip install memomate
+memos init --force
+memos dashboard
+```
+
+Open http://127.0.0.1:8000
+
+> **Windows**: If model download stalls, set `$env:HF_ENDPOINT = "https://hf-mirror.com"` before `memos init`.
+
+### Claude Code Integration
+
+```bash
+memos hook install
+```
+
+This registers MEMOS as an MCP server. Claude Code will automatically read and write memories during conversations.
+
+## Why MEMOS?
+
+Existing memory solutions for AI coding assistants typically:
+
+- ❌ Store flat text without semantic search
+- ❌ Require external services (PostgreSQL, Redis, cloud APIs)
+- ❌ Lack cross-project isolation
+- ❌ Don't handle time-based memory decay
+
+MEMOS addresses these with a self-contained, local-first architecture designed specifically for the AI-assisted coding workflow.
+
+## Architecture
+
+```mermaid
+graph LR
+    subgraph AI Assistant
+        A[Claude Code]
+    end
+    subgraph MEMOS
+        B[MCP Server<br/>11 tools]
+        C[Engine<br/>Retrieval + Extraction]
+        D[Vector Store<br/>ChromaDB]
+        E[Embedding Model<br/>bge 1024-dim]
+        F[Web Dashboard<br/>FastAPI + Jinja2]
+        G[Hybrid Search<br/>BM25 + Vector]
+    end
+    A <-->|stdio JSON-RPC| B
+    B --> C
+    C --> D & E & G
+    F --> C
+```
+
+### Project Structure
+
+```
+memos/
+├── src/memos/
+│   ├── config/      Pydantic models, loading chain, prompts
+│   ├── storage/     Vector store abstraction (ChromaDB)
+│   ├── engine/      Core: memory CRUD, extraction, review, BM25
+│   ├── server/      MCP server (11 tools, FastMCP stdio)
+│   ├── web/         FastAPI + Jinja2 dashboard
+│   ├── cli/         argparse CLI (15+ commands)
+│   ├── features/    Backup, daily review, notifications, wizard
+│   └── hooks/       Claude Code hook scripts (prompt/stop)
+├── memdb/           ChromaDB persistent data
+├── model/           Local embedding models (~1.3GB)
+└── etc/             Configuration files + i18n locales
+```
+
+## MCP Tools (for AI Assistants)
+
+| Tool | Pipeline | Description |
+|------|----------|-------------|
+| `remember(text, metadata)` | A | Buffer → LLM extraction |
+| `save_knowledge(text, type)` | B | Direct write to store |
+| `recall(query, top_k, ...)` | — | Semantic + hybrid search |
+| `list_memories(type, limit)` | — | Paginate project memories |
+| `list_todos(status, limit)` | — | List pending action items |
+| `update_todo(id, status)` | — | Change todo status |
+| `delete_memory(memory_id)` | — | Delete by ID |
+| `update_memory(id, text, meta)` | — | Update content/metadata |
+| `force_extract()` | A | Trigger immediate extraction |
+| `set_project_id(pid)` | — | Switch project scope |
+| `log_complete_turn(user, asst)` | A | Log a conversation round |
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `init` | First-time setup wizard |
+| `dashboard` | Launch web UI |
+| `server` | Start MCP server (stdio) |
+| `status` | View system health |
+| `doctor` | Diagnose and troubleshoot |
+| `config show / set / validate` | Manage configuration |
+| `export` | Export memories to JSONL |
+| `import` | Import from JSONL |
+| `backup / restore` | Full database backup |
+| `hook install / uninstall / status` | Claude Code hook management |
+| `auth regen` | Regenerate dashboard token |
+| `vacuum` | Reclaim deleted document space |
+| `reindex` | Rebuild BM25 index |
+
+## Configuration
+
+All settings in `etc/config.json`. Key sections:
+
+```json
+{
+  "llm": {
+    "endpoints": [
+      {"name": "default", "api_base": "http://localhost:11434/v1"}
+    ],
+    "active": "default"
+  },
+  "model": {"name": "bge-large-zh-v1.5", "vector_dim": 1024},
+  "memory": {"decay_lambda": 0.02, "default_top_k": 5},
+  "suggestion": {"active_suggestion_threshold": 0.65}
+}
+```
+
+Override any field via `MEMOS_{SECTION}_{FIELD}` environment variables.
+
+## Requirements
+
+- Python 3.12+
+- ~2GB disk (bge-large-zh-v1.5 model ~1.3GB)
+- Windows / Linux / macOS
+
+## License
+
+MIT

memomate-0.4.6.dist-info/RECORD

@@ -0,0 +1,58 @@
+memomate-0.4.6.dist-info/licenses/LICENSE,sha256=WGUuJOcnKFZORM91S7avCpyVhWOapDbPyr4ggsSQDPI,1067
+memos/__init__.py,sha256=f0pcH2jbdgHZQCbAPFZ6tr5lzks8KqUWXZXqQ7jD_zE,1069
+memos/_version.py,sha256=QlYINYptvwKWC16uojxmWEY3Q-AWi0Lc26uPWkTxKyk,23
+memos/errors.py,sha256=lL5LbuoEFCBpnfaTfVAJiRfVSfCdyUndZMU4PFkCD4U,4596
+memos/i18n.py,sha256=56CUB9_YI6UQRsklmYYLzucOwK0wuIYNQKUdgOvo9i8,1719
+memos/cli/__init__.py,sha256=b_x_eTWtcl8HvNVqBLX4cIYeWByVq2xpN7nOTQb9WNY,114
+memos/cli/__main__.py,sha256=5Q3prNDw49vHg9OAfuxHvShkqD0csCQPnuqW6asy-S0,78
+memos/cli/dispatch.py,sha256=PiAxP_LttO-AIJ831eA0C4hJTSg_Lu6hhrsh-4FnNpo,42926
+memos/config/__init__.py,sha256=V-2T2YiEes81yGpEwZsQ81gVaQajdVGvrgiI1brPHF4,2316
+memos/config/loader.py,sha256=r3yXuTgwCGxRQ9ojUt7ylq7Ys1Fw4jNtHMh-PY40XLs,15711
+memos/config/models.py,sha256=4ZDIGCPX8h6o_SWcMnI1xjy2dZL3vuRNy4qgxasMrrU,27551
+memos/config/prompts.py,sha256=4esul4d2m1ezEJE4pzagn9PcJnOrYRgSSvwF7j7R_x4,22120
+memos/dashboard/__init__.py,sha256=9YRwrPwlchlGRqN5EjOQAAUGul4CPV43Lx1UVgIUJ7A,221
+memos/engine/__init__.py,sha256=pGgTLbeIELi326kh5j-0SflzrW7NOpaJeleHt4IM-Y8,895
+memos/engine/extractor.py,sha256=VMuPyYXanJNmXLFM9f819Mxmqgqx1nwkaMpXErfsE5s,36835
+memos/engine/memory.py,sha256=ykHTKFRlzqpGM4UUKXXJJn6BKyA8fVqtay7IgiGac7M,44767
+memos/engine/review.py,sha256=2tFyXZx_m4DxyiMSi2ze6nSsp_UkiiV1kE1f3SFsP1Y,31197
+memos/features/__init__.py,sha256=JLRU44u7U1Zdwzry8MTHSjqTbHdQHu54Rm2KaR0iLcw,1189
+memos/features/backup.py,sha256=UsbZJ_68c_yUsoN4DSXEb2krLQH0uobt9QubK_iuGgc,19018
+memos/features/notifications.py,sha256=X80XuMl_Hcpeg_xqMYMhdJHwZZCLu6gwP_KHLP2aqPE,7272
+memos/features/usage.py,sha256=4QDXF0C_Nc9JoPaXoVP2t048Nk24eMahnHeWAtn0SfY,9837
+memos/features/wizard.py,sha256=2TI3K9X8_X_sScy4wJWMnv4Rj8vwvEfUaegRnkD6K6M,16841
+memos/hooks/__init__.py,sha256=q0--LbIsrosI-AdLmyQZfHC6_2b7mq_6or5B_yTNF3U,249
+memos/hooks/prompt.py,sha256=TMUDPt70woWhfLU1bF16g31E_9gKe4lKExiWcAwyIpk,46320
+memos/hooks/stop.py,sha256=Ul2vDDqY9EwiKcJ3teM8VFj8z3IpMjA4gFHZPnuovsM,4203
+memos/server/__init__.py,sha256=memUFE-2qn5Or-r5MR8xzxSoaG7HSZyCZVe3avJF8IM,194
+memos/server/__main__.py,sha256=JgVIzb6A1oKF9EE1G-n1GeNTAsJSGyWmUnamj8qxe8o,490
+memos/server/mcp.py,sha256=4CsMaQbitwhrLg8MFf9tAlbDme4X93dygreUPt4p_Wc,20534
+memos/storage/__init__.py,sha256=HE4Xer73oR7StksvxPGDSmMwWhHgaA_Os8YhYAMdUHM,606
+memos/storage/base.py,sha256=Blmngdo8n2-uklqRLjTVUVIAueeJYVnLj_XZJxhhWq4,935
+memos/storage/chroma.py,sha256=WzEH-y8CVQGKBAiCT3ZmlHmTKvGoy-bYeCx6tKwJ80M,9417
+memos/storage/embeddings.py,sha256=1gYsHC0N6orlxce_v-mW9HsOLARxt2ZKfiFi8ZZvb0c,10584
+memos/web/__init__.py,sha256=VOkY7BA2Z0o0aZwalQtB2kqtGoKRhwJsw13CMiHDYP4,222
+memos/web/app.py,sha256=XhrHHCEXKZKwXbmYVujcv8YFc_LXGiyo9PnVj62kWa8,10282
+memos/web/auth.py,sha256=3dgjSdP-58V7P742hCV270qsev28g5LBg7mOLYJM00Q,2804
+memos/web/models/__init__.py,sha256=nCgYC6HCGfF1vtQGqghjmvEDmuuKW6fnjJ7DDYClUys,1571
+memos/web/models/requests.py,sha256=04-GW245ukwLG4nUkfe7akvYU1xJQjBub9msdQY_Fhw,8122
+memos/web/routes/__init__.py,sha256=Hnztwc-npB0qiVmoZU_DrS2AM9wuErOVXPf9ySXWhrU,826
+memos/web/routes/auth.py,sha256=obLcz9oYxhl4JW8fB8sDARZ7NXdtkYcU7GKTV51azv0,1553
+memos/web/routes/backups.py,sha256=Cvg_v02D_Ut-5MhuQzbEfoDYRqh3A8LHEcNz1UKY_n8,3600
+memos/web/routes/config_routes.py,sha256=8kg4HMwjuO5LMDoggwK_eC3LdIBH7I2td--fBm7Rd5g,3253
+memos/web/routes/conversations.py,sha256=3kSeQIhvpDfsUzfwj0V-f6tU6VG53bQsoyIwGXlpZE0,21588
+memos/web/routes/llm.py,sha256=4w8e-NydCi0uNXEkuwIoAWn4KwDZodCDk8FbU8TsKNI,4706
+memos/web/routes/memories.py,sha256=4QrOTUq30kKw8c3nAl1Y2xbZxipCK3afUrZ4QwDwezQ,20563
+memos/web/routes/notifications.py,sha256=Gc4LNUJpB1BaZncE7vMP7zFE1o8LYK5fTNIhKFheLuw,6029
+memos/web/routes/pages.py,sha256=8vW4Yxb6rjTpBnwzMFc0cG7LndYihXo8STWWZcq4YRs,2257
+memos/web/routes/prompts.py,sha256=0HY6mmYIkAmQ0sPTpGFbblMTVBb7R1dM-fKGkLyv5JA,13740
+memos/web/routes/search.py,sha256=PNcTWX51hT7xEgh4yAqQ3HhsvM7UkDWVS_OeQxraFaA,1400
+memos/web/routes/suggestions.py,sha256=6Ga185ZpH8o8Dpx_fQuo2JBm0FfGy9W1CC1Os1kEzzU,45487
+memos/web/routes/system.py,sha256=2Kt3UqHv7WadyJfPDfu8YdMZLslDHxN4m8pngbkth2s,18452
+memos/web/routes/todos.py,sha256=1dlVqkfE6pux-cPCfzEjIZRl5B7cp3-HKnCPG_vPQ38,13402
+memos/web/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+memos/web/services/helpers.py,sha256=1lRoDuc8M8Qfu79hMXzK2S1F7odYAV5HHnO_6gycp1M,8675
+memomate-0.4.6.dist-info/METADATA,sha256=rVt9jBv9Fqxr4XTJxNwSIRuZdwSvleYApvwyf4VIuwI,6590
+memomate-0.4.6.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+memomate-0.4.6.dist-info/entry_points.txt,sha256=K3maUnEB_VGbbUoOK1JlG3PkgB7ImT6u0sVuGATdyZk,41
+memomate-0.4.6.dist-info/top_level.txt,sha256=Zja3LUabhfiuQUP8L0kJQu9Ip5RjrOmHRp3dDoVvGd8,6
+memomate-0.4.6.dist-info/RECORD,,

memomate-0.4.6.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

memomate-0.4.6.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+memos = memos.cli:main

memomate-0.4.6.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MEMOS Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

memomate-0.4.6.dist-info/top_level.txt

@@ -0,0 +1 @@
+memos

memos/__init__.py

@@ -0,0 +1,38 @@
+from memos._version import __version__
+from memos.engine.extractor import MemoryExtractor, _estimate_tokens, format_conversation
+from memos.engine.memory import DEFAULT_DECAY_LAMBDA, SIMILARITY_THRESHOLD, ContextMemory
+
+# dashboard → web 迁移（向后兼容）
+from memos.web import app, main
+
+
+def __getattr__(name: str):
+    """惰性加载 server 模块，避免未安装 pywin32 时导入失败。"""
+    if name == "mcp":
+        from memos.server.mcp import mcp as _mcp
+
+        return _mcp
+    if name == "_detect_project_id":
+        from memos.server.mcp import _detect_project_id as _fn
+
+        return _fn
+    raise AttributeError(f"module 'memos' has no attribute {name!r}")
+
+
+# 向后兼容别名（v0.4.2 改名，v0.5.0 移除）
+LongTermMemory = ContextMemory
+
+__all__ = [
+    "__version__",
+    "ContextMemory",
+    "LongTermMemory",  # 向后兼容别名
+    "SIMILARITY_THRESHOLD",
+    "DEFAULT_DECAY_LAMBDA",
+    "MemoryExtractor",
+    "format_conversation",
+    "_estimate_tokens",
+    "mcp",
+    "_detect_project_id",
+    "app",
+    "main",
+]

memos/_version.py

@@ -0,0 +1 @@
+__version__ = "0.4.6"

memos/cli/__init__.py

@@ -0,0 +1,8 @@
+"""MEMOS CLI 层。
+
+v0.4.3 架构重整 Phase 10。
+"""
+
+from memos.cli.dispatch import main
+
+__all__ = ["main"]

memos/cli/__main__.py

@@ -0,0 +1,5 @@
+"""python -m memos.cli 入口"""
+
+from memos.cli.dispatch import main
+
+main()