Configuration

Model Registry URL

Models auto-download from HuggingFace by default. You can override this to use a mirror, local server, or air-gapped environment.

Programmatic Override (recommended for apps)

import FluidAudio

ModelRegistry.baseURL = "https://your-mirror.example.com"

let diarizer = DiarizerManager()

Environment Variables (recommended for CLI/testing)

export REGISTRY_URL=https://your-mirror.example.com
swift run fluidaudio transcribe audio.wav

# Or use the alias
export MODEL_REGISTRY_URL=https://models.internal.corp

Xcode Scheme

Edit Scheme > Run > Arguments
Go to Environment Variables tab
Add: REGISTRY_URL = https://your-mirror.example.com

Priority order: programmatic override > env vars > default (HuggingFace)

Proxy Configuration

If you’re behind a corporate firewall, set the https_proxy environment variable:

export https_proxy=http://proxy.company.com:8080

# Or for authenticated proxies:
export https_proxy=http://user:password@proxy.company.com:8080

When to Use Which

Scenario	Solution
Local mirror or internal model server	Registry URL override
Behind a corporate firewall with proxy	Proxy configuration

Registry URL — App requests from your-mirror.com instead of huggingface.co. Proxy — App still requests huggingface.co, but traffic routes through the proxy. In most cases, you only need one.

Getting Started

Speech Recognition (ASR)

Speaker Diarization

Voice Activity Detection

Text-to-Speech (TTS)

Guides

Reference

Model Registry URL

Programmatic Override (recommended for apps)

Environment Variables (recommended for CLI/testing)

Xcode Scheme

Proxy Configuration

When to Use Which

​Model Registry URL

​Programmatic Override (recommended for apps)

​Environment Variables (recommended for CLI/testing)

​Xcode Scheme

​Proxy Configuration

​When to Use Which

Model Registry URL

Programmatic Override (recommended for apps)

Environment Variables (recommended for CLI/testing)

Xcode Scheme

Proxy Configuration

When to Use Which