Skip to main content

Automated red-team discovery for AI models

Project description

probegpt

Automated red-team discovery for AI models. Generates adversarial probe prompts across 8 attack strategies, sends them to a target model, judges responses against your objective, and iteratively refines the best-scoring probes using intelligent seed grading.

Install

pipx install probegpt

Usage

probegpt

Full-screen TUI. Set up your models in Config, then go to Run Discovery, enter your objective, and hit Run.

Models

Any of the following providers can be assigned independently to the target, generator, and judge roles:

Provider Auth
Azure OpenAI az login
OpenRouter OPENROUTER_API_KEY env var
GCP Vertex AI gcloud auth application-default login
AWS Bedrock aws configure
Cerebras CEREBRAS_API_KEY env var
Mistral MISTRAL_API_KEY env var

Config is saved to ~/.outofthebox/config.json.

How it works

  1. Loads 9 seed probes covering known red-team techniques
  2. Each iteration distributes candidates across all enabled attack strategies (weighted)
  3. Every probe is sent to the target model; the judge scores the response 0.0 → 1.0
  4. Probes scoring ≥ 0.5 are sent to the seed grader, which analyzes why the probe worked and extracts technique tags
  5. Novel, high-transferability probes are added to a weighted seed pool; the generator is told which techniques are working
  6. Results optionally exported to JSON

Attack strategies

Eight strategies run in parallel each iteration. Candidates are distributed proportionally to their configured weights.

Strategy Technique family
objective Fresh probes written directly for the objective
mutation Variations of high-scoring seeds from the pool
encoding base64, ROT13, leetspeak, fragmentation, reversal — half LLM-generated, half programmatic
roleplay Evil-twin personas, simulation frames, nested hierarchy, game context
persuasion Emotional appeal, urgency, flattery, logical fallacy, social proof
linguistic Typos, phonetic spelling, double negatives, logic tricks, passive voice
structural Payload splitting, chain-of-thought hijack, prefix/suffix injection, context stuffing
distraction Benign prefix, topic pivot, attention splitting, distract-and-attack

Enable/disable strategies and adjust their relative weights in Config → Strategies.

Intelligent seed grading

After each successful probe (score ≥ 0.5), an LLM agent analyzes it and assigns:

  • technique tags — what made it work (57-tag vocabulary)
  • novelty — how different it is from existing seeds (duplicates are discarded)
  • transferability — how likely the technique generalises to other objectives

From iteration 2 onward, the generator receives the top working technique tags as a feedback hint, and mutation sampling weights toward high-scoring, novel, transferable seeds.

Requirements

  • Python 3.11+
  • At least one configured provider for each role (target, generator, judge)

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

probegpt-0.3.0.tar.gz (45.6 kB view details)

Uploaded Source

Built Distribution

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

probegpt-0.3.0-py3-none-any.whl (54.4 kB view details)

Uploaded Python 3

File details

Details for the file probegpt-0.3.0.tar.gz.

File metadata

  • Download URL: probegpt-0.3.0.tar.gz
  • Upload date:
  • Size: 45.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.2

File hashes

Hashes for probegpt-0.3.0.tar.gz
Algorithm Hash digest
SHA256 1e10edbf839a18836804304ccadb03a83ecc85cf1ec58fecbbec0988fc432b51
MD5 3e6343c126786e85f81a3f55ee178346
BLAKE2b-256 82f1658187c3d1abb256483c42fe4e45ece181e65b7ca233c9d246e4810666f8

See more details on using hashes here.

File details

Details for the file probegpt-0.3.0-py3-none-any.whl.

File metadata

  • Download URL: probegpt-0.3.0-py3-none-any.whl
  • Upload date:
  • Size: 54.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.2

File hashes

Hashes for probegpt-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 783f8cf7e4eabd3727b6f1b6bd5ceb98cad89d76342588958027ba540b89c2b5
MD5 d517fd4417ea14ad061cea7b652b8881
BLAKE2b-256 5f58753521649161b09b00cb65c138edbaa12cb9feb684e5f0888d3fa012abad

See more details on using hashes here.

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