Waku Agent

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 by seanchen.io.

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

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

Waku Memory — the same memory in Claude Code, Codex, Grok Bot and this agent: waku.one · docs

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

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

Quickstart

Just want to run it:

It will tell you which key to set the first time. Want to read the code (the
point of this repo) or contribute — clone it instead:

Now try it. *"Remember that Alex prefers morning meetings."* Quit. Restart.
*"Book a catch-up with Alex on Friday."* → it remembers, and books 9am. Your memory is one
file: ~/.waku/state.db, the same from every folder.

Use the model you already pay for. Anthropic (default), OpenAI, Gemini, DeepSeek, MiniMax,
Kimi, GLM, OpenRouter (one key, hundreds of hosted models), OpenCode Zen, or OpenCode Go —
set…