GreyDGL /PentestGPT
Automated Penetration Testing Agentic Framework Powered by Large Language Models
★ 16,429⑂ 2,878👁 378⑃ 175● 338▤ 11
+9
Daily
16,429
stars
2,878
forks
378
watchers
175
prs
338
issues
11
releases
README
[![Contributors][contributors-shield]][contributors-url]
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![Issues][issues-shield]][issues-url]
[![MIT License][license-shield]][license-url]
[![Discord][discord-shield]][discord-url]
PentestGPT
AI-Powered Autonomous Penetration Testing Agent
Published at USENIX Security 2024
Official Website: pentestgpt.com »
Research Paper
·
Report Bug
·
Request Feature
---
Demo
Installation
Watch on YouTube
PentestGPT in Action
Watch on YouTube
---
What's New in v1.0 (Agentic Upgrade)
- Multi-Stage Pipeline - The agent works through staged phases (recon → exploit → walkthrough for CTF; asset discovery → vulnerability identification → report for pentests), feeding each stage's findings into the next.
- Autonomous Agent - Drives Claude Code or Codex to run tools and reason without human intervention.
- Session Persistence - Save and resume penetration testing sessions.
The autonomous CTF pipeline is backend-pluggable for Claude Code and Codex. The interactive
modernized legacy mode (pentestgpt-legacy) supports a wider provider set: OpenAI, Anthropic,
Google Gemini, DeepSeek, xAI, Qwen, Moonshot, and local Ollama. See
Interactive Multi-LLM Mode.
---
Features
- AI-Powered Challenge Solver - Leverages LLM advanced reasoning to perform penetration testing and CTFs
- Live Walkthrough - Tracks steps in real-time as the agent works through challenges
- Multi-Category Support - Web, Crypto, Reversing, Forensics, PWN, Privilege Escalation
- Real-Time Feedback - Watch the AI work with live activity updates
- Extensible Architecture - Clean, modular design ready for future enhancements
---
Quick Start
Prerequisites
- Python 3.12+
- uv - Python package manager
- Claude Code CLI (claude) - installed and authenticated for local Claude runs. See Claude Code docs
- Codex CLI (codex) - installed and authenticated for local Codex runs. The Docker flow below bundles both CLIs.
Installation
bash
git clone https://github.com/GreyDGL/PentestGPT.git
cd PentestGPT
make install runs uv sync
Commands Reference
| Command | Description |
|---------|-------------|
| make install | Install dependencies |
| make test | Run all tests |
| make check | Run lint + typecheck |
| make build | Build distributable package |
---
Usage
bash
Run against a target (CTF mode by default)
pentestgpt --target 10.10.11.234
With challenge context
pentestgpt --target 10.10.11.50 --instruction "WordPress site, focus on plugin vulnerabilities"
Penetration-test mode (asset discovery → vulnerabilities → report)
pentestgpt --target 10.10.11.234 --mode pentest
List previously saved sessions
pentestgpt --list-sessions
The agent works through a multi-stage pipeline, feeding each stage's findings into the next — recon → exploit → walkthrough for CTF, asset discovery → vulnerability identification → report for pentest.
Top issues
#530Instagram ID hacking27 comments · 2026-08-16#547Hack mobile number9 comments · 2026-09-04#254OpenAI API Key not accepted ?8 comments · 2024-11-30#561betting app5 comments · 2026-09-21#494How to interact with PentestGPT legacy5 comments · 2026-07-13#299Issue with navigation in PentestGPT (next command not proceeding)5 comments · 2025-09-01#253Can't Start PentestGPT5 comments · 2024-11-21#565Facebook id hack4 comments · 2026-10-19
Discussions
#541Can you help me hack anything1 comments · 2026-08-25#527Tggh0 comments · 2026-08-11#504help in installation2 comments · 2026-07-23#461Pentest1 comments · 2026-05-23#423Can we get a PDF Report for POC0 comments · 2026-02-25#419Why Don't use kali as base !0 comments · 2026-02-16#409ছবি দুইটা একসাথে চাই0 comments · 2026-02-10#405how to hack a wife1 comments · 2026-02-08
Latest release
v1.0.0 v1.0.0 2025-12-24Highlights - Agentic penetration testing pipeline - Terminal UI with real-time activity feed - 86.5% success rate on XBOW benchmark (90/104) - Docker-based deployment See benchmark results for details."