vxcontrol/pentagi repository overview

⁠PentAGI - AI-Powered Penetration Testing

Penetration testing Artificial General Intelligence - A fully autonomous AI Agent capable of performing complex penetration testing tasks using terminal, browser, editor, and external search systems.

⁠Key Features

• 🛡️ Secure & Isolated: All operations are performed in a sandboxed Docker environment
• 🤖 Fully Autonomous: AI-powered agent that automatically determines and executes testing steps
• 🔬 Professional Tools: Built-in suite of 20+ security tools (nmap, metasploit, sqlmap, etc.)
• 🧠 Smart Memory: Long-term storage of research results and successful approaches
• 🔍 Web Intelligence: Built-in browser for gathering latest information
• 🔎 External Search: Integration with Tavily, Traversaal, and Google Custom Search
• 👥 Team of Specialists: Specialized AI agents for research, development, and infrastructure
• 📊 Monitoring: Integration with Grafana/Prometheus for real-time observation
• 📝 Reporting: Detailed vulnerability reports with exploitation guides

⁠Quick Start

1. Create a working directory:

mkdir pentagi && cd pentagi

2. Download configuration files:

curl -O https://raw.githubusercontent.com/vxcontrol/pentagi/master/.env.example
curl -O https://raw.githubusercontent.com/vxcontrol/pentagi/master/docker-compose.yml

3. Configure environment:

cp .env.example .env
# Edit .env file with your API keys and settings

4. Run PentAGI:

docker compose up -d

5. Access the UI at https://localhost:8443⁠ (default is [email protected] / admin)

⁠Required Environment Variables

• OPEN_AI_KEY or ANTHROPIC_API_KEY: At least one LLM provider key

⁠Optional Environment Variables

• GOOGLE_API_KEY & GOOGLE_CX_KEY: For Google search integration
• TAVILY_API_KEY: For Tavily search integration
• TRAVERSAAL_API_KEY: For Traversaal search integration
• PROXY_URL: Global proxy for external services
• PUBLIC_URL: Public URL of your server
• PENTAGI_POSTGRES_USER & PENTAGI_POSTGRES_PASSWORD: PostgreSQL credentials
• SERVER_SSL_CRT & SERVER_SSL_KEY: Custom SSL certificate paths

⁠System Requirements

• Docker Engine 24.0+
• Docker Compose v2.0+
• 4GB RAM minimum
• 20GB disk space
• Internet access

⁠Additional Features

⁠Monitoring Stack

• OpenTelemetry for data collection
• Grafana for visualization (port 3000)
• VictoriaMetrics for metrics
• Jaeger for tracing
• Loki for logs

Quick setup:

# 1. Enable OpenTelemetry integration
echo "OTEL_HOST=otelcol:8148" >> .env

# 2. Download and start the monitoring stack
curl -O https://raw.githubusercontent.com/vxcontrol/pentagi/master/docker-compose-observability.yml
docker compose -f docker-compose.yml -f docker-compose-observability.yml up -d

Access Grafana at http://localhost:3000⁠

Learn more about monitoring setup →⁠

⁠Analytics Platform

• Langfuse for LLM observability (port 4000)
• ClickHouse for analytics
• Redis for caching
• MinIO for storage

Quick setup:

# 1. Enable Langfuse integration
echo "LANGFUSE_BASE_URL=http://langfuse-web:3000" >> .env

# 2. Download and start the analytics stack
curl -O https://raw.githubusercontent.com/vxcontrol/pentagi/master/docker-compose-langfuse.yml
docker compose -f docker-compose.yml -f docker-compose-langfuse.yml up -d

Access Langfuse at http://localhost:4000⁠

Learn more about analytics setup →⁠

⁠Documentation

Full documentation available at:

• GitHub Repository: vxcontrol/pentagi⁠
• Documentation: docs.pentagi.com⁠

⁠Support

• Report issues on GitHub⁠
• Join discussions on GitHub Discussions⁠
• Mail to [email protected]⁠

⁠License

Copyright (c) PentAGI Development Team. MIT License⁠