shannon  by KeygraphHQ

AI pentester autonomously finds and exploits web app vulnerabilities

Created 4 months ago
4,300 stars

Top 11.4% on SourcePulse

GitHubView on GitHub
Project Summary

Summary

Shannon is an AI-powered penetration testing tool designed to autonomously discover and exploit vulnerabilities in web applications. It addresses the critical security gap between infrequent manual penetration tests by providing continuous, on-demand white-box analysis. This allows development teams to identify and fix exploitable flaws before deployment, enabling them to ship code with greater confidence and security.

How It Works

Shannon emulates a human penetration tester using a sophisticated multi-agent architecture. It combines deep white-box source code analysis with black-box dynamic exploitation across four distinct phases: reconnaissance, vulnerability analysis, exploitation, and reporting. Specialized AI agents analyze the application's codebase and infrastructure, then perform live, browser-based attacks to confirm hypothesized vulnerabilities with concrete proof-of-concept exploits, minimizing false positives.

Quick Start & Requirements

  • Installation: Primarily deployed via Docker.
  • Prerequisites: Requires a Claude Console account with credits or an Anthropic API key, and Docker installed. The tool operates in a white-box capacity, necessitating access to the target application's source code.
  • Links: Website: https://keygraph.io, Discord: https://discord.gg/aWY8rRUCxc.

Highlighted Details

  • Achieved a 96.15% success rate on the XBOW Benchmark, identifying actual exploits.
  • Fully autonomous operation handles complex authentication (2FA, Google Sign-in) and browser navigation without intervention.
  • Delivers pentester-grade reports featuring reproducible, copy-and-paste Proof-of-Concepts for actionable findings.
  • Covers critical OWASP vulnerabilities including Injection, XSS, SSRF, and Broken Authentication/Authorization.
  • Leverages code-aware analysis to guide dynamic exploitation and integrates tools like Nmap and Subfinder.
  • Parallel processing accelerates analysis and exploitation phases.

Maintenance & Community

  • Community: Active community support via Discord (https://discord.gg/aWY8rRUCxc). Bug reporting via GitHub Issues and feature suggestions via GitHub Discussions.
  • Stay Connected: Follow on Twitter (@KeygraphHQ) and LinkedIn (Keygraph). Visit the website at keygraph.io.

Licensing & Compatibility

  • Shannon Lite: Released under the GNU Affero General Public License v3.0 (AGPL-3.0). This license permits free internal use and private modification but requires open-sourcing modifications if the software is offered as a public or managed service.
  • Compatibility: Designed for white-box testing, requiring source code access. AGPL-3.0 has copyleft implications for service providers.

Limitations & Caveats

Shannon is strictly white-box and requires source code access. Its exploitation agents actively modify targets, making it unsuitable for production environments. While engineered to minimize false positives, human oversight is recommended for LLM-generated reports. Shannon Lite focuses on actively exploitable vulnerabilities and may not cover all security risks, such as vulnerable third-party libraries; Shannon Pro offers more comprehensive analysis. A full run can take 1-1.5 hours and incur costs (~$50 USD with Claude 4.5 Sonnet).

Health Check
Last Commit

1 week ago

Responsiveness

Inactive

Pull Requests (30d)
13
Issues (30d)
8
Star History
888 stars in the last 30 days

Explore Similar Projects

Starred by Chip Huyen Chip Huyen(Author of "AI Engineering", "Designing Machine Learning Systems"), Wei-Lin Chiang Wei-Lin Chiang(Cofounder of LMArena), and
13 more.

awesome-tensor-compilers by merrymercy

0.1%
3k
Curated list of tensor compiler projects and papers
Created 5 years ago
Updated 1 year ago
Starred by Shengjia Zhao Shengjia Zhao(Chief Scientist at Meta Superintelligence Lab), Chip Huyen Chip Huyen(Author of "AI Engineering", "Designing Machine Learning Systems"), and
14 more.

BIG-bench by google

0.1%
3k
Collaborative benchmark for probing and extrapolating LLM capabilities
Created 5 years ago
Updated 1 year ago
Starred by Lysandre Debut Lysandre Debut(Chief Open-Source Officer at Hugging Face), Shizhe Diao Shizhe Diao(Author of LMFlow; Research Scientist at NVIDIA), and
14 more.

simpletransformers by ThilinaRajapakse

0.0%
4k
Rapid NLP task implementation
Created 6 years ago
Updated 5 months ago
Starred by Aravind Srinivas Aravind Srinivas(Cofounder of Perplexity), Chip Huyen Chip Huyen(Author of "AI Engineering", "Designing Machine Learning Systems"), and
16 more.

text-to-text-transfer-transformer by google-research

0.1%
6k
Unified text-to-text transformer for NLP research
Created 6 years ago
Updated 3 weeks ago
Starred by Vaibhav Nivargi Vaibhav Nivargi(Cofounder of Moveworks), Chuan Li Chuan Li(Chief Scientific Officer at Lambda), and
5 more.

awesome-mlops by visenger

0.3%
14k
Curated MLOps knowledge hub
Created 6 years ago
Updated 1 year ago
Feedback? Help us improve.