Manuelle Installation

Verwenden Sie den manuellen Pfad, wenn Sie volle Kontrolle über die Konfiguration haben möchten oder den interaktiven Installer nicht ausführen können.

1. Arbeitsverzeichnis erstellen

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

2. Umgebungsdatei herunterladen

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

Die Compose-Datei bindet drei Provider-Konfigurationsdateien ein; erstellen Sie diese daher – leere Dateien sind ausreichend:

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

Wenn Sie einen benutzerdefinierten OpenAI-kompatiblen Endpunkt oder Ollama verwenden möchten, laden Sie stattdessen die Beispielkonfigurationen herunter und verweisen Sie in .env mit LLM_SERVER_CONFIG_PATH oder OLLAMA_SERVER_CONFIG_PATH auf /opt/pentagi/conf/custom.provider.yml oder /opt/pentagi/conf/ollama.provider.yml. Das benutzerdefinierte Beispiel nennt OpenAI-Modelle, darunter o3-mini, das OpenAI am 23. Oktober 2026 einstellt – setzen Sie die model jedes Agent Type auf eines, das Ihr Endpunkt bereitstellt:

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. Mindestens einen LLM-Provider hinzufügen

Bearbeiten Sie .env und legen Sie den Schlüssel für mindestens einen Provider fest:

OPEN_AI_KEY=your_openai_key
ANTHROPIC_API_KEY=your_anthropic_key
GEMINI_API_KEY=your_gemini_key

Weitere Providers – AWS Bedrock, Ollama, DeepSeek, GLM, Kimi, Qwen, MiniMax, Mistral, xAI und benutzerdefinierte Endpunkte – werden unter LLM-Providers beschrieben. Search Engines sind optional; DuckDuckGo und Sploitus benötigen keinen Schlüssel:

DUCKDUCKGO_ENABLED=true
SPLOITUS_ENABLED=true
TAVILY_API_KEY=your_tavily_key

4. Stack starten

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

Die Web-Benutzeroberfläche ist unter https://localhost:8443 erreichbar. Melden Sie sich mit [email protected] / admin an und ändern Sie das Passwort.

Die Web-UI und die anderen Dienste sind an localhost gebunden, aber die Sandbox jedes Flow veröffentlicht zwei Callback-Ports, standardmäßig von 28000–29999, auf jeder Schnittstelle des Docker-Hosts, und ufw filtert diese nicht. Schränken Sie diesen Bereich zuerst ein, wenn andere auf den Host zugreifen können – siehe Netzwerkexposition. Um die Installation später zu aktualisieren, folgen Sie der Anleitung unter Aktualisierung.

Optionale Stacks

Jeder optionale Dienst wird als eigene Compose-Datei bereitgestellt, die Sie zusätzlich zur Basisdatei einbinden: