Before choosing an install path, check the Runtime Support Matrix for the current backend contract. In particular:
  • GitHub Release artifacts are not the same thing as CUDA source builds.
  • Linux and Windows GitHub Release artifacts are CPU-only and do not bundle CUDA runtime libraries.
  • CUDA acceleration requires a compatible NVIDIA driver and GPU; source builds still require the CUDA toolkit.
  • The Docker CUDA profile is the CUDA distribution path for NVIDIA Linux hosts; see Docker.

Platforms


Quick Install

macOS

Linux (Debian/Ubuntu)

Download Izwi_<version>_amd64.deb from the Releases page, then:

Windows

Download and run Izwi_<version>_x64-setup.exe from GitHub Releases.

Verify Installation

After installation, install the izwi command line tool from Settings > System > Command line tool > Install in the desktop app (the .deb installs it for you), then verify everything is working in a new terminal:
You should see the compiled backend list for the installed CLI. After you start the server with izwi serve, use izwi status --detailed to verify runtime backend selection. If you specifically need NVIDIA CUDA support, see:

Optional: espeak-ng for Kokoro-82M

If you want to use the Kokoro-82M TTS model, you also need espeak-ng installed separately. See your platform guide for commands:

Next Steps

macOS Installation

Install Izwi on macOS with the DMG, optional CLI tools, and Apple Silicon acceleration.

Linux Installation

Install Izwi on Linux with release packages, source builds, services, and CUDA guidance.

Windows Installation

Install Izwi on Windows with the installer, optional eSpeak NG, CUDA notes, and source build setup.

Docker

Run Izwi in Docker: an open development setup by default, production with one overlay.

Build from Source

Build Izwi from source for development, custom backends, and release packages.