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:
- Install development dependencies
- Run
mkdocs serveto 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
- OpenAI gateway:
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
Metadata
Release files for airia 0.1.41
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| airia-0.1.41.tar.gz | 94.5 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| airia-0.1.41-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 255.6 kB
Release files / airia-0.1.41.tar.gz
| Download URL | airia-0.1.41.tar.gz |
|---|---|
| Size | 94.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
80f386af5f777689f0c58a43e3a0ce74955de23ab1800e432fe5f3255e8e1edf
|
|
BLAKE2b-256 checksum How to use checksums |
8e296b500e747740c9898d010d15fbe0f8e6d5fd76498d4b9d876aaa2023db95
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / airia-0.1.41-py3-none-any.whl
| Download URL | airia-0.1.41-py3-none-any.whl |
|---|---|
| Size | 161.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cf42526a407c5ebd08ab42baa1b751cb43a13a9304873c0232d899e6de8bb99e
|
|
BLAKE2b-256 checksum How to use checksums |
506512ba2ff336f1b4a08baa89c88dffda1f3875cc6e37b5d1b6f9601933e5c4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Security for airia 0.1.41
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
