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

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

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

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

Программа распространяется по BSL 1.1, условия лицензии опубликованы, готовые выпуски лежат рядом. Репозиторий сейчас закрыт, поэтому проверять программу приходится в работе: что она делает на вашей машине и куда ходит по сети, видно из неё самой.

Входы

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

01 первый запуск

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

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

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

02 площадки

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

Linux, Windows, сервер, расширение браузера, Android.

Установка

03 настройка

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

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

docs/setting.md

04 устройство

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

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

docs/arhitektura.md

05 доступы

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

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

docs/bezopasnost.md

06 сервисы

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

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

docs/connectors/README.md

07 служба

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

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

docs/lichnayaObkatka.md

08 навыки

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

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

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

09 участие

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

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

CONTRIBUTING.md

Коротко

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

Ядро на Go

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

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

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

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

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

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

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

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

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

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