К содержимому

Запуск Space ​

Для создания и выполнения заданий нужен работающий Orpheus с профилем агента и шаблоном AgentBox. Space использует отдельную PostgreSQL БД. Сборка образов не требуется: пример запускает опубликованные образы API, worker и веб-интерфейса.

Локальный интерфейс ​

В клоне репозитория документации:

sh
cd examples/space
cp .env.example .env

Заполните POSTGRES_PASSWORD и ORPHEUS_SPACE_API_KEY в .env разными случайными значениями. Для каждого можно выполнить openssl rand -hex 32. Это параметры Compose: первый используется в DSN, второй — в списке ключей Space.

sh
docker compose config --quiet
docker compose pull
docker compose up -d db migrate api web
curl -fsS http://localhost:9110/ready

Откройте http://localhost:8086. В этом примере включён режим anonymous: интерфейс разрешает чтение и запись без входа, порты доступны только с локального компьютера. Открывайте именно localhost, поскольку ORPHEUS_PUBLIC_URL должен совпадать с origin браузера.

Перед созданием задания подключите Orpheus: Space проверяет профиль и шаблон по его каталогам. Без подключения можно просматривать сохранённые задания и проверять расписание. Без worker задания не выполняются.

Подключите Orpheus ​

Если Orpheus запущен на той же машине по быстрому старту, используйте готовое локальное подключение. Оно работает через Docker-сеть без публикации дополнительных портов.

Для другого сервера задайте ORPHEUS_BASE_URL и ORPHEUS_API_KEY в .env. Адрес должен быть доступен из контейнеров Space, а ключ — входить в PUBLIC_API_KEYS Orpheus.

В space.toml выберите существующий профиль и шаблон AgentBox. В примере это default и codex. Затем:

sh
docker compose up -d api worker
docker compose ps

Дождитесь healthy у worker. Это подтверждает готовность процесса, но не связь с Orpheus. Её проверяет первое задание. Неверный адрес оставит срабатывание в состоянии «Отправляется» с core_unavailable.

Серверное размещение ​

Разместите веб-интерфейс на отдельном HTTPS-домене и включите SAML. Передайте ORPHEUS_SPACE_UPSTREAM внутренний origin Space API. Веб-образ проксирует /api/, /auth/ и /saml/ к Space. API-ключ в браузер не передаётся.

API и worker используют одинаковые DSN и настройки исполнения. Запускайте один worker. Системный порт 9100 оставьте во внутренней сети. Резервное копирование, проверки и обновление.