AgentIndex icon
AgentIndex
工具MCP 服务HOT分类热门最新选型清单对比指南
提交工具
工具MCP 服务HOT分类热门最新选型清单对比指南
首页/
工作流自动化/
waku-agent
waku-agent logo

waku-agent

活跃·★ 2.2k·MIT·更新于 2026-11-18

waku-agent 是由独立工程师 Sean Chen 开源的极简本地优先(Local-First)个人 AI 智能体框架(遵循 MIT 协议)。面对市面上大量过度包装、抽象层次臃肿且难以调试的商业级 Agent 框架,Waku 致力于打破“黑盒”,用一个下午就能通读的优雅代码,向开发者清晰展示生产级智能体最核心的底层奥秘。

系统架构直击构建严谨智能体的四大核心支柱:执行器(Harness,工具插拔式调用)、思考循环(Loop,仅约 95 行通透干净的 Python 原生核心循环)、记忆体系(Memory,单 SQLite 文件融合语义、情景与过程记忆,并内嵌记忆准入与淘汰机制)以及评估运维(Eval,确定性单元测试与大模型裁判并行把关)。此外,项目还配套了实时消息流经的可视化 Web 看板、Telegram 移动网关以及“Waku Waku”语音唤醒交互。

对于希望将核心数据与长短期记忆 100% 留在自己笔记本中、拥有绝对数据主权的开发者而言,这是一座完美的架构标杆。需要客观看待的是,由于秉持极简主义拒绝引入厚重第三方集成包,新增外部业务工具需开发者手写纯 Python 函数;本地 SQLite 数据库的长期备份与数据迁移也需自行维护。

本文根据项目 README 和公开仓库数据整理,我们没有实际试用过该工具。数据截至 2026-11-12。

许可证
MIT
最新发布
v0.1.9 · 2026-10-08
最近提交
2026-11-12
贡献者
27
复刻数
429
未关闭的 issue 和 PR
70
首次发布
2026-07-10
PyPI 包
waku-agent 0.1.9 · 27 上周下载

来源:GitHub、npm 和 PyPI 的公开接口。

#智能体框架#AI 智能体#AI 助手#Claude#评测#大语言模型#大模型运维#本地优先
$ 安装
$ pip install waku-agent
↗ 访问官网★ GitHub
01

功能特性

01在本地存储语义、情节与流程记忆。
02提供终端聊天与本地仪表盘。
03包含评测门禁与逐轮追踪。
02

为什么选择它

+极致通透的架构设计,核心智能体推理循环仅用约 95 行纯粹的 Python 代码实现,完全无黑盒抽象掩盖。
+真正的数据本地所有权,情景记忆、语义画像与过程沉淀全在一个本地 SQLite 文件中,私有安全可控。
+内置工业级评估闭环(Eval),将程序确定性断言与 LLM-as-a-judge 裁判机制深度结合作为发布门禁。
+配套生态极其完整,自带实时可视化 Web 思考看板、Telegram 通讯机器人集成与语音唤醒交互模块。
03

权衡点

!极简设计未封装现成的数百种企业三方 API 插件,连接新服务需要开发者自行编写原生 Python 工具函数。
!所有记忆强依赖单一本地 SQLite 文件,多设备间无缝漫游同步需自行配置 Syncthing 或云端备份脚本。
!常驻本地开启语音唤醒(Wake Word)与实时音频流解析对性能较弱的轻薄笔记本有一定 CPU 占用开销。
!启用 Telegram 机器人或云端语音转写仍需开发者自行申请 Telegram Bot Token 与外部模型 API 凭证。
04

维护状况检查

活跃检查日期: 2026-11-12
最近提交
2026-11-11
近 90 天提交数
100+
近 90 天发布数
2
最新发布
v0.1.9 (2026-10-08)
未关闭 issue
70
近期 issue 至少有一条评论的比例
2/10
近 12 周每周提交数
近 12 周每周提交数: 17, 0, 6, 12, 12, 56, 27, 1, 0, 0, 0, 2

最早的一周在左边,最近 4 周为橙色。数据来源:GitHub 提交统计。

