Metadata-Version: 2.4
Name: spanda-sdk
Version: 0.4.0
Summary: Official Python SDK for Spanda Control Center API v1
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Provides-Extra: stream
Requires-Dist: websockets>=12; extra == "stream"
Provides-Extra: dev
Requires-Dist: pytest>=7; extra == "dev"
Requires-Dist: websockets>=12; extra == "dev"

# Spanda Python SDK

Official Python client for Spanda Control Center API v1.

## Install

```bash
pip install -e sdk/python
# WebSocket telemetry
pip install -e "sdk/python[stream]"
```

## Quick start

```python
from spanda import SpandaClient

client = SpandaClient.local()
report = client.readiness("rover.sd")
print(report["report"])
```

Requires Control Center running:

```bash
spanda control-center serve --program examples/robotics/rover.sd
```

## Environment

| Variable | Purpose |
|----------|---------|
| `SPANDA_CONTROL_CENTER_URL` | API base URL (default `http://127.0.0.1:8080`) |
| `SPANDA_API_KEY` | Bearer token for authenticated endpoints |

## Documentation

- [docs/sdk-python.md](../../docs/sdk-python.md)
- [docs/control-center-api.md](../../docs/control-center-api.md)

## Legacy client

Enterprise ops helpers (`ControlCenterClient` for drift, OTA, SRE) remain in `packages/sdk-python`.
