avala 0.2.0

Official Python SDK for the Avala API

Avala Python SDK

Official Python SDK for the Avala API. Build and manage ML annotation datasets, projects, exports, and tasks programmatically.

Installation

pip install avala

Requires Python 3.9+.

Quick Start

from avala import Client

client = Client()  # reads AVALA_API_KEY env var

# List datasets
page = client.datasets.list(limit=10)
for dataset in page:
    print(dataset.uid, dataset.name)

# Get a specific dataset
dataset = client.datasets.get("dataset-uid")

# Create an export
export = client.exports.create(project="project-uid")
print(export.uid, export.status)

# List tasks with filters
tasks = client.tasks.list(project="project-uid", status="completed")

Authentication

The client reads your API key from the AVALA_API_KEY environment variable by default:

export AVALA_API_KEY="avk_your_api_key"

Or pass it explicitly:

client = Client(api_key="avk_your_api_key")

Async Support

from avala import AsyncClient

async with AsyncClient() as client:
    page = await client.datasets.list()
    for dataset in page:
        print(dataset.name)

Pagination

All .list() methods return a CursorPage that supports iteration:

page = client.datasets.list(limit=20)

for dataset in page:
    print(dataset.name)

# Manual pagination
if page.has_more:
    next_page = client.datasets.list(cursor=page.next_cursor)

Error Handling

from avala.errors import AvalaError, NotFoundError, RateLimitError, AuthenticationError

try:
    dataset = client.datasets.get("nonexistent")
except NotFoundError:
    print("Dataset not found")
except RateLimitError:
    print("Rate limited")
except AuthenticationError:
    print("Invalid API key")
except AvalaError as e:
    print(f"API error: {e}")

Available Resources

Resource	Methods	Description
client.datasets	list(), get(uid)	Browse and inspect datasets
client.projects	list(), get(uid)	Browse and inspect projects
client.exports	list(), get(uid), create()	Create and manage annotation exports
client.tasks	list(), get(uid)	Browse tasks with project/status filters

Documentation

• Python SDK Guide
• API Reference
• Quickstart
• Examples

Contributing

See CONTRIBUTING.md for development setup and guidelines.

License

MIT - see LICENSE for details.