Sybilion Python SDK

Official Python SDK for the Sybilion API.

pip install sybilion

Requires Python 3.10+.

Quick use

from sybilion import Client

# Token read from SYBILION_API_TOKEN env var automatically
c = Client()
me = c.me()
print(me.user_id, me.available_eur_cents, me.api_usage_tier)

Or pass the token explicitly:

c = Client(token="sk_ops_...")

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

What's in the box

Account

• c.me() — authenticated account info (balance, tier).

Catalog

• c.list_categories() / c.list_regions() — available thematic categories and geographic regions.

Forecasts

• c.submit_forecast(request) — submit an async forecast job.
• c.get_forecast(id) — poll status of a forecast job.
• c.get_forecast_artifact(id, name) — download a forecast artifact by name.
• c.wait_forecast(job_id) — polls until the job is settled or timeout is exceeded.

Drivers

• c.get_drivers(request) — drivers ranked by explanatory power (synchronous, billed).

Alerts

• c.get_alerts(metadata, context_enriched, ...) — anomaly alerts for a timeseries (synchronous, billed).

Jobs & Usage

• c.list_jobs(...) / c.iter_jobs_pages(...) — async job list with optional filters.
• c.get_usage(...) / c.iter_usage_pages(...) — credit/usage ledger.

Escape hatch

• c._api — 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 — support@sybilion.com
• Slack — Sybilion Community
• Discord — Sybilion Developers Community

License

Apache 2.0.