Ручная установка

Используйте ручную установку, если вам необходим полный контроль над конфигурацией или вы не можете запустить интерактивный установщик.

1. Создайте рабочий каталог

mkdir -p ~/pentagi && cd ~/pentagi

2. Загрузите файл окружения

test -f .env || curl -fo .env.new https://raw.githubusercontent.com/vxcontrol/pentagi/main/.env.example
test -f .env.new && openssl rand -hex 32 | xargs -I VALUE sed -E -i.bak 's/^COOKIE_SIGNING_SALT=salt( .*)?$/COOKIE_SIGNING_SALT=VALUE/' .env.new
test -f .env.new && openssl rand -hex 16 | xargs -I VALUE sed -E -i.bak 's/^PENTAGI_POSTGRES_PASSWORD=postgres( .*)?$/PENTAGI_POSTGRES_PASSWORD=VALUE/' .env.new
test -f .env || mv .env.new .env

Файл compose подключает три файла конфигурации provider, поэтому создайте их — пустые файлы тоже подойдут:

touch example.custom.provider.yml example.ollama.provider.yml example.bedrock.provider.yml

Если вы планируете использовать пользовательскую OpenAI-совместимую конечную точку или Ollama, загрузите примеры конфигураций вместо пустых файлов и укажите LLM_SERVER_CONFIG_PATH или OLLAMA_SERVER_CONFIG_PATH в .env на /opt/pentagi/conf/custom.provider.yml или /opt/pentagi/conf/ollama.provider.yml. В примере для пользовательской настройки указаны модели OpenAI, среди которых o3-mini, которую OpenAI выведет из эксплуатации 23 октября 2026 года — установите для каждого agent type model одну из моделей, которые обслуживает ваша конечная точка:

curl -o example.custom.provider.yml https://raw.githubusercontent.com/vxcontrol/pentagi/main/examples/configs/custom-openai.provider.yml
curl -o example.ollama.provider.yml https://raw.githubusercontent.com/vxcontrol/pentagi/main/examples/configs/ollama-llama318b.provider.yml

3. Добавьте хотя бы одного provider LLM

Отредактируйте .env и укажите ключ как минимум для одного provider:

OPEN_AI_KEY=your_openai_key
ANTHROPIC_API_KEY=your_anthropic_key
GEMINI_API_KEY=your_gemini_key

Другие providers — AWS Bedrock, Ollama, DeepSeek, GLM, Kimi, Qwen, MiniMax, Mistral, xAI и пользовательские конечные точки — описаны в разделе Providers LLM. Search engines необязательны; для DuckDuckGo и Sploitus ключ не требуется:

DUCKDUCKGO_ENABLED=true
SPLOITUS_ENABLED=true
TAVILY_API_KEY=your_tavily_key

4. Запустите стек

curl -O https://raw.githubusercontent.com/vxcontrol/pentagi/main/docker-compose.yml
test -f .env && docker compose up -d

Веб-интерфейс доступен по адресу https://localhost:8443. Войдите в систему, используя [email protected] / admin, и смените пароль.

Веб-интерфейс и другие службы привязаны к localhost, но sandbox каждого flow публикует два порта обратного вызова, по умолчанию от 28000 до 29999, на всех интерфейсах Docker-хоста, и ufw их не фильтрует. На хосте, доступном другим, сначала ограничьте этот диапазон — см. Сетевая доступность. Чтобы позже обновить установку, следуйте инструкциям Обновление.

Дополнительные стеки

Каждый дополнительный сервис поставляется в виде отдельного compose-файла, который накладывается поверх базового: