SDKs
Choose an SDK
Typed clients for talking to api.waveform.vision. Pick by language; both are production-ready.
Overview
WaveForm ships two first-party SDKs. They cover the full read+admin surface of the nav-pack registry and the robot device auth flow. Both wrap the same HTTP API documented in the API reference — the SDKs just give you typed methods, retries, and auth helpers.
Python SDK
Async client for server-to-server use. Admin + read methods. Pairs with FastAPI / Django / Celery.
Swift SDK
iOS / macOS read-only client. Robot consumers + operator tools. URLSession-only, no third-party deps.
Picking the right one
- Server automation (e.g. publishing nav-packs from a CI pipeline, registering a fleet, issuing tokens in bulk) → Python.
- Robot on-board consumer running iPadOS, an iOS robot pendant, or a macOS operator console → Swift.
- Robot on-board consumer running Linux or RTOS — call the HTTP API directly today. A Kotlin / Rust SDK is on the roadmap.
Feature parity
| Operation | Python | Swift |
|---|---|---|
| resolve_area / resolveArea | ✓ | ✓ |
| list_packs_in_area | ✓ | ✓ |
| get_manifest_for_area | ✓ | ✓ |
| get_manifest | ✓ | ✓ |
| get_provenance | ✓ | ✓ |
| get_delta | ✓ | ✓ |
| publish (admin) | ✓ | — |
| soft_delete_pack (admin) | ✓ | — |
| create / list / revoke grants (admin) | ✓ | — |
| set_version_status (admin) | ✓ | — |
| healthz / readyz | ✓ | ✓ |