Repolode
ShenSeanChen

ShenSeanChen/waku-agent

Локальный персональный AI-ассистент на понятном Python: собственный цикл агента, память на SQLite и встроенные evals.

Open source альтернатива:ChatGPT

Звёзды
2,082
Форки
410
Открытые issues
57
Последний коммит
11 дней назад

Что это?

waku-agent — персональный AI-ассистент, который работает на вашем компьютере. Он состоит из четырёх частей: harness, который подключает к одному циклу агента шлюзы — например, терминал, браузерную панель, Telegram и Discord; цикл примерно из 95 строк Python, который рассуждает, действует и повторяет процесс; система памяти, включающая семантическую, эпизодическую и процедурную (навыки) память; и слой evals, который объединяет детерминированные тесты с оценкой LLM-as-judge.

Память хранится в одном файле SQLite. Фильтр решает, стоит ли запоминать каждое сообщение, а этап консолидации определяет, что сохранить. Проект поддерживает несколько провайдеров моделей, включая Anthropic, OpenAI, Gemini, DeepSeek и OpenRouter; провайдера выбирают через переменную окружения, указав API key. Необязательная интеграция подключает агента к размещённому сервису Waku Memory, чтобы делиться памятью с другими агентами.

Код рассчитан на то, чтобы его читали и изменяли, а не использовали как чёрный ящик. Проект распространяется по лицензии MIT, за исключением каталога hosted/, на который распространяется Elastic License 2.0.

Ключевые возможности

  • 01Цикл агента примерно из 95 строк обычного Python: рассуждение, действия и повторение
  • 02Семантическая, эпизодическая и процедурная память в локальном файле SQLite
  • 03Шлюзы для терминала, браузерной панели, Telegram, Discord и голосового ввода
  • 04Детерминированные тесты и evals с оценкой LLM-as-judge и проверкой перед релизом
  • 05Поддержка нескольких провайдеров моделей, включая Anthropic, OpenAI, Gemini и OpenRouter

Сценарии использования

  • Запустить персонального ассистента на ноутбуке и хранить его память локально
  • Разобраться, как цикл агента, поиск по памяти и evals сочетаются в небольшой кодовой базе
  • Создать форк harness, чтобы добавить новый шлюз для обмена сообщениями или инструмент
  • Делиться одной памятью между Claude Code, Codex и другими агентами с помощью Waku Memory

Быстрый старт

  1. 1

    Установите пакет из PyPI

    pip install waku-agent
  2. 2

    Общайтесь с Waku в терминале (при первом запуске он попросит ввести API key)

    waku
  3. 3

    Или откройте панель в браузере по адресу localhost:7777

    waku dashboard

Что важно знать

  • Для работы нужен API key от провайдера моделей (например, Anthropic или OpenAI).

Темы

Частые вопросы

Что такое waku-agent?
Локальный персональный AI-ассистент на понятном Python: собственный цикл агента, память на SQLite и встроенные evals. waku-agent — персональный AI-ассистент, который работает на вашем компьютере. Он состоит из четырёх частей: harness, который подключает к одному циклу агента шлюзы — например, терминал, браузерную панель, Telegram и Discord; цикл примерно из 95 строк Python, который рассуждает, действует и повторяет процесс; система памяти, включающая семантическую, эпизодическую и процедурную (навыки) память; и слой evals, который объединяет детерминированные тесты с оценкой LLM-as-judge.
waku-agent можно использовать бесплатно? Какая у него лицензия?
waku-agent распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
waku-agent всё ещё поддерживается?
Активно поддерживается. Последний коммит в waku-agent — 11 окт. 2026 г..
Для чего можно использовать waku-agent?
Запустить персонального ассистента на ноутбуке и хранить его память локально Разобраться, как цикл агента, поиск по памяти и evals сочетаются в небольшой кодовой базе Создать форк harness, чтобы добавить новый шлюз для обмена сообщениями или инструмент Делиться одной памятью между Claude Code, Codex и другими агентами с помощью Waku Memory
Как установить waku-agent?
Установите пакет из PyPI: pip install waku-agent Общайтесь с Waku в терминале (при первом запуске он попросит ввести API key): waku Или откройте панель в браузере по адресу localhost:7777: waku dashboard
Где скачать waku-agent?
Исходный код и инструкции по установке — на GitHub: https://github.com/ShenSeanChen/waku-agent

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Легковесное самохостируемое приложение-персональный агент с TUI и GUI, инструментами для локального рабочего пространства, подтверждением действий человеком, сохраняемыми сессиями, памятью и расширениями Skill/Plugin/MCP.

1844PythonMITОбновлён 21 час назад

Документированная архитектура и устанавливаемый плагин Claude Code для создания постоянного AI-руководителя аппарата с памятью, ежедневными сводками и фоновыми задачами по расписанию.

8512HTMLMITОбновлён 4 дня назад