Run On the Host

Use this path when you want to run the service directly with Python on the host.

Prerequisites

System Packages

Install the runtime system dependencies first:

sudo apt-get update
sudo apt-get install -y ffmpeg alsa-utils libsndfile1

These host packages are required for standalone execution on the machine.

Python Setup

From the audio_analyzer/ directory:

python -m venv .venv
source .venv/bin/activate
pip install --upgrade pip
pip install -r requirements.txt

Config

• Edit config.yaml. For configuration details, see the Configuration Guide.

• The same config.yaml is used for both standalone and container runs.

• Use AUDIO_ANALYZER__... environment variables only for targeted overrides.

• For Linux Intel iGPU usage, first install the required Intel/OpenVINO host runtime on the machine, then set the OpenVINO device fields to GPU in config.

Running the Service

Start

source .venv/bin/activate
python main.py

Default bind address:

• host: 127.0.0.1

• port: 8010

To change host or port:

AUDIO_ANALYZER_SERVER_HOST=0.0.0.0 AUDIO_ANALYZER_SERVER_PORT=8010 python main.py

Equivalent uvicorn command:

uvicorn main:app --host 127.0.0.1 --port 8010

Verify

curl --noproxy '*' http://127.0.0.1:8010/health

API Use Cases and Examples

For API use cases, request examples, and endpoint details, see the API Reference.

Notes

• The service ensures model assets on startup and preloads configured models

• First startup can take longer because models may be downloaded or exported

• Runtime session files are stored under storage/<session_id>/

• Host-side Linux iGPU/OpenVINO GPU was the validated GPU path for this setup