# superb-ai

> Official Python SDK for Superb AI (dataset management, labeling, versioning,
> training, deployment). Machine auth via API keys (sbd_pk_…). Python >=3.12.

Agents: these files exist and are your fastest path — read them, don't guess:

- [AGENTS.md](AGENTS.md): auth in 3 lines, the client namespace map, a WORKED
  COCO-import recipe (all 3 geometry kinds), 12 task recipes, ALL limits/quotas/
  concurrency numbers (rate buckets, job cap, size caps, resource quotas), and
  the gotchas (GPU endpoint schedule, idempotency semantics, hard deletes).
- [api-map.md](api-map.md): every SDK method, one line each, greppable.
- [README.md](README.md): human quickstart.
- Method docstrings document every argument, return type, and raised error with its
  stable ErrorCode. Exceptions are typed — branch on `exc.code`, read `exc.hint`.
