用途:Waku 是本地优先的个人 AI 助手,强调实现透明、记忆归用户所有,记忆保存在单个 state.db SQLite 文件中。
主要能力:Harness 提供 CLI、Telegram、语音、Web 仪表盘等网关入口;Loop 是约 95 行的纯 Python 推理循环,负责 LLM 与工具交替调用;Memory 为三层系统,含语义事实、情节事件与过程性技能;Eval/LLM-Ops 提供确定性测试与 LLM-as-judge 评估及发布门禁。内置工具涵盖日历、笔记、搜索、消息,并支持图工作流处理多步任务。
使用方式:安装可执行 pip install waku-agent,或克隆仓库后用 uv venv && uv pip install -e . 并复制 .env.example 为 .env。在 .env 中配置一个提供方密钥,如 WAKU_PROVIDER=anthropic 与 ANTHROPIC_API_KEY。终端聊天运行 waku,Web 仪表盘运行 waku dashboard(localhost:7777),也可用 uv run waku 或 make run、make dashboard。自定义工具通过 @tool 装饰器定义并 register_tool 注册;记忆可用 SemanticMemory、EpisodicMemory 等类读写,也可用 sqlite3 直接查询 .waku/state.db。
适用场景:需要本地可控记忆、跨渠道连续对话、可检查与可评估的个人助理场景。
限制:支持 Anthropic、OpenAI、Gemini、DeepSeek、MiniMax、Kimi、GLM、OpenRouter 等提供方,需自备 API 密钥;Telegram 与 Tavily 搜索为可选配置。仪表盘默认端口 7777 可能被占用。具体收费、价格与效果资料暂未提供。