memomate 0.4.6__tar.gz

memomate-0.4.6/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/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,153 @@
+# 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/pyproject.toml

@@ -0,0 +1,68 @@
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "memomate"
+version = "0.4.6"
+description = "长时记忆系统（Long-Term Memory System）— 轻量级 RAG 引擎"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.12"
+authors = [
+    {name = "MEMOS Team"},
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "chromadb>=0.4.22",
+    "sentence-transformers>=2.2.2",
+    "mcp>=1.27.0",
+    "rank-bm25>=0.2.2",
+    "fastapi>=0.110",
+    "uvicorn>=0.29",
+    "requests>=2.31",
+    "huggingface-hub>=0.20",
+]
+
+[project.urls]
+Homepage = "https://github.com/laofisher/memos"
+Documentation = "https://github.com/laofisher/memos"
+Source = "https://github.com/laofisher/memos"
+
+[project.scripts]
+memos = "memos.cli:main"
+
+[project.optional-dependencies]
+test = [
+    "pytest>=8.0",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+memos = ["templates/*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+target-version = "py312"
+line-length = 120
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W"]
+ignore = ["E501"]  # 允许行超长
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = ["N802", "N803", "N806"]
+
+[tool.ruff.format]
+quote-style = "double"

memomate-0.4.6/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

memomate-0.4.6/src/memomate.egg-info/PKG-INFO

@@ -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