Skip to main content
The Avala Python SDK provides a simple, type-safe interface to the Avala API. Build annotation workflows, manage datasets and projects, create exports, and automate labeling tasks—all from Python.

Installation

Get started with pip, Poetry, or uv

Quickstart

Initialize the client and run your first API calls

Authentication

Configure your API key and secure access

API Reference

Explore all available resources and methods

Key features

Type-safe API

Built with Pydantic models for runtime validation and excellent editor support

Async support

Use AsyncClient for high-performance concurrent operations

Automatic pagination

Iterate through large result sets with cursor-based pagination

Built-in error handling

Comprehensive error hierarchy for authentication, rate limits, and validation

Configurable retries

Automatic retry logic with exponential backoff for transient failures

CLI included

Command-line interface for quick dataset inspection and export creation

What you can build

Create, list, and inspect annotation datasets. Filter by data type, status, or visibility. Access dataset items and sequences programmatically.
Browse annotation projects, retrieve project details, and integrate project data into your ML pipelines.
Create exports for datasets or projects, monitor export status, and download annotation data in standard formats.
Query annotation tasks with filters for project, status, or assignee. Monitor progress and completion rates.
Configure inference providers, create auto-label jobs, and manage batch labeling workflows.
Set up quality targets, compute consensus scores, and evaluate annotation quality programmatically.
Subscribe to events, manage webhook endpoints, and inspect delivery logs for real-time integrations.
Manage edge devices, recordings, events, and alerting rules for computer vision applications.

Requirements

Next steps

1

Install the SDK

Follow the installation guide to add Avala to your project
2

Configure authentication

Set up your API key using the authentication guide
3

Run the quickstart

Try the quickstart examples to make your first API calls
4

Explore the API

Browse the API reference to discover all available resources

Build docs developers (and LLMs) love