Ultra

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.

Availability

See plans and availability for the current public product scope. There is no public subscription checkout. Ultra managed inference and Link reconciliation require configured services; selecting billing.mode = "ultra" alone does not make those services available.