> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ai-coustics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Python

<Card title="View on GitHub" icon="github" iconType="brands" href="https://github.com/ai-coustics/aic-sdk-py" horizontal>
  Full reference, examples, and release notes.
</Card>

## Installation

Add our SDK to your Python application with native NumPy support.

Install with [uv](https://docs.astral.sh/uv/):

```bash theme={null}
uv add aic-sdk
```

Or with pip:

```bash theme={null}
pip install aic-sdk
```

## Quickstart

Run with [uv](https://docs.astral.sh/uv/):

```bash theme={null}
uv run quickstart.py
```

```python theme={null}
# /// script
# requires-python = ">=3.10,<3.14"
# dependencies = [
#   "aic-sdk",
#   "numpy"
# ]
# ///

# quickstart.py

import aic_sdk as aic
import numpy as np
import os

# Get your license key from the environment variable
license_key = os.environ["AIC_SDK_LICENSE"]

# Download and load a model (or download manually at https://artifacts.ai-coustics.io/)
model_path = aic.Model.download("quail-vf-2.1-l-16khz", "./models")
model = aic.Model.from_file(model_path)

# Get optimal configuration
config = aic.ProcessorConfig.optimal(model, num_channels=2)

# Create and initialize processor in one step
processor = aic.Processor(model, license_key, config)

# Process audio (2D NumPy array: channels × frames)
audio_buffer = np.zeros((config.num_channels, config.num_frames), dtype=np.float32)
processed = processor.process(audio_buffer)
```