RepoRadar Waku Agent: локальный AI-ассистент с контролем памяти и логики
Waku Agent — локальный AI-ассистент, который ты можешь полностью контролировать, включая память и логику.
Проект решает проблему конфиденциальности, позволяя хранить данные на локальном уровне в одном файле SQLite. В отличие от облачных решений, ты точно знаешь, что происходит с твоими данными. Система построена на понятном Python-коде, который можно изучить за пару часов, что особенно понравится разработчикам. Механизм памяти включает семантические, эпизодические и процедурные аспекты, что делает AI более адаптивным к твоим нуждам.
Запускать Waku Agent просто — достаточно Python и необходимых библиотек, указанных в README. Учти, что проект всё ещё на ранней стадии, поэтому может быть нестабильным.
Обзор проекта
Waku — это локальный персональный ассистент, который стремится предоставить пользователю полный контроль над системой. Он разработан с вниманием к принципу "первой локальности", что означает, что все данные хранятся локально в одном файле SQLite. Это позволяет пользователю легко управлять своей памятью, без необходимости зависеть от облачных сервисов.
Основные особенности
- Память: Waku использует три типа памяти: семантическую, эпизодическую и процедурную, с возможностью выбора, что запомнить.
- Логика: Основная логика работы оператора представлена в виде примерно 95 строк простого Python-кода, что облегчает изучение и изменение проекта.
- Дашборд: Пользователь может наблюдать за выполнением задач через локальный дашборд, который отображает каждое сообщение во время обработки.
- Тестирование: Встроенные инструменты для оценки возможностей ИИ позволяют выполнять определенные тесты и использовать ИИ для дополнительной проверки.
Установка и запуск
Чтобы установить Waku, выполните следующие команды:
pip install waku-agent
waku # запустите Waku в терминале
waku dashboard # или откройте дашборд в браузере → localhost:7777
Если ты хочешь внести изменения в код, клонируй репозиторий и создай виртуальное окружение:
git clone https://github.com/ShenSeanChen/waku-agent && cd waku-agent
uv venv && uv pip install -e .
cp .env.example .env
uv run waku # взаимодействуйте с Waku в терминале
uv run waku dashboard # или откройте дашборд в браузере
После первого запуска, Waku запросит ввод ключа API. Это позволяет использовать ИИ модели, за которые ты уже платишь.
Подключение Waku Memory
Waku Memory — это функция, позволяющая пользователям сохранять данные в облаке и делиться ими между разными помощниками. Чтобы подключить её, используй следующую команду:
pip install 'waku-agent[mcp]' # в клонированном репозитории: uv pip install -e '.[mcp]'
waku connect waku-memory # или /connect waku-memory в дашборде
Это позволит взаимодействовать с памятью Waku через другие модели, такие как Claude Code и Codex.
Ограничения
Несмотря на открытость и доступность кода, важно понимать, что интеграция с некоторыми серверами и системами может потребовать дополнительных настроек. Кроме того, проект имеет некоторые юридические ограничения: компоненты, находящиеся в папке `hosted/`, лицензируются по Elastic License 2.0, что запрещает использование данного кода как сервиса для других.
Открыть на GitHub: ShenSeanChen/waku-agent →