状态规则:GitHub 上已归档 = 已归档;最近提交在 90 天内 = 活跃;91 到 365 天 = 放缓;更久 = 停滞。所有数字来自所示日期的 GitHub API。

讨论最多的未关闭 issue

  • #137 The model picker offers OpenAI models that 404 on use6 条评论 · 2026-08-17
  • #109 记忆的总结是不是过于频繁,以及不够准确。3 条评论 · 2026-08-13
  • #338 Gemini: streamed tool calls drop thought_signature, dashboard turns 4002 条评论 · 2026-10-30
  • #337 DeepSeek: reasoning_content is never sent back, tool turns and follow-ups 4002 条评论 · 2026-10-30
  • #101 Add deterministic WhatsApp webhook security tests2 条评论 · 2026-08-11

issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。

05

兼容性

python
Python 包,需要配置受支持的模型服务
已通过文档验证
browser
可选本地仪表盘,默认 localhost:7777
已通过文档验证
06

快速开始

1
$ pip install waku-agent
07

使用场景

↳在本地运行可配置个人助手。
↳检查智能体如何检索与整合记忆。
↳评估小型智能体循环的改动。
08

同类工具

⚡热门对决:
VSAnyModelBot★4.4k→VShermes-agent★264.2k→VSnocobase★25.0k→VSparlant★18.3k→
AnyModelBot logo
AnyModelBot★ 4.4k
运行在本机、支持多个模型和消息渠道的 AI 机器人团队应用。
VS对比→
hermes-agent logo
hermes-agent★ 264.2k
Nous Research 出品的自我改进型 AI 智能体:内置学习循环,从经验中创建并改进技能,跨会话记忆用户,可在 VPS、GPU 集群或无服务器环境运行
VS对比→
nocobase logo
nocobase★ 25.0k
开源的 AI + 无代码平台,用于快速搭建业务系统;编码智能体通过 CLI 和技能构建,人通过所见即所得界面配置,两者可协作。
VS对比→
parlant logo
parlant★ 18.3k
面向客户对话智能体的开放平台,以策略、工具校验和预设回复管理行为,并提供聊天组件、人工接管与测试能力。
VS对比→
cindy logo
cindy★ 10.3k
开箱即用的开源 AI 智能体:在本机把 Claude Code、Codex 等 harness 和多种模型整合进一个智能体,可操作浏览器、电脑和手机,记忆与技能跨 harness 共享
VS对比→
Mika logo
Mika★ 9.0k
安卓手机上的私人 AI 助理,在看不见的后台屏上替你操作 App、浏览网页、在本地沙箱运行脚本,自带模型密钥,无需中转服务器。
VS对比→
nod logo
nod★ 2.3k
由 n8n 开源的本地个人智能体,通过独立电脑和浏览器处理日常事务并在代用户行动前请求批准。
VS对比→
capri-ai-desktop logo
capri-ai-desktop★ 1.7k
面向 Windows 的赛博朋克风格桌面 AI 助手,支持语音互动、模型接入与经批准的桌面操作。
VS对比→
查看全部替代品 →

评论

登录后发表评论

暂无评论,来发表第一条吧

本页内容
01功能特性02为什么选择它03权衡点04维护状况检查05兼容性06快速开始07使用场景08同类工具
ShenSeanChen /
waku-agent
↗

极简本地优先的个人 AI 智能体框架:95 行纯 Python 核心循环,清晰解构执行器、记忆与评估四要素

2.2k429MIT
最后更新今天
状态活跃
分类工作流自动化
贡献者27
最新发布v0.1.9
链接
文档↗讨论↗问题↗版本↗
推荐云部署
Ad

在 DigitalOcean 上一键部署

为你的 MCP 服务、Docker 容器与智能体提供即开即用云服务器,新用户立享 $200 免费额度(60天有效)。

立即领取 $200 免费额度
© 2026 AgentIndex.app|由十年 iOS 开发者构建。
按场景挑选关于我们联系我们广告合作隐私政策使用条款QYSGitHub请作者喝咖啡 ☕

按分类浏览

MCP 服务器代码助手工作流自动化RAG / 知识库多智能体浏览器自动化大模型基础设施开发者工具可观测性

与 Anthropic, OpenAI 或 Microsoft 无关。