Architectuur — PentAGI

De services die PentAGI draait, hoe ze met elkaar communiceren en wat optioneel is.

PentAGI bestaat uit een set Docker-services. De kernstack is voldoende om flows uit te voeren; de knowledge graph- en observability-stacks zijn optionele toevoegingen.

Systeemcontext

Binnen twee minuten na het starten en vervolgens elke drie uur controleert PentAGI ook update.pentagi.com op een nieuwere build en stuurt een samenvatting van de installatie mee met het verzoek; Update check geeft aan wat erin staat en hoe je het kunt uitschakelen.

Services

Groep	Services	Compose-bestand
Kern	`pentagi` (Go-backend met REST en GraphQL, React-UI), `pgvector` (PostgreSQL met pgvector), `pgexporter` (PostgreSQL-metrieken), `scraper` (geïsoleerde browser)	`docker-compose.yml`
Knowledge graph	`graphiti`, `neo4j`	`docker-compose-graphiti.yml`
LLM-observability	`langfuse-web`, `langfuse-worker`, `clickhouse`, `redis`, `minio`, `postgres`	`docker-compose-langfuse.yml`
Systeemobservability	`grafana`, `otel`, `victoriametrics`, `jaeger`, `clickstore`, `loki`, `node-exporter`, `cadvisor`	`docker-compose-observability.yml`

Tools draaien nooit in de pentagi-container zelf: elke flow krijgt zijn eigen sandbox-container, gebouwd op basis van een image die is gekozen voor het doel van de flow, zoals Kali Linux.

Containers

Backend-API — Go, met REST en GraphQL en Bearer-token-toegang voor automatisering.
Vector store — PostgreSQL met pgvector bewaart elk commando, elke output en elke embedding.
Agents — het multi-agentsysteem dat het werk plant en uitvoert; zie Agents.
Sandbox — toolcontainers die geïsoleerd zijn van de host; in productie kunnen ze op een aparte worker node draaien.