Installation

Install Mesmer locally with uv and prepare model provider credentials for examples.

Run from the repository root:

uv sync

Set a provider key for examples that call real models:

export GROQ_API_KEY=...

Common model settings:

export MESMER_ATTACKER_MODEL=groq/llama-3.3-70b-versatile
export MESMER_TARGET_MODEL=groq/llama-3.3-70b-versatile
export MESMER_VERBOSE=true
export MESMER_LOG_FORMAT=rich

Use a smaller model for faster local iteration:

export MESMER_ATTACKER_MODEL=groq/llama-3.1-8b-instant
export MESMER_TARGET_MODEL=groq/llama-3.1-8b-instant

Set MESMER_LOG_FORMAT=compact when you want plain JSONL traces that are easier to paste into an AI assistant for diagnosis.

Mesmer Documentation

Learn Mesmer's composable Python framework for authorized LLM red-team experiments, jailbreak research, and safety benchmarking.

First Run

Run a minimal Mesmer technique against a LiteLLM target and inspect whether the objective succeeded.