How shashishekhardixit/pentagi works
PentAGI is a self-hosted autonomous penetration-testing system. A user configures and starts a flow through the web interface or API; specialized agents use language models, research and security tools, and an isolated Docker sandbox, then retain findings and produce reports. PostgreSQL/pgvector provides durable state and memory, with optional Graphiti knowledge-graph and observability integrations. The README documents these capabilities, but sampled backend files do not expose their call sites, so most backend links are documented high-level relationships rather than verified function calls.
Main entry points: flow.go Flow Control · app.tsx Web Interface · router.go REST and GraphQL · handlers.go Agent Providers
Components 14
User Access
- Web Interface
frontend/src/app.tsx - File Manager
frontend/src/components/shared/file-manager/file-manager.tsx - REST and GraphQL
backend/pkg/server/router.go
Agent Execution
- Flow Control
backend/pkg/controller/flow.go - Agent Providers
backend/pkg/providers/handlers.go - Security Tools
backend/pkg/tools/tools.go - Docker Sandbox
backend/pkg/docker/sandbox.go - Findings and Reports
backend/pkg/templates/templates.go
Memory and Monitoring
- PostgreSQL Memory
backend/pkg/database/database.go - Knowledge Graph
backend/pkg/graphiti/client.go - Observability
backend/pkg/observability/collector.go
Setup and Operations
- Installer Wizard
backend/cmd/installer/wizard/app.go - Install Processor
backend/cmd/installer/processor/processor.go
Other components
- Security Operator
Connections 13
- Security Operator → Web Interface: configures tests
- Security Operator → REST and GraphQL: automates via
- Web Interface → File Manager: manages files
- REST and GraphQL → Flow Control: starts flows
- Flow Control → Agent Providers: delegates tasks
- Agent Providers → Security Tools: uses tools
- Security Tools → Docker Sandbox: executes isolated
- Flow Control → PostgreSQL Memory: stores results
- PostgreSQL Memory → Knowledge Graph: retains context
- Flow Control → Findings and Reports: generates findings
- Flow Control → Observability: emits telemetry
- Security Operator → Installer Wizard: sets up system
- Installer Wizard → Install Processor: applies configuration