Metadata-Version: 2.4
Name: buildai-sdk
Version: 2.1.0
Summary: Build AI Python SDK
Requires-Python: >=3.10
Requires-Dist: pydantic>=2.6
Requires-Dist: requests>=2.31
Provides-Extra: all
Requires-Dist: buildai[gcs,torch]; extra == 'all'
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Provides-Extra: gcs
Requires-Dist: gcsfs>=2023.12; extra == 'gcs'
Provides-Extra: torch
Requires-Dist: torch>=2.1; extra == 'torch'
Requires-Dist: webdataset>=0.2.86; extra == 'torch'
Description-Content-Type: text/markdown

# BuildAI Python SDK

Python client for Build AI services.

## Install

```bash
cd sdk
uv pip install -e .
```

## Quick Start

```python
import buildai

client = buildai.Client(api_key="bai_...")

# Search
hits = client.search("person welding")
for h in hits.items:
    print(h.clip_id, h.similarity_score)

# Browse
factories = client.factories.list()
clip = client.clips.get("clip-uuid")

# Collections
col = client.collections.create(name="my-set")
client.collections.clips_add(col.collection_id, clip_ids=["..."])

# Datasets
datasets = client.datasets.list()
urls = client.datasets.webdataset_urls("dataset-name")

client.close()
```

## Package Layout

- `buildai/client.py` — Client entry point
- `buildai/resources/v1/` — Resource namespaces
- `buildai/models/v1/` — Response models
- `buildai/ids.py` — Deterministic UUID helpers
