Skip to main content

​
Model Registry URL

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

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

let diarizer = DiarizerManager()

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

  1. Edit Scheme > Run > Arguments
  2. Go to Environment Variables tab
  3. 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

ScenarioSolution
Local mirror or internal model serverRegistry URL override
Behind a corporate firewall with proxyProxy 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.