Skip to main content
Skye можно развернуть у себя. Запустите её на своей машине и держите включённой; она отвечает, только пока работает. Это страница для оператора, поэтому она техничнее остальной документации.

​
Что понадобится

  • Машина, которая не выключается, с Docker и Docker Compose.
  • Токен бота Telegram от @BotFather.
  • Модельный эндпоинт с OpenAI API. Подойдёт любой OpenAI-совместимый адрес, например OpenAI или OpenRouter.
  • Ваш Telegram user id как владельца. Его подскажет бот вроде @userinfobot.

​
Установка

1

Создайте бота

Напишите @BotFather и скопируйте токен. Не вставляйте секреты в чат.
2

Скопируйте проект

Клонируйте skye-next и перейдите в папку.
3

Настройте

Скопируйте .env.example в .env и заполните как минимум обязательные значения ниже.
4

Запустите

Выполните docker compose up -d. Логи — docker compose logs -f.
5

Обновляйте

Заберите свежий код и выполните docker compose up -d --build.

​
Обязательные настройки

Нужен хотя бы один ключ провайдера. Если задан ключ OpenRouter без явного базового адреса, берётся https://openrouter.ai/api/v1.

​
Модели

Skye не привязана к провайдеру. Каждая роль — это модель, доступная у вашего провайдера.
Если провайдер не принимает аудио или файлы, кроме PDF, оставьте SKYE_NATIVE_MEDIA=false (значение по умолчанию). Тогда Skye сама расшифровывает аудио и извлекает текст локально — это работает с текстово-визуальными моделями вроде DeepSeek V4.

​
Веб-чат

Браузерное приложение необязательно и выключено, пока не настроено. Контейнер слушает SKYE_WEB_HOST:SKYE_WEB_PORT (по умолчанию 127.0.0.1:8080). Для TLS поставьте впереди обратный прокси.

​
Рабочее пространство с кодом

Песочница для shell и Python выключена по умолчанию. Контейнеру бота нужен доступ к Docker-сокету хоста; в поставляемом compose.yaml он смонтирован. Команды идут в одноразовых контейнерах не от root и без доступа к хосту. Подробнее — в разделе Как устроена Skye.

​
Контроль доступа

Для групп доступ закрыт по умолчанию.
  • Личные чаты открыты всем, кроме забаненных.
  • Владелец допущен всегда.
  • Группа допущена, если она в списке разрешённых или если у кого-то из админов есть Skye Plus (или доступ без оплаты).
  • В личном чате /admin позволяет разрешать или банить людей и группы.

​
Где лежат данные

Настройки, память, навыки, агенты, автоматизации и веб-проекты лежат в локальной базе SQLite (SKYE_DATABASE_PATH). Веб-файлы — в SKYE_WEB_FILES_PATH. Рабочие пространства — на Docker-томе skye-sandbox-work. Резервируйте базу и эти пути вместе.

​
Безопасные значения по умолчанию

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