Reference

CLI

Commands for models, speech, voices, and the local server. Start with wavhost pull, then run or serve.

wavhost pull

Download weight layers into local storage and register the model, installing its backend engine if needed.

  • --force

    Pull even if already installed (resumes existing blobs)

  • --skip-deps

    Don't install the backend engine

Examples

wavhost pull chatterbox-turbo
wavhost pull chatterbox-multilingual
wavhost pull qwen-0.6-customvoice
wavhost pull kokoro
wavhost pull qwen-0.6-base --force
wavhost pull chatterbox-turbo --skip-deps
wavhost run

Generate speech from text using a local model.

  • -o, --output

    Output WAV path (default output.wav)

  • --voice

    Saved voice, reference audio path, or named speaker (Qwen: Ryan, Aiden, …; Kokoro: af_heart, bm_george, …)

  • --language, -l

    Multilingual ISO (en, fr, zh, …), Qwen names (English, …), or Kokoro ISO / voice prefix

  • --device

    cuda, cpu, or mps

Examples

wavhost run chatterbox-turbo "Welcome to Wavhost" -o welcome.wav
wavhost run chatterbox-turbo "Hello" --voice my-voice -o hello.wav
wavhost run chatterbox-turbo "Hello" --voice /path/to/audio.wav -o hello.wav
wavhost run qwen-0.6-customvoice "Hello" --voice Ryan -o qwen.wav
wavhost run qwen-0.6-base "Hello" --voice /path/to/audio.wav -o clone.wav
wavhost run chatterbox-multilingual "Bonjour" --language fr -o fr.wav
wavhost run kokoro "Hello from Kokoro" --voice af_heart -o hello.wav
wavhost voice create

Create a saved voice from reference audio.

  • --ref

    Required. Path to reference audio

  • --desc

    Optional description

Example

Try
wavhost voice create narrator --ref voice.wav --desc "Professional narrator"
  • voice list

    List saved voices

    wavhost voice list
  • voice show

    Show voice details

    wavhost voice show narrator
  • voice rm

    Remove a voice (-y skips confirm)

    wavhost voice rm narrator -y
wavhost serve

Start the local API server.

  • --hostdefault localhost

    Bind address

  • --portdefault 11435

    Bind port

  • --reloadoff

    Auto-reload for development

Examples

wavhost serve
wavhost serve --host 0.0.0.0 --port 8000 --reload
  • list

    Installed models + registry

    wavhost list
  • show

    Model details and named voices

    wavhost show kokoro
  • rm

    Remove a pulled model

    wavhost rm chatterbox-turbo -y
  • uninstall

    Purge ~/.wavhost (--keep-data / -y)

    wavhost uninstall -y

Remove the package with pip uninstall wavhost. Optional engines: pip uninstall chatterbox-tts qwen-tts kokoro.