pentest-copilot  by bugbasesecurity

AI-powered browser assistant for ethical hacking

Created 10 months ago
256 stars

Top 98.7% on SourcePulse

GitHubView on GitHub
Project Summary

Summary Pentest Copilot streamlines penetration testing by offering an AI-powered, browser-based assistant. It targets ethical hackers and security professionals, automating tasks and providing intelligent guidance through a unified interface to enhance assessment efficiency.

How It Works The tool utilizes a Docker-orchestrated microservices architecture (Next.js frontend, Node.js backend, databases, optional Kali container). Its agentic AI allows direct command execution within the pentest environment, reducing manual effort. Key advantages include seamless browser-based access, context preservation with summarization, and a dynamic pentest checklist.

Quick Start & Requirements Installation is recommended via setup.sh, followed by Docker Compose. Full stack (incl. Kali): docker compose -f docker-compose.kali.yml up --build -d (~30 min build). Core services: docker compose up --build -d (~12-15 min build). Requires Docker, Node.js v22, 8GB RAM, 20GB disk space. Kali container needs ~2GB RAM. OpenAI API keys are optional but required for AI. Access at http://localhost:3000.

Highlighted Details

  • Browser-Based AI Assistant: No local CLI setup needed.
  • Agentic AI Architecture: AI executes commands directly in the pentest environment.
  • Context Preservation: Maintains session context and provides intelligent summarization.
  • Integrated Terminal Access: Browser-embedded terminal for command execution.
  • VPN Integration: Supports secure remote access via OpenVPN.
  • Workspace Management: Organizes multiple concurrent pentest sessions.
  • Custom Tool Selection: Configurable toolchains for AI command generation.

Maintenance & Community Authored by Dhruva Goyal, Aditya Peela, and Sitaraman Subramanian. A contributing guide and Code of Conduct are provided, suggesting structured community involvement, though specific channels are not detailed.

Licensing & Compatibility Licensed under the MIT License, permitting broad commercial use and integration.

Limitations & Caveats The Kali container is resource-intensive (RAM/disk). OpenAI API keys are essential for AI features. Explicit permission is required for testing. Node.js v22 is a strict requirement.

Health Check
Last Commit

4 days ago

Responsiveness

Inactive

Pull Requests (30d)
3
Issues (30d)
2
Star History
17 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.