Installation manuelle

Utilisez la méthode manuelle lorsque vous souhaitez un contrôle total sur la configuration ou si vous ne pouvez pas exécuter l'installateur interactif.

1. Créer un répertoire de travail

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

2. Télécharger le fichier d’environnement

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

Le fichier Compose associe trois fichiers de configuration de provider ; créez-les (des fichiers vides suffisent) :

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

Si vous prévoyez d'utiliser un point de terminaison personnalisé compatible avec OpenAI ou Ollama, récupérez les configurations d'exemple au lieu des fichiers vides et faites pointer LLM_SERVER_CONFIG_PATH ou OLLAMA_SERVER_CONFIG_PATH dans .env vers /opt/pentagi/conf/custom.provider.yml ou /opt/pentagi/conf/ollama.provider.yml. L'exemple personnalisé nomme des modèles OpenAI, parmi lesquels o3-mini, qu'OpenAI retire le 23 octobre 2026 — définissez le model de chaque agent sur l'un de ceux que votre point de terminaison dessert :

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. Ajouter au moins un LLM provider

Modifiez .env et définissez la clé d'au moins un provider :

OPEN_AI_KEY=your_openai_key
ANTHROPIC_API_KEY=your_anthropic_key
GEMINI_API_KEY=your_gemini_key

D'autres providers — AWS Bedrock, Ollama, DeepSeek, GLM, Kimi, Qwen, MiniMax, Mistral, xAI et les points de terminaison personnalisés — sont décrits dans LLM providers. Les search engines sont optionnels ; DuckDuckGo et Sploitus ne nécessitent aucune clé :

DUCKDUCKGO_ENABLED=true
SPLOITUS_ENABLED=true
TAVILY_API_KEY=your_tavily_key

4. Démarrer la pile

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

L'interface web est accessible à l'adresse https://localhost:8443. Connectez-vous avec [email protected] / admin et changez le mot de passe.

L’interface web et les autres services sont liés à localhost, mais le sandbox de chaque flow publie deux ports de rappel, de 28000 à 29999 par défaut, sur toutes les interfaces de l’hôte Docker, et ufw ne les filtre pas. Sur un hôte accessible par d’autres, restreignez d’abord cette plage — consultez Exposition réseau. Pour mettre à jour l’installation ultérieurement, suivez Mise à niveau.

Piles optionnelles

Chaque service optionnel est fourni sous la forme de son propre fichier Compose que vous superposez au fichier de base :