Документация

Сначала скажите,
что хотите сделать

Материалы разложены по задачам, а не по разделам кода. Ниже входы: от «запустить за пятнадцать минут» до «добавить свой коннектор».

Быстрый старт Репозиторий

Репозиторий пока закрыт: в истории коммитов остался домен портала клиента. Чистим историю перед открытием, до тех пор ссылка ведёт в никуда.

Входы

Если хотите...

01 15 минут

Запустить и увидеть ответ

Требования, установка, настройка модели, первый разговор. Самая короткая дорога от нуля до работающего агента.

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

02 площадки

Понять, куда это ставится

Linux, Windows, сервер, расширение браузера, Android. У каждой площадки честный статус живой проверки.

Установка

03 настройка

Настроить модель и каналы

Провайдеры модели, токены каналов, переменные окружения, ограничения инструментов и подтверждения.

docs/настройка.md

04 устройство

Разобраться, как устроено

Агентский цикл, каналы, память, планировщик, слой политики и локальный HTTP API. Что на Go, что на Python и почему.

docs/архитектура.md

05 доступы

Безопасно открыть доступ к данным

Модель безопасности целиком: подтверждения, граница чужих данных, изоляция коннекторов, что и куда не уходит.

docs/безопасность.md

06 сервисы

Подключить конкретный сервис

Каталог коннекторов: какие инструменты даёт каждый, какие переменные нужны, где сервис теряет данные молча.

docs/connectors/README.md

07 служба

Поставить постоянной службой

Юнит systemd, отдельный пользователь, каталог данных, журнал и что делать, когда канал умирает.

docs/личная-обкатка.md

08 навыки

Добавить навык или плагин

Манифест плагина, формат SKILL.md, разрешения на секреты и сеть, файл замка со слепком содержимого.

Навыки и плагины

09 участие

Написать свой коннектор

Коннектор готов, когда у него есть разведка, проверка полноты, тесты против локального сервера и своя страница документации.

CONTRIBUTING.md

Коротко

Как устроен проект

Ядро на Go

Один бинарник: агентский цикл, каналы, память, расписание, политика доступа и локальный HTTP API. Без внешних зависимостей вообще, go.mod содержит только имя модуля и версию языка. Причина простая: клиенту его ставят на ноутбук, а не на кластер.

Коннекторы на Python

Обычные MCP-серверы по stdio на стандартной библиотеке. Каждый запускается и тестируется отдельно, переносится в Hermes и в любой совместимый MCP-хост. Даже если ядро придётся сменить, коннекторы переживут смену.

Проверки, которые валят сборку

make check-wiring ищет объявленное и никем не вызываемое. За три дня разработки одиннадцать раз повторилось одно: код написан, покрыт тестами, зелёный в CI - и вызвать его некому.
Архитектурный сторож: файлы с законным вызовом коннектора перечислены поимённо.
Реестр коннекторов сверяется с деревом каталогов в обе стороны.
Тесты ищутся по каталогу, а не перечисляются списком: два ручных списка разошлись, и тесты двух коннекторов не запускались вовсе.

Мягкий список, который никого не останавливает, читают до первого раза. Поэтому проверки валят сборку, а не пишут предупреждение.

Не нашли ответ?

Напишите, что нужно сделать, и мы скажем, есть ли это в коде и где смотреть.

Написать нам Смотреть, что менялось

Сначала скажите,что хотите сделать