Memoria

Local memory for long-running agents.

把零散上下文沉淀成可检索、可审计、可持续更新的工作记忆。

Memoria 是一个本地优先、由 LLM 驱动的工作记忆归档器。它把原始笔记、任务上下文、项目决策和 Agent 工作记录整理成 Memory Issue、Memory Chain、Proposal 和可审计的 Patch。

当前版本以 CLI 为主，数据默认保存在本机 SQLite 和 JSONL transcript 中；sleep 整理流程可以离线 mock，也可以调用 OpenAI Responses API。

安装

推荐使用 uv tool install。uv 会自动创建隔离环境，不绑定当前项目目录或 shell 里的虚拟环境：

uv tool install memoria-cli
memoria --help

也可以使用 pip；这种方式要求当前 Python 环境已经是 3.11 及以上：

python -m pip install memoria-cli
memoria --help

或者从 GitHub Releases 下载单文件二进制，不需要预装 Python。

快速开始

memoria ingest text "今天决定：Memoria MVP 先做本地 CLI，不做 Web UI。" \
  --title "Memoria MVP direction" \
  --tag memoria \
  --hint "整理成项目决策"

memoria sleep --mock
memoria issue list --json

使用真实 LLM 整理：

export OPENAI_API_KEY="..."
memoria sleep --limit 20 --strictness balanced

文档

完整文档入口见 docs/README.md。

特性

• Local-first storage with SQLite, JSONL transcripts, zip backups, and local Git backups.
• Raw text, file, and stdin ingestion.
• LLM sleep consolidation with deterministic mock mode and OpenAI mode.
• Tool-assisted memory lookup during LLM consolidation.
• Transactional MemoryPatch application with patch audit records.
• Query commands for Memory Issue, Chain, Proposal, Patch, and Sleep jobs.
• Optional single-file binaries for Linux, macOS, and Windows.

状态

Memoria is early alpha software. The current scope is intentionally narrow: local CLI first, no Web UI, no API server, no MCP server, no cloud sync, and no destructive memory deletion.

Memoria 仍处于 early alpha 阶段。当前范围刻意保持克制：本地 CLI 优先，没有 Web UI、API server、MCP server、云同步，也没有破坏性删除记忆。

开发

python -m pip install -e ".[dev]"
pytest -q
uv build

See Development or 开发者说明 for the full workflow.