Skip to main content

AI-powered Python fuzzer using Gemini and Atheris to automatically generate and execute fuzzing harnesses.

Project description

Geminis:

This project creates a LLM-assisted Python fuzzing harness generator designed to leverage large language models like Gemini to automatically build fuzzing harnesses for target Python functions. It uses Google’s Atheris fuzzing engine to dynamically generate and test code, with the aim of uncovering bugs or vulnerabilities in software.

Usage:

geminis
--src-dir /path/to/code
--output-dir /path/to/logs
--prompts-path /path/to/prompts.yaml
--api-key /path/to/api.txt
--prompt prompt-id (base if using given yaml prompts)
--mode functions(classes)
--debug Outputs detailed debug statements
--smell Uses optional radon code smell using the maintainability index

Workflow:

  1. Load API key (enviorment variable, file, raw string), verify model.
  2. Discover .py files; parse target snippets.
  3. (Optional) Filter by maintainability index by radon.
  4. Build prompt with Atheris docs + code; send to Gemini.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

geminis-0.1.49.tar.gz (22.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

geminis-0.1.49-py3-none-any.whl (25.3 kB view details)

Uploaded Python 3

File details

Details for the file geminis-0.1.49.tar.gz.

File metadata

  • Download URL: geminis-0.1.49.tar.gz
  • Upload date:
  • Size: 22.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for geminis-0.1.49.tar.gz
Algorithm Hash digest
SHA256 fd6b68c2e4dcf6dc844ad5afde425624ba4162a7f2d5636c7b55e396173e755f
MD5 c9534c75a03361d8c283577355e9de78
BLAKE2b-256 3dd2f76637cd63a4d83f5afa04fba37b43d1ede4288fa6abae346e0e1d1a8f5f

See more details on using hashes here.

Provenance

The following attestation bundles were made for geminis-0.1.49.tar.gz:

Publisher: publish.yml on mariobx/Geminis

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file geminis-0.1.49-py3-none-any.whl.

File metadata

  • Download URL: geminis-0.1.49-py3-none-any.whl
  • Upload date:
  • Size: 25.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for geminis-0.1.49-py3-none-any.whl
Algorithm Hash digest
SHA256 80142becbb256e3ddaeed6d83753d37ee4f132c2a7862605794da3d742e6a811
MD5 7626e9d771242758e8c9bf4a662b0791
BLAKE2b-256 fdd2cbbe455d3218ad20b1fad40ae3197e7b72099444b83605ed68ae698399e2

See more details on using hashes here.

Provenance

The following attestation bundles were made for geminis-0.1.49-py3-none-any.whl:

Publisher: publish.yml on mariobx/Geminis

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page