Instalacja ręczna

Skorzystaj z instalacji ręcznej, gdy chcesz mieć pełną kontrolę nad konfiguracją lub nie możesz uruchomić interaktywnego instalatora.

1. Utwórz katalog roboczy

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

2. Pobierz plik środowiskowy

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

Plik compose montuje trzy pliki konfiguracyjne provider, więc je utwórz — puste pliki są w porządku:

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

Jeśli planujesz użyć niestandardowego punktu końcowego zgodnego z OpenAI lub Ollama, pobierz przykładowe konfiguracje zamiast pustych plików i ustaw LLM_SERVER_CONFIG_PATH lub OLLAMA_SERVER_CONFIG_PATH w .env na /opt/pentagi/conf/custom.provider.yml lub /opt/pentagi/conf/ollama.provider.yml. Przykładowa konfiguracja niestandardowa wymienia modele OpenAI, wśród nich o3-mini, który OpenAI wycofuje 23 października 2026 r. — ustaw model każdego agenta na taki, który obsługuje Twój punkt końcowy:

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. Dodaj co najmniej jednego LLM provider

Edytuj .env i ustaw klucz dla co najmniej jednego provider:

OPEN_AI_KEY=your_openai_key
ANTHROPIC_API_KEY=your_anthropic_key
GEMINI_API_KEY=your_gemini_key

Inni providers — AWS Bedrock, Ollama, DeepSeek, GLM, Kimi, Qwen, MiniMax, Mistral, xAI oraz niestandardowe punkty końcowe — są opisani w sekcji LLM providers. Search engines są opcjonalne; DuckDuckGo i Sploitus nie wymagają klucza:

DUCKDUCKGO_ENABLED=true
SPLOITUS_ENABLED=true
TAVILY_API_KEY=your_tavily_key

4. Uruchom usługi

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

Interfejs WWW jest dostępny pod adresem https://localhost:8443. Zaloguj się danymi [email protected] / admin i zmień hasło.

Interfejs webowy i inne usługi są powiązane z localhost, ale każdy sandbox flow publikuje dwa porty callback, domyślnie z zakresu 28000–29999, na każdym interfejsie hosta Docker, a ufw ich nie filtruje. Na hoście dostępnym dla innych najpierw ogranicz ten zakres — zobacz Network exposure. Aby później zaktualizować instalację, postępuj zgodnie z Upgrading.

Usługi opcjonalne

Każda opcjonalna usługa ma własny plik compose, który nakładasz na plik bazowy: