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):
Other events use the same link with their own slug. Or open plain signup.
2. Get API keys
- Connect → Providers — save OpenAI / Anthropic / OpenRouter / Gemini in the vault.
- 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
- Send one real request (not a mock).
- Dashboard → Requests — row should appear.
- Response JSON →
prune_metadata(cost, optimizations,receipt_signature). - 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
- Email: hello@withprune.com
- Email support during event hours (team of 4)
- Deeper docs: /docs · How it works
Troubleshooting
401— wrong or revoked Prune key502— bad provider key or model name429— 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).