makes fuzz tests as easy as unit tests
Docs | Glossary | Examples | Website | Blog | Twitter | YouTube
IMPORTANT: This project is under active development. Be aware that the behavior of the commands or the configuration can change.
cifuzz is a CLI tool that helps you to integrate and run fuzzing based tests into your project.
- Easily set up, create and run fuzz tests
- Generate coverage reports that can be integrated in your IDE
- Supports multiple programming languages and build systems
If you are new to the world of fuzzing, we recommend you to take a look at our Glossary and our example projects.
Read the getting started guide if you just want to learn how to fuzz your applications with cifuzz.
You can get the latest release from GitHub or by running our install script:
sh -c "$(curl -fsSL https://raw.githubusercontent.com/CodeIntelligenceTesting/cifuzz/main/install.sh)"If you are using Windows you can download the latest release and execute it.
By default, cifuzz gets installed in your home directory under cifuzz.
You can customize the installation directory with ./cifuzz_installer -i /target/dir.
Do not forget to add the installation's bin directory to your PATH.
Depending on your language / build system of choice cifuzz has different prerequisites:
C/C++ (with CMake)
Ubuntu / Debian
sudo apt install cmake clang llvmArch
sudo pacman -S cmake clang llvmmacOS
brew install cmake llvmWindows
At least Visual Studio 2022 version 17 is required.
choco install cmake llvmJava with Maven
Ubuntu / Debian
sudo apt install openjdk mavenArch
sudo pacman -S jdk-openjdk mavenmacOS
brew install openjdk mavenWindows
choco install microsoft-openjdk mavenJava with Gradle
Ubuntu / Debian
sudo apt install openjdk gradleArch
sudo pacman -S jdk-openjdk gradlemacOS
brew install openjdk gradleWindows
choco install microsoft-openjdk gradleWant to help improve cifuzz? Check out our contributing documentation. There you will find instructions for building the tool locally.
If you find an issue, please report it on the issue tracker.