AI-powered penetration testing framework — 53 tools, 9,000+ CVE templates, AutoPilot, scan presets, professional reports
# PentestAI
**AI-powered penetration testing framework.**
Autonomous scanning, 53 tools, 9,000+ CVE templates, self-healing agents, professional reports.
[](https://github.com/blackbuble/pentestai)
[](https://github.com/blackbuble/pentestai/fork)
[](https://github.com/blackbuble/pentestai/releases)
[](https://github.com/blackbuble/pentestai/releases)





> **For authorized penetration testing only.** Always obtain written permission before scanning any target.
---
## Quick Start
```bash
git clone https://github.com/blackbuble/pentestai.git
cd pentestai
bash setup.sh
source .venv/bin/activate
pentestai autopilot http://target.com --report report.html
```
Done. You now have a scan report.
---
## Installation
### Option 1: Auto Setup (recommended)
Best for most users. Works on Linux and macOS.
```bash
git clone https://github.com/blackbuble/pentestai.git
cd pentestai
bash setup.sh
```
What `setup.sh` does:
1. Checks Python 3.11+ is installed
2. Creates a virtual environment (`.venv/`)
3. Installs 12 core dependencies (~30 seconds)
4. Adds `pentestai-activate` alias to your shell
After setup completes:
```bash
source .venv/bin/activate # activate the environment
pentestai guided # start interactive wizard
```
**Want AI or extra features later?** Add them without reinstalling:
```bash
pip install -e ".[ai]" # add