手動インストール

設定を完全に制御したい場合や、対話型インストーラーを実行できない場合は、手動でのセットアップを行ってください。

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ファイルは3つのprovider設定ファイルをマウントするため、それらを作成してください（空ファイルで問題ありません）。

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

カスタムのOpenAI互換エンドポイントやOllamaを使用する予定がある場合は、空ファイルの代わりにサンプル設定を取得し、.env内のLLM_SERVER_CONFIG_PATHまたはOLLAMA_SERVER_CONFIG_PATHを/opt/pentagi/conf/custom.provider.ymlまたは/opt/pentagi/conf/ollama.provider.ymlに向けます。カスタムの例では、2026年10月23日にOpenAIが退役させるo3-miniを含むOpenAIモデルが指定されています。各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. LLM providerの追加

.envを編集し、少なくとも1つの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、およびカスタムエンドポイント）については、LLM providersで説明されています。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

Web UIはhttps://localhost:8443で提供されます。[email protected] / adminでサインインし、パスワードを変更してください。

Web UI と他のサービスは localhost にバインドされていますが、各 flow の sandbox は、デフォルトで 28000–29999 の2つのコールバックポートを Docker ホストのすべてのインターフェース上で公開し、ufw はそれらをフィルタリングしません。他のユーザーがアクセス可能なホストでは、まずその範囲を制限してください。詳細は Network exposure を参照してください。後でインストールを更新するには、Upgrading に従ってください。

オプションスタック

各オプションサービスは個別のComposeファイルとして提供されており、ベースのスタックに重ねて使用できます。