PytxoUltra
BYOK vs Ultra managed metering, sessions, and what leaves your machine.
Default Pytxo usage is BYOK: your provider keys stay in environment variables on your machine. Ultra is an optional billing mode. The local wallet and usage ledger work today; managed inference and Link reconciliation require configured services and are not end-to-end on the default path.
Modes
| Mode | Config | Keys |
|---|---|---|
| BYOK (default) | billing.mode = "byok" or omit [billing] | Your provider keys (ANTHROPIC_API_KEY, ...) |
| Ultra | billing.mode = "ultra" | Local wallet works without provider-key custody; configured managed inference keeps provider keys on the proxy |
[billing]
mode = "ultra"
proxy_url = "https://link.pytxo.com"
inference_proxy_url = "https://proxy.pytxo.com"What Ultra changes
- Local wallet / usage metering hooks run around agent context preparation
- Child environments can use managed transport when a proxy is configured
- Run start/end envelopes can POST to Pytxo Link when reconciliation is enabled and reachable
- Signal Core still scaffolds context; savings show up in arbitrage samples when profiling is on
What stays local-first
- Orchestration, worktrees, local event store, and MCP still run on your machine unless you explicitly enable cloud execution
- Secrets should not be committed; examples use env vars only
- Doctor checks billing connectivity only when Ultra is enabled
Current availability
| Capability | Availability |
|---|---|
| Local wallet, reservations, and usage ledger | Available |
| Signal Core arbitrage samples | Available when profiling is enabled |
| Managed inference proxy | Requires a configured proxy deployment |
| Link reconciliation | Requires a configured Link deployment; default orchestration remains local-ledger only |
| Cloud execution | Separate capability gate; requires a configured cloud dispatcher |
Environment
| Variable | Purpose |
|---|---|
PYTXO_ULTRA_SESSION | Bearer token for Link reconcile |
See pytxo.toml billing for billing keys and related options.
Pricing UI
Product tiers and checkout live on pytxo.com/plans. Checkout provisions an entitlement; it does not make an unconfigured proxy, Link deployment, or cloud dispatcher available.