AgentIndex icon
AgentIndex
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Submit Tool
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Home/
Workflow Automation/
waku-agent
waku-agent logo

waku-agent

Active·★ 2.2k·MIT·Updated 2026-11-18

waku-agent by Sean Chen (seanchen.io) is an open-source, local-first personal assistant framework (MIT license) designed to de-mystify modern agent architectures. Rejecting bloated, black-box frameworks that obscure how agents actually operate, Waku distills production agent engineering down to code you can read and understand in an afternoon.

The architecture clearly isolates the four foundational pillars of serious AI agents: Harness (pluggable tool execution), Loop (a crystal-clear, ~95-line Python core reasoning loop), Memory (a single, transparent SQLite database blending semantic, episodic, and procedural memory with admission gating), and Eval/LLMOps (deterministic unit tests alongside LLM-as-a-judge release gates). It pairs this with a local web dashboard that visually illuminates messages as they flow through the harness, a Telegram messaging gateway, and a custom wake-word ('Waku Waku') voice interface.

For developers and engineers who want full ownership over their personal assistant and memory without handing their data to cloud SaaS providers, Waku is an exceptional educational and practical blueprint. However, because it avoids sprawling external abstraction libraries, developers must write bespoke Python functions for custom integrations, and managing local SQLite backups remains a user responsibility.

This write-up is based on the project's README and public repository data. We have not hand-tested the tool. Data as of 2026-11-12.

License
MIT
Latest release
v0.1.9 · 2026-10-08
Last commit
2026-11-12
Contributors
27
Forks
429
Open issues and PRs
70
First published
2026-07-10
PyPI package
waku-agent 0.1.9 · 27 downloads last week

Source: GitHub, npm and PyPI public APIs.

#agent-framework#ai-agent#ai-assistant#claude#evals#llm#llmops#local-first
$ Install
$ pip install waku-agent
↗ Visit site★ GitHub
01

Features

01Stores semantic, episodic and procedural memory locally.
02Offers terminal chat and a local dashboard.
03Includes evaluation gates and per-turn traces.
02

Why choose it

+Radical architectural clarity: core agent reasoning loop implemented in ~95 lines of transparent, readable Python.
+True local-first data ownership: all semantic, episodic, and procedural memories reside in a single local SQLite file.
+Built-in evaluation gates combine deterministic programmatic tests with LLM-as-a-judge release criteria.
+Includes real-time visual web dashboard, Telegram messaging integration, and custom voice wake-word support.
03

Trade-offs

!Minimalist design means developers must manually author Python code for external enterprise tool integrations.
!Local SQLite database file requires user-managed backups and sync across multiple personal workstations.
!Voice wake-word and streaming audio processing introduce additional CPU/RAM load on modest local laptops.
!Telegram and voice messaging gateways require configuring separate bot tokens and API credentials.
04

Maintenance check

ActiveChecked: 2026-11-12
Last commit
2026-11-11
Commits, last 90 days
100+
Releases, last 90 days
2
Latest release
v0.1.9 (2026-10-08)
Open issues
70
Recent issues with at least one comment
2/10
Commits per week, last 12 weeks
Commits per week, last 12 weeks: 17, 0, 6, 12, 12, 56, 27, 1, 0, 0, 0, 2

Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.

Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.

Most discussed open issues

  • #137 The model picker offers OpenAI models that 404 on use6 comments · 2026-08-17
  • #109 记忆的总结是不是过于频繁,以及不够准确。3 comments · 2026-08-13
  • #338 Gemini: streamed tool calls drop thought_signature, dashboard turns 4002 comments · 2026-10-30
  • #337 DeepSeek: reasoning_content is never sent back, tool turns and follow-ups 4002 comments · 2026-10-30
  • #101 Add deterministic WhatsApp webhook security tests2 comments · 2026-08-11

Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.

05

Compatibility

python
Python package; configure a supported model provider
Verified via docs
browser
Optional local dashboard at localhost:7777
Verified via docs
06

Quick start

1
$ pip install waku-agent
07

Use cases

↳Run a configurable personal assistant locally.
↳Inspect how an agent retrieves and consolidates memory.
↳Evaluate changes to a small agent loop.
08

Alternatives

⚡Top VS:
VSAnyModelBot★4.4k→VShermes-agent★264.2k→VSnocobase★25.0k→VSparlant★18.3k→
AnyModelBot logo
AnyModelBot★ 4.4k
🤖 Open-source, local-first alternative to Grok Bot, OpenAI dots and Claude Duet. Your own AI bots on any model: GPT, Claude, Gemini, Grok, DeepSeek, Kimi, GLM and 70+ more through one Modelflare key. Reach them in the app, WeChat or Feishu; they remember you, work in the background, run commands and use your computer. Pay per use.
VSCompare→
hermes-agent logo
hermes-agent★ 264.2k
The agent that grows with you
VSCompare→
nocobase logo
nocobase★ 25.0k
NocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything from scratch, AI works on top of production-proven infrastructure and a WYSIWYG no-code interface, so you get both speed and reliability.
VSCompare→
parlant logo
parlant★ 18.3k
Parlant is an open platform for building customer-facing chat agents with AI. Describe how the agent should behave, and your coding agent implements it for you.
VSCompare→
cindy logo
cindy★ 10.3k
Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
VSCompare→
Mika logo
Mika★ 9.0k
Mika — 你手机上的私人 AI 助理,替你操作 App、上网、把事办成。An on-device AI agent for Android that operates apps and the web to get things done for you.
VSCompare→
nod logo
nod★ 2.3k
Open source personal agent with its own computer. It chases invoices, preps your calls and cancels trials on real websites, and asks before it acts. Runs on your machine with the model you choose. By n8n.
VSCompare→
capri-ai-desktop logo
capri-ai-desktop★ 1.7k
Cyberpunk AI desktop agent & voice companion for Windows. Supports Claude Code, Ollama, DeepSeek, Discord calls & screen automation.
VSCompare→
See all alternatives →

Comments

Log in to leave a comment

No comments yet. Be the first!

On this page
01Features02Why choose it03Trade-offs04Maintenance check05Compatibility06Quick start07Use cases08Alternatives
ShenSeanChen /
waku-agent
↗

Minimalist, local-first personal AI assistant framework demonstrating the four core pillars: Harness, Loop, Memory, and Eval

2.2k429MIT
Last commitToday
StatusActive
CategoryWorkflow Automation
Contributors27
Latest releasev0.1.9
Links
Documentation↗Discussion↗Issues↗Releases↗
Cloud Infrastructure
Ad

Deploy on DigitalOcean

Host your MCP servers, Docker containers, and AI agents with $200 free credit over 60 days.

Claim $200 Free Credit
© 2026 AgentIndex.app|Built by a 10-year iOS Developer.
Best by use caseAboutContactAdvertisePrivacy PolicyTerms of UseQYSGitHubBuy me a coffee ☕

Browse by Category

MCP ServersCode AssistantWorkflow AutomationRAG / Knowledge BaseMulti-AgentBrowser AutomationLLM InfraDev ToolingObservability

Not affiliated with Anthropic, OpenAI or Microsoft.