Pular para o conteúdo
PentAGI
Primeiros passos

Início rápido

Instale o PentAGI com o instalador interativo — requisitos do sistema, download, configuração guiada de providers e search engines, e o primeiro login.

Requisitos do sistema

  • Docker Engine 20 ou posterior com Docker Compose; no Podman, instale manualmente
  • 2 vCPU e 4 GB de RAM no mínimo
  • 25 GB de espaço livre em disco
  • Acesso à internet para imagens e atualizações

Baixe o instalador

O instalador é uma interface de terminal que verifica seu sistema, configura providers e search engines, reforça a segurança da configuração e implanta a pilha.

PlataformaArquivo
Linux amd64installer-latest.zip
Linux arm64installer-latest.zip
Windows amd64installer-latest.zip
macOS Intelinstaller-latest.zip
macOS Apple siliconinstaller-latest.zip

As compilações para macOS são assinadas e notariadas. Se o macOS ainda bloquear o instalador, não ignore o aviso: baixe novamente o arquivo para a sua CPU a partir dos links acima.

Assista primeiro

Uma gravação de terminal do instalador em ação está disponível no asciinema.

Execute-o

mkdir -p ~/pentagi && cd ~/pentagi
uname -sm | sed -e 's,Linux ,linux/,' -e 's,Darwin ,darwin/,' -e s/x86_64/amd64/ -e s/aarch64/arm64/ | xargs -I PLATFORM curl -fLo installer.zip https://pentagi.com/downloads/PLATFORM/installer-latest.zip
unzip -o installer.zip
sudo ./installer

O instalador se comunica com a API do Docker através de /var/run/docker.sock, portanto precisa de root ou de um usuário no grupo docker:

sudo usermod -aG docker $USER
newgrp docker
docker ps

Pertencer ao grupo docker equivale a ter privilégios de root. Conceda essa permissão apenas a usuários confiáveis; para produção, execute o instalador com sudo ou use o Docker sem root.

O instalador percorre as seguintes etapas:

Verificações do sistema — Docker, conectividade de rede e requisitos.

Configuração do ambiente — um arquivo .env com padrões sensatos.

LLM providers — OpenAI, Anthropic, Gemini, Bedrock, Ollama, DeepSeek, GLM, Kimi, Qwen, MiniMax, Mistral, xAI ou um endpoint personalizado.

Search engines — DuckDuckGo, Google, Tavily, Firecrawl, Traversaal, Perplexity, Sploitus, SearXNG.

Reforço de segurança — credenciais geradas e certificados SSL.

Implantação — inicia a pilha com o Docker Compose.

Faça login

Abra https://localhost:8443 e faça login com a conta padrão [email protected] / admin, depois 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–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. Depois, continue com seu primeiro flow; para atualizar a instalação posteriormente, siga Atualização.

Última atualização em