sybilion 0.1.2

Official Python SDK for the Sybilion API.

Sybilion Python SDK

Official Python SDK for the Sybilion API.

pip install sybilion

Requires Python 3.10+.

Quick use

import os

from sybilion import Client

c = Client(token=os.environ["SYBILION_API_TOKEN"])
me = c.raw.api_v1_me_get()
print(me.user_id, me.available_eur_cents, me.api_usage_tier)

The token is an API key (sk_ops_...) created in the Developers Portal, or a dashboard session token.

Base URL

Resolution order:

1. base_url= when non-empty
2. SYBILION_API_BASE_URL in the process environment (optional)
3. Compiled default https://api.sybilion.dev

Pass the token explicitly (for example from SYBILION_API_TOKEN); Client does not read it from the environment by itself.

What's in the box

• sybilion.Client — Bearer auth, ergonomic helpers.
• client.wait_forecast(job_id) — polls GET /api/v1/forecasts/{id} until settled.
• client.iter_usage_pages(...), client.iter_jobs_pages(...) — paginated iterators.
• client.raw — escape hatch to the OpenAPI-generated DefaultApi for any endpoint not yet wrapped.
• Typed exceptions (sybilion.ApiException and per-status subclasses).

Documentation

Full guides, feature walkthroughs, API reference, and SDK patterns: https://sybilion.dev/docs/.

Support

• Email — [e-mail]
• Slack — Sybilion Community
• Discord — Sybilion Developers Community

License

Apache 2.0.