Instalação manual

Use o caminho manual quando você quiser controle total sobre a configuração ou não puder executar o instalador interativo.

1. Crie um diretório de trabalho

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

2. Baixe o arquivo de ambiente

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

O arquivo compose monta três arquivos de configuração de provider, então crie-os — arquivos vazios servem:

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

Se você planeja usar um endpoint customizado compatível com OpenAI ou o Ollama, baixe as configurações de exemplo em vez de usar arquivos vazios e aponte LLM_SERVER_CONFIG_PATH ou OLLAMA_SERVER_CONFIG_PATH no .env para /opt/pentagi/conf/custom.provider.yml ou /opt/pentagi/conf/ollama.provider.yml. O exemplo customizado nomeia modelos da OpenAI, entre eles o3-mini, que a OpenAI descontinuará em 23 de outubro de 2026 — defina o model de cada agent type como um que seu endpoint sirva:

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. Adicione pelo menos um LLM provider

Edite o .env e defina a chave de pelo menos um provider:

OPEN_AI_KEY=your_openai_key
ANTHROPIC_API_KEY=your_anthropic_key
GEMINI_API_KEY=your_gemini_key

Outros providers — AWS Bedrock, Ollama, DeepSeek, GLM, Kimi, Qwen, MiniMax, Mistral, xAI e endpoints customizados — são descritos em LLM providers. Os search engines são opcionais; DuckDuckGo e Sploitus não precisam de chave:

DUCKDUCKGO_ENABLED=true
SPLOITUS_ENABLED=true
TAVILY_API_KEY=your_tavily_key

4. Inicie a stack

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

A interface web é servida em https://localhost:8443. Faça login com [email protected] / admin e altere a senha.

A interface web e os outros serviços ficam restritos ao localhost, mas o sandbox de cada flow publica duas portas de callback, de 28000 a 29999 por padrão, em todas as interfaces do host Docker, e o ufw não as filtra. Em um host acessível por outras pessoas, restrinja primeiro esse intervalo — veja Exposição de rede. Para atualizar a instalação posteriormente, siga Atualização.

Stacks opcionais

Cada serviço opcional vem com seu próprio arquivo compose que você adiciona em camadas sobre o arquivo base: