Saltar al contenido
PentAGI
Primeros pasos

Inicio rápido

Instala PentAGI con el instalador interactivo: requisitos del sistema, descarga, una configuración guiada de providers y search engines, y el primer inicio de sesión.

Requisitos del sistema

  • Docker Engine 20 o posterior con Docker Compose; en Podman, instalar manualmente
  • 2 vCPU y 4 GB de RAM como mínimo
  • 25 GB de espacio libre en disco
  • Acceso a internet para imágenes y actualizaciones

Descargar el instalador

El instalador es una interfaz de terminal que verifica tu sistema, configura providers y search engines, endurece la configuración y despliega el stack.

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

Las compilaciones para macOS están firmadas y notariadas. Si macOS sigue bloqueando el instalador, no anules la advertencia: descarga de nuevo el archivo para tu CPU desde los enlaces anteriores.

Míralo primero

Hay una grabación de terminal del instalador en funcionamiento en asciinema.

Ejecútalo

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

El instalador se comunica con la API de Docker a través de /var/run/docker.sock, por lo que necesita root o un usuario en el grupo docker:

sudo usermod -aG docker $USER
newgrp docker
docker ps

La pertenencia al grupo docker equivale a root. Concédela solo a usuarios de confianza; para producción, ejecuta el instalador con sudo o usa Docker sin root.

El instalador te guía a través de:

Verificaciones del sistema — Docker, conectividad de red y requisitos.

Configuración del entorno — un archivo .env con valores predeterminados adecuados.

LLM providers — OpenAI, Anthropic, Gemini, Bedrock, Ollama, DeepSeek, GLM, Kimi, Qwen, MiniMax, Mistral, xAI o un punto de conexión personalizado.

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

Endurecimiento de seguridad — credenciales generadas y certificados SSL.

Despliegue — inicia el stack con Docker Compose.

Iniciar sesión

Abre https://localhost:8443 e inicia sesión con la cuenta predeterminada [email protected] / admin, luego cambia la contraseña.

La interfaz web y los demás servicios están vinculados a localhost, pero el sandbox de cada flow publica dos puertos de callback, desde 28000–29999 por defecto, en todas las interfaces del host Docker, y ufw no los filtra. En un host al que otros puedan acceder, restringe primero ese rango — consulta Exposición de red. Luego continúa con tu primer flow; para actualizar la instalación más adelante, sigue Actualización.

Última actualización el