MCPcopy Index your code
hub / github.com/OpenRCE/sulley

github.com/OpenRCE/sulley @v1.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.0 ↗ · + Follow
384 symbols 1,145 edges 55 files 226 documented · 59%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

What?

Sulley is an actively developed fuzzing engine and fuzz testing framework consisting of multiple extensible components. Sulley (IMHO) exceeds the capabilities of most previously published fuzzing technologies, commercial and public domain. The goal of the framework is to simplify not only data representation but to simplify data transmission and instrumentation. Sulley is affectionately named after the creature from Monsters Inc., because, well, he is fuzzy.

He's also fearless

Clearly he's also fearless.

Why?

Modern day fuzzers are, for the most part, solely focus on data generation. Sulley not only has impressive data generation but has taken this a step further and includes many other important aspects a modern fuzzer should provide. Sulley watches the network and methodically maintains records. Sulley instruments and monitors the health of the target, capable of reverting to a known good state using multiple methods. Sulley detects, tracks and categorizes detected faults. Sulley can fuzz in parallel, significantly increasing test speed. Sulley can automatically determine what unique sequence of test cases trigger faults. Sulley does all this, and more, automatically and without attendance. It's not usual for a fuzz to run seamlessly for days at a time, that way you (as the vulnerability researcher) can focus on other areas of exploitation, and come back to Sulley's results when they're convenient for you.

Awesome! Where do I start?

Well a good place to start if you're on windows is the wiki article on Windows setup, and if you're feeling ballsy check out the unstable branch of Sulley If you're on nix, sit tight, the docs are coming for the installation procedure for that, but if you use nix, chances are you can probably figure it out on your own.

Some notes

This master branch is considered the 'stable' branch of Sulley 1.0, all the changes that I make are going into Sulley 1.1, which can be found at https://github.com/OpenRCE/sulley/tree/Sulley1.1.

If you have any other questions/improvements/features you'd like to see feel free to email me!

Core symbols most depended-on inside this repo

s_static
called by 332
sulley/__init__.py
s_delim
called by 302
sulley/__init__.py
s_string
called by 240
sulley/__init__.py
s_initialize
called by 81
sulley/__init__.py
s_block_start
called by 61
sulley/__init__.py
s_block_end
called by 61
sulley/__init__.py
s_word
called by 43
sulley/__init__.py
log
called by 42
vmcontrol.py

Shape

Method 268
Function 67
Class 49

Languages

Python100%

Modules by API surface

sulley/sessions.py42 symbols
sulley/primitives.py41 symbols
vmcontrol.py37 symbols
sulley/blocks.py34 symbols
sulley/pgraph/graph.py28 symbols
sulley/__init__.py28 symbols
process_monitor.py20 symbols
process_monitor_unix.py19 symbols
sulley/pedrpc.py16 symbols
network_monitor.py16 symbols
sulley/legos/dcerpc.py10 symbols
sulley/instrumentation.py9 symbols

For agents

$ claude mcp add sulley \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page