izwi.exe and izwi-server.exe names and are intentionally CPU-only.
See the Runtime Support Matrix for the current artifact contract.
Requirements
- Windows 10 (version 1903+) or Windows 11
- 8 GB RAM minimum (16 GB recommended)
- 10 GB free disk space (more for models)
- NVIDIA GPU (optional, for CUDA acceleration)
Install from Installer (Recommended)
The Windows installer is CPU-only. Use a source build when you need CUDA on Windows.
Step 1: Download
DownloadIzwi_<version>_x64-setup.exe from GitHub Releases.
Step 2: Run Installer
- Double-click the downloaded
.exefile - If Windows SmartScreen appears, click More info → Run anyway
- Follow the installation wizard
- Choose installation location (default:
C:\Program Files\Izwi)
Step 3: Verify
To useizwi from a terminal, open Izwi, go to Settings > System > Command line tool and select Install. Izwi copies izwi.exe and izwi-server.exe to %LOCALAPPDATA%\Izwi\bin and adds that folder to your user PATH.
Open a new Command Prompt or PowerShell window and run:
Optional: Install espeak-ng for Kokoro-82M
Kokoro-82M uses espeak-ng for phonemization. Install it before using Kokoro voices.
Option 1: Install from eSpeak NG releases (Recommended)
- Download the latest Windows installer/zip for eSpeak NG from the official releases page: eSpeak NG Releases
- Install eSpeak NG (or extract it to a folder such as
C:\Program Files\eSpeak NG\) - Add the folder containing
espeak-ng.exeto your PATH if the installer does not do this automatically
Verify
Open a new PowerShell window and run:CUDA Support (NVIDIA GPUs)
Native Windows GitHub Release installers are CPU-only and do not bundle CUDA runtime DLLs. CUDA on Windows is currently a source-build preview path.Step 1: Install NVIDIA Drivers
Download and install the latest drivers from NVIDIA.Step 2: Build from source (Preview)
Source builds still require CUDA Toolkit from NVIDIA CUDA Downloads.Verify a Source Build
Start the server in one PowerShell window:CUDAunder Compiled BackendsRequested: cudaSelected: cuda
Data Locations
To open these folders:
Running at Startup
Option 1: Task Scheduler
- Open Task Scheduler
- Click Create Basic Task
- Name: “Izwi Server”
- Trigger: When I log on
- Action: Start a program
- Program:
C:\Program Files\Izwi\izwi.exe - Arguments:
serve
Option 2: Startup Folder
- Press
Win + R, typeshell:startup, press Enter - Create a shortcut to
izwi.exe serve
Uninstall
Via Settings
- Open Settings → Apps → Installed apps
- Find Izwi
- Click Uninstall
Via Control Panel
- Open Control Panel → Programs → Uninstall a program
- Find Izwi
- Click Uninstall
Remove Data (Optional)
Troubleshooting
”Windows protected your PC” (SmartScreen)
This appears because the app isn’t code-signed yet:- Click More info
- Click Run anyway
Command not found: izwi
The installer does not addizwi to your PATH. Open Izwi, go to Settings > System > Command line tool and select Install. This copies the command to %LOCALAPPDATA%\Izwi\bin and adds that folder to your user PATH. Then restart your terminal.
Kokoro error: espeak-ng not found
Install eSpeak NG and ensure the folder containing espeak-ng.exe is in your PATH, then verify:
Port 8080 already in use
Another application is using port 8080. Use a different port:CUDA not detected
-
Verify NVIDIA drivers:
-
If you installed from source, verify the CUDA toolkit:
-
If you installed from source, rebuild the CLI and server with CUDA:
-
Verify runtime backend state:
Firewall blocking connections
If you can’t access Izwi from other devices:- Izwi listens on
127.0.0.1by default. Set an API key and bind a network address: - Open Windows Defender Firewall
- Click Allow an app through firewall
- Add
izwi-server.exe
Building from Source
Prerequisites
- Install Visual Studio Build Tools
- Install Rust
- Install Git
Build
target\release\.