Python

uv add aic-sdk

pip install aic-sdk

uv run quickstart.py

# /// 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)

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

# Process audio (1D NumPy array of mono float32 samples)
audio_buffer = np.zeros(config.block_size, dtype=np.float32)
processed = processor.process(audio_buffer)