Here are answers to common questions about Pome’s plans, licensing, and evaluation billing. If you don’t find what you’re looking for, email support@pome.sh.Documentation Index
Fetch the complete documentation index at: https://docs.pome.sh/llms.txt
Use this file to discover all available pages before exploring further.
What counts as a session?
What counts as a session?
One session equals one twin pod provisioned for one run. Each
pome run call creates one session against your monthly quota.Sessions expire after 30 minutes of idle time and are cleaned up automatically — you are not charged for wall-clock duration, only for the pod boot itself.Do I need an API key to self-host?
Do I need an API key to self-host?
No. Running Pome with
docker compose requires no Pome account and no API key. The OSS build is fully self-contained.You only need a POME_API_KEY when connecting to the hosted control plane (Hosted Free or Hosted Pro).What is BYOK and how does it work?
What is BYOK and how does it work?
BYOK (Bring Your Own Key) means Pome never bundles or proxies LLM calls. For
[P] (probabilistic) success criteria, the Pome CLI calls your configured OpenAI-compatible endpoint directly, using your key.The Pome cloud never sees your key, your prompts, or your agent’s completions.Supported endpoints:- OpenRouter
- OpenAI
- Anthropic (via compatible gateway)
- Ollama
- Any OpenAI-compatible API
Does the AGPL license affect my agent code?
Does the AGPL license affect my agent code?
No. AGPL §13 applies to modifications of Pome itself if you serve those modifications to users over a network. Your agent code, scenario files, and harness code are entirely yours — they are not derived from Pome.Internal use (running Pome inside your organization) is free with no obligations. You only have AGPL obligations if you modify the twin runtime or evaluator and offer that modified version as a network service to others.Some enterprise procurement teams blanket-ban AGPL software. If that applies to your organization, ask about the commercial AGPL exemption add-on available with Self-host Annual and Enterprise contracts.
Can I migrate from hosted to self-host (or vice versa)?
Can I migrate from hosted to self-host (or vice versa)?
Yes. The trace format is identical in both modes. You can export your scenarios and trace history from the hosted dashboard and import them into a self-hosted setup, or vice versa.The hosted dashboard provides a migration wizard that exports your scenarios and traces as a tarball. For the reverse direction (self-host to hosted), a CLI command uploads your existing trace history from the local filesystem.
What happens when I hit my session quota?
What happens when I hit my session quota?
The API returns
429 with an upgrade link in the response body. The CLI exits with code 4 (quota exceeded).On Hosted Pro, reaching the monthly session limit does not result in a hard block — instead, additional sessions are charged at $0.20 per session as overage.On Hosted Free, the block is hard. Upgrade to Pro to continue.Is there a free trial of Hosted Pro?
Is there a free trial of Hosted Pro?
Yes. The Hosted Free tier lets you evaluate Pome with 50 sessions per month at no cost. No credit card required.When you are ready to scale, you can upgrade to Hosted Pro directly from the dashboard.
What's included in Enterprise?
What's included in Enterprise?
Enterprise contracts include:
- 4-hour P0 SLA, 24-hour P1 SLA
- 48-hour endpoint promotion SLA
- Custom MSA and DPA negotiation
- Dedicated onboarding engineer (4 weeks)
- SOC2 documentation (when available)
- On-call escalation path
- Multi-team license (single contract covers your entire org)
Are there discounts?
Are there discounts?
Yes. The following standing discounts are available:
Contact sales@pome.sh to apply a discount to your account.
| Audience | Discount | Verification |
|---|---|---|
| Open-source maintainers (≥1k star repo or OSS foundation member) | Free Hosted Pro | Founder validates |
| Educational users (.edu email) | 50% off Hosted Pro | .edu email + course or research statement |
| YC alumni | 30% off Self-host Annual (first year) | Founder validates |
How do I cancel or downgrade?
How do I cancel or downgrade?
You can cancel or downgrade at any time from the billing page in your dashboard. There are no refunds, but your current plan stays active through the end of the billing period.If you are on a Self-host Annual contract and need to switch to Hosted Pro, contact support@pome.sh — annual contracts are refunded prorata for unused months in this specific case.