Vai al contenuto
PentAGI
Per iniziare

Avvio rapido

Installa PentAGI con l'installer interattivo: requisiti di sistema, download, una configurazione guidata di providers e search engines, e il primo accesso.

Requisiti di sistema

  • Docker Engine 20 o successivo con Docker Compose; su Podman, installa manualmente
  • Almeno 2 vCPU e 4 GB di RAM
  • 25 GB di spazio libero su disco
  • Accesso a Internet per le immagini e gli aggiornamenti

Scarica l'installer

L'installer è un'interfaccia da terminale che verifica il tuo sistema, configura i providers e i search engines, applica le misure di sicurezza e distribuisce lo stack.

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

Le build per macOS sono firmate e notarizzate. Se macOS blocca comunque l'installer, non ignorare l'avviso: scarica di nuovo l'archivio per la tua CPU dai link sopra indicati.

Anteprima

Una registrazione da terminale dell'installer in azione è disponibile su asciinema.

Esecuzione

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

L'installer comunica con le API Docker tramite /var/run/docker.sock, quindi richiede i privilegi di root o un utente appartenente al gruppo docker:

sudo usermod -aG docker $USER
newgrp docker
docker ps

L'appartenenza al gruppo docker equivale ai privilegi di root. Concedila solo ad utenti fidati; per la produzione, esegui l'installer con sudo oppure usa Docker in modalità rootless.

L'installer ti guiderà attraverso:

Verifiche di sistema — Docker, connettività di rete e requisiti.

Configurazione dell'ambiente — un file .env con valori predefiniti ottimali.

LLM providers — OpenAI, Anthropic, Gemini, Bedrock, Ollama, DeepSeek, GLM, Kimi, Qwen, MiniMax, Mistral, xAI o un endpoint personalizzato.

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

Rafforzamento della sicurezza — generazione delle credenziali e dei certificati SSL.

Distribuzione — avvio dello stack con Docker Compose.

Accesso

Apri https://localhost:8443 e accedi con l'account predefinito [email protected] / admin, quindi cambia la password.

L’interfaccia web e gli altri servizi sono vincolati a localhost, ma il sandbox di ogni flow pubblica due porte di callback, da 28000–29999 per impostazione predefinita, su tutte le interfacce dell’host Docker, e ufw non le filtra. Su un host raggiungibile da altri, limita prima quell’intervallo — vedi Esposizione alla rete. Prosegui quindi con il tuo primo flow; per aggiornare l’installazione in seguito, segui Aggiornamento.

Ultimo aggiornamento il