airia 0.1.41

Python SDK for Airia API

Airia Python API Library

The Airia Python library provides a clean and intuitive interface to interact with Airia API. The library offers both synchronous and asynchronous clients for maximum flexibility in your applications.

Features

• Dual Client Support: Choose between synchronous (AiriaClient) and asynchronous (AiriaAsyncClient) implementations
• Pipeline Execution: Easily run AI pipelines with customizable parameters
• Gateway Support: Seamlessly integrate with OpenAI and Anthropic services through Airia gateways
• Error Handling: Comprehensive error handling with custom exceptions
• Logging: Built-in configurable logging with correlation ID support for request tracing
• Flexible Authentication: Support for both API keys and bearer tokens with flexible configuration

Documentation and Quick Start Guides

Full documentation and quick start guides are available here.

You can also run the documentation page locally with mkdocs:

1. Install development dependencies
2. Run mkdocs serve to start the local server

Installation

You can install the package using pip or uv:

pip	uv
pip install airia	uv add airia

Install with optional dependencies

The package supports optional dependencies for gateway functionality:

OpenAI Gateway	Anthropic Gateway	All Gateways
pip install "airia[openai]"	pip install "airia[anthropic]"	pip install "airia[all]"

Install with development dependencies

Clone the repository:

git clone https://github.com/AiriaLLC/airia-python.git
cd airia-python

Then, run one of the following commands:

pip	uv
pip install dependency-groups dev=$(python -m dependency_groups dev) pip install -e . pip install $dev	uv sync --frozen --group dev

Building from Source

First make sure you have already cloned the repository, then run one of the following commands:

pip	uv
pip install build python -m build	uv build

This will create both wheel and source distribution in the dist/ directory.

Requirements

• Python 3.9 or higher

• Core dependencies:

  • requests
  • aiohttp
  • pydantic

• Optional dependencies:

  • OpenAI gateway: openai>=1.74.0
  • Anthropic gateway: anthropic>=0.49.0

Features

• Synchronous and Asynchronous Clients: Choose between sync (AiriaClient) or async (AiriaAsyncClient) based on your needs
• Colored Logging: Built-in colored console logging using ANSI codes (no additional dependencies)
• Correlation ID Tracking: Automatic request tracing with correlation IDs
• Gateway Support: Optional OpenAI and Anthropic gateway integration
• Type Safety: Full type hints and Pydantic models for request/response validation

Development

To run tests (make sure you have development dependencies installed):

pytest

For testing gateway functionality, install the optional dependencies:

# For OpenAI gateway tests
pip install -e .[openai]
pytest tests/test_openai_gateway.py

# For Anthropic gateway tests
pip install -e .[anthropic]
pytest tests/test_anthropic_gateway.py

# For all tests
pip install -e .[all]
pytest