开源 AI 私人助理,用于日程规划、写作和个人知识管理,可在 Mac 或自托管环境中运行。
- Star
- 2,082
- Fork
- 410
- 未关闭 Issue
- 57
- 最近提交
- 11天前
这是什么?
waku-agent 是一个在本地运行的个人 AI 助手,核心由四部分组成:harness 把终端、浏览器控制台、Telegram、Discord 等入口接入同一个 agent 循环;约 95 行 Python 实现的 loop 负责推理、执行动作并重复;记忆系统包含语义记忆、情景记忆和程序性记忆(技能);评测层把确定性测试与 LLM-as-judge 打分放在一起。
记忆保存在一个 SQLite 文件中,写入前由门控判断是否值得记住,之后的整理步骤决定保留哪些内容。项目支持 Anthropic、OpenAI、Gemini、DeepSeek、OpenRouter 等多家模型服务商,通过环境变量和 API Key 切换。可选的 Waku Memory 集成能让多个 agent 共享同一份托管记忆。
这个项目的定位是让人阅读和修改,而不是当作黑盒使用。除 hosted/ 目录采用 Elastic License 2.0 外,其余代码均为 MIT 许可。
核心功能
- 01约 95 行纯 Python 实现的 agent 循环,包含推理、执行与重复
- 02语义、情景和程序性记忆,保存在本地 SQLite 文件中
- 03提供终端、浏览器控制台、Telegram、Discord 与语音入口
- 04确定性测试与 LLM-as-judge 评测并存,并带有发布门禁
- 05支持 Anthropic、OpenAI、Gemini、OpenRouter 等多家模型服务商
适用场景
- 在笔记本上运行一个把记忆保存在本地的个人助手
- 学习 agent 循环、记忆检索与评测如何在小型代码库中协作
- 基于 harness 扩展新的消息入口或工具
- 借助 Waku Memory 在 Claude Code、Codex 等 agent 之间共享同一份记忆
快速上手
- 1
从 PyPI 安装软件包
pip install waku-agent - 2
在终端中与你的 Waku 对话(首次运行会提示设置 API 密钥)
waku - 3
或在浏览器中打开 localhost:7777 的仪表板
waku dashboard
使用前须知
- 运行需要模型提供商(如 Anthropic、OpenAI)的 API 密钥。
标签
常见问题
- waku-agent 是什么?
- 一个本地优先的个人 AI 助手,代码用 Python 编写,包含可读的 agent 循环、基于 SQLite 的记忆和内置评测。 waku-agent 是一个在本地运行的个人 AI 助手,核心由四部分组成:harness 把终端、浏览器控制台、Telegram、Discord 等入口接入同一个 agent 循环;约 95 行 Python 实现的 loop 负责推理、执行动作并重复;记忆系统包含语义记忆、情景记忆和程序性记忆(技能);评测层把确定性测试与 LLM-as-judge 打分放在一起。
- waku-agent 可以免费使用吗?用的什么许可证?
- waku-agent 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- waku-agent 还在维护吗?
- 活跃维护中。waku-agent 最近一次提交是在 2026年10月11日。
- waku-agent 适合用来做什么?
- 在笔记本上运行一个把记忆保存在本地的个人助手 学习 agent 循环、记忆检索与评测如何在小型代码库中协作 基于 harness 扩展新的消息入口或工具 借助 Waku Memory 在 Claude Code、Codex 等 agent 之间共享同一份记忆
- waku-agent 怎么安装和运行?
- 从 PyPI 安装软件包: pip install waku-agent 在终端中与你的 Waku 对话(首次运行会提示设置 API 密钥): waku 或在浏览器中打开 localhost:7777 的仪表板: waku dashboard
- 在哪里获取 waku-agent?
- 源代码和安装说明在 GitHub 上:https://github.com/ShenSeanChen/waku-agent
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
轻量级自托管个人智能体应用,提供 TUI 与 GUI 两种界面,支持本地工作区操作、人工审批、会话持久化与扩展。
本地优先的自托管个人 AI Agent,提供分层记忆、工具授权、工作流和多渠道接入。
可自托管的持久化 AI 智能体平台,具备长期记忆,可协作并通过多种聊天渠道响应,单容器运行。
基于 Claude Code 搭建持久化 AI 幕僚长的架构文档,可通过插件一键安装,包含记忆、每日简报和后台定时任务。
基于 Hermes 构建的本地优先个人 OS 代理,记录情绪、睡眠、饮食和习惯,并随时间发现它们之间的规律。