Ruční instalace

Manuální postup použijte, pokud chcete mít plnou kontrolu nad konfigurací nebo nemůžete spustit interaktivní instalátor.

1. Vytvoření pracovního adresáře

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

2. Stažení souboru prostředí

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

Soubor compose připojuje tři konfigurační soubory provider, proto je vytvořte — prázdné soubory postačí:

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

Pokud plánujete použít vlastní endpoint kompatibilní s OpenAI nebo Ollama, stáhněte si místo prázdných souborů ukázkové konfigurace a v .env nasměrujte LLM_SERVER_CONFIG_PATH nebo OLLAMA_SERVER_CONFIG_PATH na /opt/pentagi/conf/custom.provider.yml nebo /opt/pentagi/conf/ollama.provider.yml. Ukázková konfigurace pro vlastní nastavení uvádí modely OpenAI, mezi nimi o3-mini, který OpenAI vyřadí 23. října 2026 — nastavte model každého agenta na jeden z modelů, které váš endpoint poskytuje:

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. Přidání alespoň jednoho LLM provider

Upravte .env a nastavte klíč alespoň jednoho provider:

OPEN_AI_KEY=your_openai_key
ANTHROPIC_API_KEY=your_anthropic_key
GEMINI_API_KEY=your_gemini_key

Další providers — AWS Bedrock, Ollama, DeepSeek, GLM, Kimi, Qwen, MiniMax, Mistral, xAI a vlastní endpointy — jsou popsáni v sekci LLM providers. Search engines jsou volitelné; DuckDuckGo a Sploitus nevyžadují žádný klíč:

DUCKDUCKGO_ENABLED=true
SPLOITUS_ENABLED=true
TAVILY_API_KEY=your_tavily_key

4. Spuštění služeb

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

Webové rozhraní je dostupné na adrese https://localhost:8443. Přihlaste se pomocí [email protected] / admin a změňte heslo.

Webové uživatelské rozhraní a ostatní služby jsou svázány s localhost, ale sandbox každého flow publikuje dva callback porty, ve výchozím nastavení z 28000–29999, na všech rozhraních hostitele Dockeru a ufw je nefiltruje. Na hostiteli, který je dosažitelný pro ostatní, nejprve omezte tento rozsah – viz Network exposure. Chcete-li instalaci později aktualizovat, postupujte podle Upgrading.

Volitelné služby

Každá volitelná služba má vlastní soubor compose, který navrstvíte na ten základní: