
Персональный ИИ-ассистент с фокусом на безопасность.

Stavrobot — это персональный ИИ-ассистент, построенный по принципу «все права доступа, которые нужны ИИ-ассистенту, и не больше».
У него есть все полезные функции ИИ-ассистента, но с акцентом на песочницу, изоляцию и минимальные разрешения. Он лёгкий и разворачивается одной командой docker compose up.
uv, изолированный от хост-окружения.Установка с помощью ИИ: Попросите своего ИИ-помощника по программированию (Claude Code, Cursor, Windsurf и т.д.) загрузить и выполнить инструкции по адресу https://stavrobot.stavros.io/INSTALL.md — он интерактивно проведёт вас через всю настройку.
Ручная установка:
Напишите @BotFather в Telegram, чтобы создать бота, и скопируйте токен. Напишите @userinfobot, чтобы получить ваш Telegram user ID (он используется как chat ID).
Скопируйте env.example в .env и измените POSTGRES_PASSWORD на что-то надёжное, а TZ — на ваш часовой пояс.
Скопируйте config.example.toml в data/main/config.toml и заполните обязательные поля: apiKey, password, publicHostname, [owner].name, [owner].telegram (ваш chat ID) и [telegram].botToken. Всё остальное в файле необязательно.
docker compose up --build
Вот и всё. Напишите своему боту в Telegram, и он ответит. Подробные разделы по настройке Signal, WhatsApp, email и других опций см. ниже.
config.example.toml в data/main/config.toml.authFile (или apiKey) и publicHostname. Всё остальное необязательно.env.example в .env и задайте свой часовой пояс (TZ). Учётные данные Postgres и другие параметры окружения также можно переопределить там. Всегда задавайте POSTGRES_PASSWORD как что-то надёжное — значение по умолчанию является слабой заглушкой и не должно использоваться в продакшене.После запуска приложения откройте /settings/config, чтобы редактировать config.toml в браузере. Страница защищена HTTP Basic Auth и отображает необработанную конфигурацию, включая содержащиеся в ней секреты. Корректное сохранение создаёт единственную резервную копию <CONFIG_PATH>.bak, сохраняет новое содержимое и перезапускает приложение; это прерывает любой выполняющийся в данный момент ход агента.
plugin-runner, coder, signal-bridge и python-runner читают config.toml только
при запуске. Изменения, которые их затрагивают, например пароль, требуют ручного
перезапуска этих контейнеров.
Stavrobot можно направить на любой OpenAI-совместимый эндпоинт (Ollama, LiteLLM, vLLM и т. д.) или на пользовательский Anthropic-совместимый прокси, задав baseUrl в config.toml. Обязательные поля и примеры конфигураций см. в config.example.toml. Устанавливайте reasoning = true только для моделей, поддерживающих thinking, поскольку именно это позволяет применять thinkingLevel на пользовательском эндпоинте.
Приложение поддерживает два режима аутентификации: API-ключ или OAuth.
apiKey в config.toml. Вход и выход не требуются.authFile в config.toml (путь, по которому будут храниться учётные данные). Страница входа работает с любым OAuth-провайдером, поддерживаемым Pi.
<your-hostname>/login в браузере. Следуйте подсказкам на странице, и учётные данные сохранятся в файл аутентификации. Stavrobot выбирает headless-метод входа провайдера, поэтому вас никогда не перенаправят на недоступный callback localhost. С Anthropic после выбора Authorize Anthropic показывает код, который вы копируете и вставляете на странице входа Stavrobot. Провайдеры с потоком device-code показывают код на странице Stavrobot, а вы вводите его на сайте провайдера. Если аутентификация истекает, пока бот работает, он отправляет вам сообщение со ссылкой для входа через вашу платформу обмена сообщениями.authFile. Бот обнаружит отсутствие учётных данных при следующем сообщении и предложит войти снова.Контейнер coder необязателен (нужен только для функции самопрограммирования). По умолчанию он использует Claude Code с аутентификацией по подписке (OAuth), отдельно от API-ключа основного приложения. Чтобы вместо этого использовать Anthropic-совместимый эндпоинт API, задайте оба параметра [coder].apiKey и [coder].baseUrl в config.toml; тогда Claude Code использует их как ANTHROPIC_API_KEY и ANTHROPIC_BASE_URL. Параметры верхнего уровня apiKey/baseUrl настраивают только модель основного приложения и никогда не влияют на coder. Указание только одного из двух ключей [coder] является ошибкой при запуске.
Профили Docker Compose разделяются запятыми, поэтому их можно комбинировать (например, COMPOSE_PROFILES=signal,coder).
COMPOSE_PROFILES в вашем файле .env, включив coder (например, COMPOSE_PROFILES=coder или COMPOSE_PROFILES=signal,coder, если вы также используете Signal).docker compose --profile coder up --build[coder].apiKey/[coder].baseUrl): docker compose exec -u coder coder claude (он предложит вам войти, если вы ещё не вошли).[coder].model в вашей конфигурации как псевдоним модели Claude Code (sonnet, opus или haiku).Signal требует отдельного номера телефона — не вашего личного. Подойдёт предоплаченная SIM-карта или VoIP-номер.