ShenSeanChen/waku-agent

Health v2 · maintenance only

Flags: young

Adoption not part of the score

1580 stars · 292 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

Waku Agent is a local-first AI agent harness in Python that exposes the full agent stack — harness, loop, memory, and eval/LLM-Ops — as small, readable code. Memory lives in a single SQLite file with semantic, episodic, and procedural layers, and it ships with a terminal chat, a browser dashboard, and built-in deterministic plus LLM-as-judge evals.

Use cases

• build a personal AI assistant that runs locally on my laptop
• learn how an agent loop and memory system work by reading real code
• run an LLM agent with persistent memory stored in sqlite
• evaluate my agent with deterministic tests and LLM-as-judge before releasing
• watch an agent's message flow in a local dashboard
• self-host a chatbot with a wake word and Telegram gateway

When to choose

• you want a legible, hackable agent codebase instead of an opaque framework
• you want local-first ownership of your agent's memory as a plain SQLite file
• you want evals and a release gate built into your agent harness
• you're learning agent architecture (loop, memory, eval) from a working example

When to avoid

• you need a production-grade, battle-tested multi-agent orchestration platform
• you need distributed or multi-user agent deployment at scale
• you want a no-code or fully managed agent builder
• you need non-Python runtimes or heavy vector-database integrations out of the box

Facets

framework · maturity active

agent-framework llm-inference rag chatbot testing monitoring database artificial-intelligence large-language-models developer-tools self-hosted python cli cross-platform self-hosted local-first agent-loop agent-memory llm-evals llmops sqlite-memory personal-assistant telegram-gateway readable-code ai-agents

Member repositories

For agents

markdown · JSON · MCP: product_card(name="ShenSeanChen/waku-agent")