selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
audio.cpp logo

Self-host audio.cpp

v0.9.3

High-performance C++ audio inference for local AI models

BetaOpen SourceOther
Updated10 hours ago
LanguageC++
Setup difficultyAdvanced
Stars
3 820
Port
8080 (HTTP server and WebUI)
Docker
ghcr.io/0xshug0/audio.cpp
Install with Docker

What is audio.cpp?

This C++ inference framework builds on ggml to run modern audio AI models locally without Python. It covers over 110 model families across TTS, STT, voice cloning, conversion, music generation, separation, VAD, diarization, alignment, and codec tasks. You get a CLI, an HTTP server with OpenAI-compatible endpoints, and an embedded WebUI — all from a single binary. It works on Windows, Linux, and macOS using CUDA, AMD ROCm, Vulkan, Metal, or CPU backends. Daily Docker images are on ghcr.io. Licensed Apache-2.0 with no external service dependencies; models load from local GGUF or safetensors files. The server defaults to port 8080 and supports lazy loading, residency limits, and streaming where models allow.

Should you self-host audio.cpp?

audio.cpp scores 65/100 on selfhost.directory (how scoring works) and ranks #25 of 125 in AI. It has 3 820 GitHub stars.

It shipped 9 stable releases in the past year. The latest, v0.9.3, came out on 26 October 2026. New versions land roughly every 6 days.

Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is Other-licensed and written mostly in C++.

Its closest alternative on selfhost.directory is ComfyUI (93/100, 143 701 stars). It scores higher overall, so compare the two before you pick. See audio.cpp vs ComfyUI side by side.

Features

  • GGUF Model Format
  • JSON PipelinesExperimental
  • Multi-backend Support
  • Music Generation
  • Source Separation
  • Speech-to-Text (ASR)
  • Streaming Inference
  • Text-to-Speech (TTS)
  • Voice Cloning
  • Voice Conversion

audio.cpp README

How to install audio.cpp

Install audio.cpp with Docker

Docker, NVIDIA container toolkit (for CUDA)

docker run --rm --gpus all -v ":/models:ro" ghcr.io/0xshug0/audio.cpp:full-cuda12 <cli|server> --model /models/ <...>

CUDA variant requires NVIDIA container toolkit. Also available: full-cuda13, full-vulkan, full-cpu, full-rockchip (arm64).

How to configure audio.cpp

  • backendcpuInference backend

    Inference backend

    values: cuda, cpu, hip, rocm, vulkan, metal

  • busy_timeout_ms300000Max wait time for busy model (ms, 0 = unbounded)

    Max wait time for busy model (ms, 0 = unbounded)

  • cors_originsExperimental CORS origins

    Experimental CORS origins

  • default_session_optionsPer-family default session options

    Per-family default session options

  • device0Backend device index

    Backend device index

  • frontend_listenerExperimental frontend listener name

    Experimental frontend listener name

  • frontend_optionsFrontend listener string options

    Frontend listener string options

  • host127.0.0.1Server bind address

    Server bind address

  • idle_unload_ms0Unload idle models after inactivity (ms, 0 = disabled)

    Unload idle models after inactivity (ms, 0 = disabled)

  • lazy_loadfalseDefer model loading until first request

    Defer model loading until first request

    values: true, false

  • log_request_bodyfalseLog JSON request bodies

    Log JSON request bodies

    values: true, false

  • max_loaded_models0Maximum resident models (0 = no limit)

    Maximum resident models (0 = no limit)

  • max_request_body_bytes2147483648Maximum buffered HTTP body in bytes

    Maximum buffered HTTP body in bytes

  • min_free_memory_mb0Free memory headroom required after estimated load (MiB, 0 = disabled)

    Free memory headroom required after estimated load (MiB, 0 = disabled)

  • model_spec_overridePath to model spec JSON file or directory

    Path to model spec JSON file or directory

  • port8080Server listen port

    Server listen port

  • threads4Backend/OpenMP worker threads

    Backend/OpenMP worker threads

  • uifalseEnable embedded WebUI

    Enable embedded WebUI

    values: true, false

  • ui_managementfalseEnable model catalog browsing and downloads in WebUI

    Enable model catalog browsing and downloads in WebUI

    values: true, false

  • voice_dirDirectory of reference WAV files for voice cloning

    Directory of reference WAV files for voice cloning

audio.cpp releases & version history

More in Audio

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…