为什么值得关注

它通过提供完全透明的最小化代码库来解密代理架构，展示了记忆支柱、检索门控以及双重评估方法（确定性评估和 LLM 作为评判者），并配有本地仪表板。

适合谁使用

学习代理架构的 AI 开发者和工程师
希望拥有本地、私密 AI 助手的爱好者
教授代理设计和 LLM 操作的教育工作者
需要可定制、可读代理框架的开发者

典型使用场景

个人日程安排和记忆管理（例如日历事件、偏好）
具备网络搜索和笔记功能的本地研究助手
用于理解代理循环、门控和评估的教学工具
多渠道助手（命令行、浏览器仪表板、Telegram、语音）

项目优势

约 95 行的可读代理循环，无需重量级框架（如 LangGraph）
本地优先，使用 SQLite 记忆且完全拥有数据；仪表板仅在 localhost 运行
内置评估套件：确定性测试与 LLM 作为评判者并列
全面的本地仪表板，实时监控记忆、工具、追踪和操作

使用前须知

不适用于高规模生产部署（本地、单用户导向）
需要手动设置各种 LLM 提供商的 API 密钥
部分功能（子代理、终端、浏览器、定时任务）为实验性或仅存骨架

README 快速开始

waku-agent

Your own AI assistant. On your laptop. In code you can read in an afternoon.

Meet Waku — a local-first personal assistant that shows the four pillars behind every serious agent: Harness · Loop · Memory · Eval/LLM-Ops. No frameworks hiding the good parts. Built for Sean's AI Stories.

Local-first. Your memory is one SQLite file. Open it. Read it. It's yours.
Memory is the hero. Semantic + episodic + procedural — with a gate that decides whether to remember, and a pass that decides what to keep.
The loop is ~95 lines of plain Python. Step through it.
Watch it think. A local dashboard lights up every message as it flows through the harness.
Eval built in. Deterministic tests and LLM-as-judge, side by side, with a release gate.

The system-design whiteboard from the series. Every box maps to a file — see the whiteboard maps to the code.

▶ Watch the 20-min code walkthrough — the loop, the memory pillars, the evals, the Telegram gateway and the "Waku Waku" wake word, live.

YouTube · X · LinkedIn · Instagram · TikTok · Discord · 哔哩哔哩 · 小红书 · 抖音

☕️ Buy me a coffee — it keeps this repo (and the videos) coming

Quickstart

git clone https://github.com/ShenSeanChen/waku-agent && cd waku-agent
uv venv && uv pip install -e .          # create the env + install the `waku` command
cp .env.example .env                    # pick a provider, paste ONE key
uv run waku                             # talk to your Waku in the terminal
uv run waku dashboard                   # …or the browser cockpit → localhost:7777

uv run waku … needs no venv activation. Three ways to run it:

Command	When
`uv run waku dashboard`	quick s

项目描述

Waku Waku! Waku agent is your personal AI agent, on your own laptop, in code you can read in an afternoon — harness + loop + memory + eval

相关仓库与替代方案

根据分类、Topic 和编程语言匹配的相似项目。

lopopolo

精选

harness-engineering

Harness Engineering is a methodology for improving coding agent outputs by carefully crafting the environment around them—providing curated context, tools, and executable constraints that encode an organization’s nonfunctional requirements and cumulative lessons.

AI 与机器学习AI 智能体

2,390

slvDev

精选

esp32-ai

A 28.9 million parameter language model runs on an $8 ESP32-S3 microcontroller entirely on-device, generating simple stories at about 9.5 tokens per second.

AI 与机器学习大语言模型

1,960

littledivy

精选

mimic

mimic captures traffic from any iOS or web app and automatically generates a Python client library that lets you call the app's API like a regular library.

AI 与机器学习

1,482