什么是 Echo Agent
Echo Agent 是一个可自托管的长期运行 AI Agent。与一次性问答不同，它能：
- 跨会话记忆 — 四层认知记忆结构，自动衰减与矛盾检测，解决长期运行下的记忆膨胀问题，对话不再从零开始
- 自进化技能 — 从真实执行轨迹中生成候选改进，经评测验证后才生效，支持回滚
- 多入口归一 — CLI、Gateway、Webhook、Cron 及 Telegram / Discord / Slack / 微信 / 飞书 / 钉钉等 12 个通道共享同一份状态
- 安全可控 — 高风险工具调用经统一审批，凭证加密存储，执行日志可审计
一句话：让 Agent 带着记忆和不断进化的技能，长期为你工作。
快速开始
环境要求：Python 3.11+，至少一个模型 API Key。
# 安装
pip install "echo-agent[all]"
# 配置模型 API Key（任选其一）
export OPENAI_API_KEY="sk-..."
# 也支持 ANTHROPIC_API_KEY / GOOGLE_API_KEY / OPENROUTER_API_KEY，
# 以及 AWS Bedrock（使用标准 AWS 凭证）
# 交互式配置向导（数据默认存放在 ~/.echo-agent）
echo-agent setup
# 启动
echo-agent run
完整配置项见
docs/config-reference.md（全部有效配置的说明、类型、默认值与可选值）。也可用echo-agent config explain <配置项>查看单项说明、echo-agent config dump查看当前生效配置（密钥自动脱敏）、echo-agent config validate校验配置文件。
国内镜像 / Windows / 一键脚本
# 阿里云镜像加速
pip install "echo-agent[all]" -i https://mirrors.aliyun.com/pypi/simple/
# Windows（PowerShell）
pip install "echo-agent[all]"
$env:OPENAI_API_KEY = "sk-..."
echo-agent setup
echo-agent run
# 一键安装脚本（仅支持 Linux / macOS / WSL2，会从源码安装到 ~/.echo-agent
# 并可注册 systemd 服务；建议先审查脚本内容再执行）
curl -fsSL -o install.sh https://raw.githubusercontent.com/fuyuxiang/echo-agent/master/scripts/install.sh
less install.sh && bash install.sh
架构总览
核心能力
| 模块 | 说明 |
|---|---|
| Agent Loop | 接收事件 → 构建上下文 → 调用模型 → 执行工具，跨入口共享同一条执行路径 |
| 认知记忆 | Working / Episodic / Semantic / Archival 四层，配合衰减、矛盾检测与重要性重排 |
| 混合检索 | BM25 + FAISS 向量融合召回，按查询特征自适应权重，FAISS 缺失时自动降级 |
| 自进化引擎 | 轨迹记录 → 候选生成 → 评测对照 → 晋升/驳回，支持冷却期与一键回滚 |
| 模型路由 | 主推理、上下文压缩、向量嵌入、风险审批可独立配置 provider 与模型 |
| 工具审批 | 三档策略 manual / smart / off，无人值守通道默认拒绝高风险调用 |
| 跨进程互操作 | A2A JSON-RPC + MCP 客户端（含 OAuth），支持动态工具注册 |
| 本地优先 | 会话、记忆、轨迹、凭证默认存放工作区，凭证加密落盘 |
适用场景
- Agent 跑在本机或自有服务器，需要完整审计与可追溯
- 对话、偏好与任务经验需要跨会话长期沉淀
- 希望 Agent 技能从真实使用中持续改进，而非出厂定型
- 多入口（CLI、Webhook、消息机器人）需共享同一份记忆与权限
- 高风险工具需要强制审批，避免误操作
- 需同时接入多家模型 provider，按任务类型分配
开发与贡献
从源码安装（开发模式）：
git clone https://github.com/fuyuxiang/echo-agent.git # 国内可用 https://gitee.com/fuyuxiang/echo-agent.git
cd echo-agent
uv venv venv --python 3.11 && source venv/bin/activate
uv pip install -e ".[all,dev]"
# 提交前检查
ruff check .
pytest
PR 前请确保 lint 和测试通过（CI 会在 PR 上自动运行同样的检查），并同步更新中英文 README。
参与方向： 通道适配器 · 内置工具 · MCP 集成 · 技能示例 · 评测数据集 · 文档完善 · 部署模板
社区：
- QQ群：47572014
协议
Star History
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 echo_agent-0.3.0.tar.gz.
File metadata
- Download URL: echo_agent-0.3.0.tar.gz
- Upload date:
- Size: 457.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a190481b15d2133ced0efc9e09fc591d209c2c54f6adb8abb9d5b614418aa124
|
|
| MD5 |
ae194a2b34cf2737ac5ecda1ceb1ad4d
|
|
| BLAKE2b-256 |
35a5f4a1924144644400439a4d91f95f27f7884404b411ae631a10427cf517ff
|
File details
Details for the file echo_agent-0.3.0-py3-none-any.whl.
File metadata
- Download URL: echo_agent-0.3.0-py3-none-any.whl
- Upload date:
- Size: 613.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b4759da08798c5bf473f53cee5d16d8630ef143574811479d9a6f57911f6899f
|
|
| MD5 |
97d6322dd48e3d3f4ce33af5746276fe
|
|
| BLAKE2b-256 |
6420484a3180503100b017f3691773e86a31301901d410fced6e6add87f1a79b
|
