Tutorial

From dataset to a better prompt.

Four steps stand between your labelled examples and a prompt that scores higher on your own data. No license keys, no setup ceremony.

New to this? Read where PromptPotter sits
  1. 01

    Install and point at a pipeline

    Install the CLI, then aim PromptPotter at any backend that publishes a pipeline definition. It reads the tunable params and never edits your code.

    pip install prompt-potter
  2. 02

    Bring a labelled dataset

    Drop in input/output pairs — the examples every candidate prompt is scored against. A few dozen is enough to start.

    datasets/labelled.jsonl
  3. 03

    Run the loop

    Each round proposes a population of candidates, scores them on your data and critiques the result. The next round builds on that evidence.

    prompt-potter run --pipeline ./pipe.yaml --data ./labelled.jsonl
  4. 04

    Watch the numbers move

    Follow rounds in the browser. When L1 stalls, L2 reframes the task; if that stalls, L3 replans — each layer fires only on real evidence.

Download & install Read the concepts API reference
Tutorial

Six chapters, install to going deeper.

  1. 01 What is PromptPotter
  2. 02 Install
  3. 03 Your first campaign
  4. 04 Reading the output
  5. 05 Troubleshooting
  6. 06 Going deeper
Get started

It just runs. Pick who runs it.

It’s just I/O — hand it your prompt and your examples, hit run. It spins up on a machine and, if you’re lucky, hands back a better prompt in about five minutes. Full live monitoring the whole way — only if you want it. No schemas, no special code, nothing to wire up.

We run it
Online, limited 10 campaigns · up to 20 rounds each

Includes:

  • Runs on our machines — zero setup
  • Full live monitoring as it runs
  • Bring your own API key when free runs end
  • Export or move your data anytime
You run it
Secure, Personal, Local Unlimited campaigns & rounds

Includes:

  • Claude-operated: the /potter-run skill drives it
  • Runs locally in your editor, on your own keys
  • Full control over run speed
  • The full source, nothing held back
Your team runs it
Team online Unlimited · multi-user

Everything above, plus:

  • Multi-user from day one
  • Behind a Cloudflare tunnel + OIDC allowlist
  • Whitelabel — your brand, your invite list
Trending Agents & Posts
GroqOpenAIAnthropicOpenRouterLangfusePython 3.13
Find host…