EchoMe
让每个 AI，都能接住你的过去。
Switch AI, not yourself.
是什么
EchoMe 是一个跨 AI 的个人上下文同步层。它把你的工作流规范、技术偏好、项目背景和协作习惯统一管理，让你在 Claude Code、Codex CLI、Cursor、Kiro 等任何 AI 工具之间切换时，不需要重复介绍自己。
核心架构
┌────────────────┐ ┌────────────────┐ ┌────────────────┐
│ Claude Code │ │ Codex CLI │ │ Cursor/Kiro │
│ (MCP Client) │ │ (MCP Client) │ │ (MCP Client) │
└───────┬────────┘ └───────┬────────┘ └───────┬────────┘
│ │ │
└──────────────────────┼──────────────────────┘
│ MCP Protocol
▼
┌──────────────────────────────────────────────┐
│ EchoMe MCP Server (本地) │
└──────────────────────┬───────────────────────┘
│ HTTPS
▼
┌──────────────────────────────────────────────┐
│ EchoMe Hub (你的服务器) │
│ FastAPI + PostgreSQL + pgvector │
└──────────────────────────────────────────────┘
三层注入策略
| Layer | 何时生效 | 方式 | 限制 |
|---|---|---|---|
| L0 | 每次对话 | 写入 ~/.claude/CLAUDE.md | ≤ 1500 tokens |
| L1 | 进入项目 | 项目级文件 | ≤ 2000 tokens |
| L2 | AI 按需查 | MCP search | 无限制 |
检索思想
EchoMe 不把所有记忆一次性塞进上下文，而是采用 summary-first：AI 先通过 echome_search_summary 获取候选记忆摘要，再用 echome_get_memories 按 UUID 精读取少量相关全文。这样在项目记忆变多后，仍能先看全局索引，再精准加载需要的记忆，避免 top_k 搜索长期只命中早期记忆或把上下文弄乱。
详见 记忆检索设计。
组件
| 组件 | 说明 | 位置 |
|---|---|---|
| Hub | FastAPI 服务端，存储和检索记忆 | hub/ |
| CLI | echome 命令行工具，管理和同步 |
echome/ |
| MCP Server | 向 AI 暴露查询/写入能力 | echome_mcp/ |
安装
方式一：PyPI 安装（推荐）
# 完整安装（CLI + MCP Server）- 默认包含 MCP
pip install echome
# 升级到最新版本
pip install echome --upgrade
方式二：GitHub 安装
# 完整安装
pip install "echome @ git+https://github.com/qzhqzh/EchoMe.git"
快速开始
1. 部署 Hub
git clone https://github.com/qzhqzh/EchoMe.git
cd EchoMe
cp hub/.env.example hub/.env # 配置数据库和 token
docker compose up -d # 启动 Postgres + Redis + Hub
2. 初始化 CLI
echome init # 连接 Hub + 注册 MCP（交互式）
3. 添加记忆
echome add # 交互式添加
echome list # 查看所有记忆
echome search "PR 规范" # 搜索
4. 注入到 AI CLI
cd your-project
echome sync # 自动检测 + 渲染到 CLAUDE.md / AGENTS.md
之后 AI 就能通过 MCP 随时查询你的记忆了。
记忆模型
每条记忆有三个核心维度：
- Type：identity / guardrail / reasoning / method / stack / style / decision / context / template / project
- Scope：global（跟人走）或 project-specific（跟项目走）
- Layer：L0（必须加载）/ L1（项目级加载）/ L2（按需搜索）
文档
技术栈
- Python 3.11+ / FastAPI / SQLAlchemy 2.0 / Alembic
- PostgreSQL 16 + pgvector
- Typer + Rich (CLI)
- mcp (official Python SDK)
- Docker Compose
- uv (包管理)
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file echome-1.5.0.tar.gz.
File metadata
- Download URL: echome-1.5.0.tar.gz
- Upload date:
- Size: 16.7 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c0605f7c44243b2624ce4027ec5de9a1bfe7db128c5db68e7660bb1e8ba11e59
|
|
| MD5 |
a2cca7201f4d9d021130eae195315d09
|
|
| BLAKE2b-256 |
90ee408feb8043075cf0b5fe3ccb825b1031f71bf0c35136644a1c0947bfc65e
|
Provenance
The following attestation bundles were made for echome-1.5.0.tar.gz:
Publisher:
publish.yml on qzhqzh/EchoMe
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
echome-1.5.0.tar.gz -
Subject digest:
c0605f7c44243b2624ce4027ec5de9a1bfe7db128c5db68e7660bb1e8ba11e59 - Sigstore transparency entry: 2448319207
- Sigstore integration time:
-
Permalink:
qzhqzh/EchoMe@d71843841cc6374269dc5dbb43a12048f2c254d1 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/qzhqzh
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@d71843841cc6374269dc5dbb43a12048f2c254d1 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file echome-1.5.0-py3-none-any.whl.
File metadata
- Download URL: echome-1.5.0-py3-none-any.whl
- Upload date:
- Size: 74.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cac78d77a8d04274e0a0480c92388f2a4cd1da1b15fb82f8d34a88097d394adb
|
|
| MD5 |
1a41eefc2e4ecec3f2009715f49c6e77
|
|
| BLAKE2b-256 |
4e71e2a0858b6028f410dcda140fae1d664cd151ca743cba38d384384f8e1f00
|
Provenance
The following attestation bundles were made for echome-1.5.0-py3-none-any.whl:
Publisher:
publish.yml on qzhqzh/EchoMe
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
echome-1.5.0-py3-none-any.whl -
Subject digest:
cac78d77a8d04274e0a0480c92388f2a4cd1da1b15fb82f8d34a88097d394adb - Sigstore transparency entry: 2448319434
- Sigstore integration time:
-
Permalink:
qzhqzh/EchoMe@d71843841cc6374269dc5dbb43a12048f2c254d1 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/qzhqzh
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@d71843841cc6374269dc5dbb43a12048f2c254d1 -
Trigger Event:
workflow_dispatch
-
Statement type:
