waku-agent
Waku Waku! Waku Agent is a local-first AI agent harness you actually own, including loop, memory, eval, all in code built to stay legible as it grows.
What is it?
What it is
**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
Why it exists
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
Who should use it
Teams building with Python who want an open-source, self-hosted option.
Who should avoid it
Teams that need a fully managed SaaS with enterprise SLAs out of the box.
Stars over time
+1.2k stars in the last 5 weeks
How it works
A quick walkthrough in plain English
How waku-agent works
Step 1 of 3
You interact with it
Open waku-agent, send a request, or connect it to your stack.
Features
Advantages
- Open source (MIT)
- Active Python ecosystem
- Self-hosted deployment options
Disadvantages
- Requires operational ownership for self-hosted setups
- Community support varies by project maturity
Installation
native
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
FAQ
What is waku-agent?
waku-agent is an open-source project licensed under MIT.
What language is waku-agent built with?
Primary language: Python.
Is it free to use?
Yes. Licensed under MIT. Check the license for commercial use.
Featured in Videos
YouTube tutorials and walkthroughs for waku-agent
Alternatives
Similar projects ranked by category, topics, and text overlap.
