Getting started

Install with uv tool install culprit-ai or pip install culprit-ai. API keys are read from the environment or a git-ignored .env; they are never cached.

Create culprit.yaml:

prompt_path: prompts/system.txt
provider:
  name: openai
  model: your-model-id
max_calls_without_confirmation: 20

Then compare two revisions:

culprit diff HEAD~1 HEAD --eval-set evals/summarizer.yaml

No model is selected implicitly. Use anthropic for Anthropic, or openai_compatible plus base_url for Ollama, LM Studio, vLLM, LocalAI, or another compatible endpoint.