coaxer

Label examples. Derive the prompt. Consume it as a string.

Full docs: https://thekevinscott.github.io/coaxer/ · ship-with-package source in docs/.

Motivation

Writing prompts by hand is slow, and the prose grows brittle as cases accumulate. Coaxer flips it: label examples of the behavior you want, derive the prompt from those labels — when it drifts, add more labels instead of rewriting.

Labels are the source of truth. The prompt is a build artifact.

Install

uv add coaxer        # Python
npm install coaxer   # TypeScript

Quick start

coax labels/repo-classification --out prompts/repo-classification

from coaxer import CoaxedPrompt

p = CoaxedPrompt("prompts/repo-classification")
filled = p(readme=new_readme, stars=1200)

The TypeScript version is in docs/guide/getting-started.md.

Getting Started

Label folder is one directory per record; record.json plus sibling files for large text or binary inputs. coax compiles the folder into a prompt artifact you load with CoaxedPrompt. Default optimizer is none (schema-derived, no network).

Full walkthrough: docs/guide/getting-started.md.

CoaxedPrompt

CoaxedPrompt(path, **bound) is a str subclass. str(p) is the raw template; p(**vars) renders it. Missing vars raise MissingVariableError. Bound defaults at construction; call-time vars override. p.fields lists the input variables the template expects.

For structured-output APIs, p.response_format is a Pydantic model derived from the compiled output schema.

Reference: docs/api/coaxed-prompt.md.

CLI

coax <labels-dir> --out <prompts-dir> [--optimizer {none,gepa}] [--output-name NAME]

Reference: docs/api/cli.md.

AgentLM

DSPy BaseLM backed by the Claude Agent SDK. **kwargs forward to ClaudeAgentOptions (tools, allowed_tools, max_turns, …).

from coaxer import AgentLM
lm = AgentLM(tools=[])

Reference: docs/api/agent-lm.md.

OpenAILM

DSPy BaseLM for any OpenAI-compatible chat endpoint (Ollama, vLLM, OpenAI, LM Studio, …).

from coaxer import OpenAILM
lm = OpenAILM(model="gpt-4o", base_url="https://api.openai.com/v1", api_key="sk-...")

Reference: docs/api/openai-lm.md.

Migrations

Downstream-consumer upgrade instructions for breaking changes live in MIGRATIONS.md (also published at docs/migrations.md). The full release log is in CHANGELOG.md.

Development

uv sync --extra dev
uv run just test-unit   # Unit tests
uv run just ci          # Full CI (lint + format + typecheck + tests)

Download files

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

Source Distribution

coaxer-0.3.14.tar.gz (66.1 kB view details)

Uploaded Aug 20, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

coaxer-0.3.14-py3-none-any.whl (52.8 kB view details)

Uploaded Aug 20, 2026 Python 3

File details

Details for the file coaxer-0.3.14.tar.gz.

File metadata

Download URL: coaxer-0.3.14.tar.gz
Upload date: Aug 20, 2026
Size: 66.1 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for coaxer-0.3.14.tar.gz
Algorithm	Hash digest
SHA256	`eb852d4034ebfc9201c9bdf2a161fafa31d56abd36d5071d12e85589b0d4bae4`
MD5	`33a6df3a9315eee7241dc1c807a868c7`
BLAKE2b-256	`ec29f11c8dc27d794df57316d30a94d1f6608eb005d5f0627e8857f511be47e2`

See more details on using hashes here.

Provenance

The following attestation bundles were made for coaxer-0.3.14.tar.gz:

Publisher: release.yml on thekevinscott/coaxer

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

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: coaxer-0.3.14.tar.gz
- Subject digest: eb852d4034ebfc9201c9bdf2a161fafa31d56abd36d5071d12e85589b0d4bae4
- Sigstore transparency entry: 2534705036
- Sigstore integration time: Aug 20, 2026
Source repository:
- Permalink: thekevinscott/coaxer@143f64a71b647c26a51dcdc4232175cf2cc59ee6
- Branch / Tag: refs/heads/main
- Owner: https://github.com/thekevinscott
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@143f64a71b647c26a51dcdc4232175cf2cc59ee6
- Trigger Event: push