Skip to content
prune.

Hackathon setup

5-minute setup for hackathons: signup, API key, first request, signed receipt.

Quick answer

Sign up with your event link, vault a provider key, create a Prune key, change one base URL (or use prune-sdk), send one real request, then screenshot the signed receipt for judging.

Support during events: hello@withprune.com (subject: [Event] integration). Full playbook for organizers: see the repo docs.

1. Sign up

Use your event signup link so we can attribute traffic. SharkByte 2026 (6-8 Nov, Miami Dade College):

withprune.com/sharkbyte

Other events use the same link with their own slug. Or open plain signup.

2. Get API keys

  1. Connect → Providers — save OpenAI / Anthropic / OpenRouter / Gemini in the vault.
  2. Connect → API Keys — create a Prune key (prune_…). Copy once.

3. Install SDK (or OpenAI-compatible)

pip install openai
export PRUNE_API_KEY=prune_your_key_here  # your OpenAI key stays in the Prune vault

import os
from openai import OpenAI

PRUNE_API_KEY = os.environ["PRUNE_API_KEY"]

client = OpenAI(
    base_url="https://api.withprune.com/v1",
    api_key=PRUNE_API_KEY,
)
r = client.chat.completions.create(
    model="gpt-4o-mini",
    max_tokens=100,
    messages=[{"role": "user", "content": "Say hello in one sentence."}],
)
print(r.choices[0].message.content)
print(r.model_dump().get("prune_metadata"))

Any OpenAI-compatible client: base URL https://api.withprune.com/v1, API key = your Prune key.

4. First request + receipt

  1. Send one real request (not a mock).
  2. Dashboard → Requests — row should appear.
  3. Response JSON → prune_metadata (cost, optimizations, receipt_signature).
  4. Optional: verify at withprune.com/verify.

5. Redeem Pro coupon (if you have one)

Dashboard → Billing → Redeem coupon, using the code your organizer gave you. You will see plan and end date.

6. Get help

Troubleshooting

  • 401 — wrong or revoked Prune key
  • 502 — bad provider key or model name
  • 429 — rate limit (default 60 req/min per key)
  • 402 — monthly plan limit; redeem a coupon or wait
  • No savings on first call — normal; cache not required

You still pay your model provider. Prune is the control plane in front (vault, spend caps, Shield, signed receipts).