Waku Agent

Waku Agent — открытый проект на GitHub: персональный AI-агент, который работает прямо на твоём ноутбуке, а не где-то в облаке. Это не готовый сервис с кнопкой «купить», а код, который реально можно прочитать и понять за один вечер — автор специально убрал все фреймворки, чтобы видна была суть: цикл, память, оценка качества. Подойдёт разработчикам, которые хотят разобраться, как устроены агенты внутри, и собрать своего — с блэкджеком и своими правилами.

Идея строится на четырёх столпах любого серьёзного агента. Harness — обвязка, которая связывает всё вместе. Loop — сам цикл мышления агента, всего около 95 строк обычного Python, который можно пройти шаг за шагом и увидеть, как агент принимает решения. Memory — память трёх видов (семантическая, эпизодическая и процедурная), которая хранится в одном файле SQLite: открыл — и всё видно, ничего не спрятано в чужом облаке. И Eval — встроенная система оценки: детерминированные тесты и LLM-судья работают рядом друг с другом, а release-gate решает, готова ли версия к выпуску.

Запустить можно двумя способами. Через pip — команда waku поднимет чат в терминале, а waku dashboard откроет локальную веб-панель на localhost:7777. Или клонировать репозиторий целиком через uv venv, если хочешь читать и менять код руками. Дашборд — это твой собственный локальный сервер, никакие данные никуда не улетают. На нём разложены вкладки под каждый пилар: обзор с графом стоимости и задержек, шлюз со всеми каналами связи (дашборд, Telegram, голос, консоль), цикл с решениями и вызовами инструментов, память по подтипам, инструменты и MCP-коннекторы, живой SQL-браузер по базе state.db и раздел с вердиктами оценок.

Waku не привязан к одной нейросети — можно подключить Anthropic (стоит по умолчанию), OpenAI, Gemini, DeepSeek, MiniMax, Kimi, GLM, OpenRouter или другие совместимые провайдеры: достаточно вставить один ключ в переменную окружения. Есть готовая интеграция с Telegram-ботом и голосовой ввод с фирменным словом-триггером «Waku Waku». Агент умеет запоминать факты вроде «Алекс предпочитает утренние встречи», искать информацию в вебе через Tavily и в одном заходе создавать сразу несколько событий в календаре, если задача это подразумевает.

В репозитории лежат и редактируемые схемы архитектуры в формате .excalidraw — можно скачать, открыть на excalidraw.com и переделать под свою команду. Проект полностью бесплатный и открытый: ставь звезду на GitHub, если пригодилось, форкай и меняй под себя.