Repolode
ShenSeanChen

ShenSeanChen/waku-agent

一个本地优先的个人 AI 助手,代码用 Python 编写,包含可读的 agent 循环、基于 SQLite 的记忆和内置评测。

可替代:ChatGPT

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. 1

    从 PyPI 安装软件包

    pip install waku-agent
  2. 2

    在终端中与你的 Waku 对话(首次运行会提示设置 API 密钥)

    waku
  3. 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 数据每日更新。

相关项目