IzwiIzwi

Windows Installation

Izwi runs on Windows 10 and later with optional CUDA support for NVIDIA GPUs.

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)

Step 1: Download

Download Izwi-Setup-*.exe from GitHub Releases.

Step 2: Run Installer

  1. Double-click the downloaded .exe file
  2. If Windows SmartScreen appears, click More info → Run anyway
  3. Follow the installation wizard
  4. Choose installation location (default: C:\Program Files\Izwi)

Step 3: Verify

Open Command Prompt or PowerShell and run:

izwi --version

Install via winget (Coming Soon)

winget install Agentem.Izwi

CUDA Support (NVIDIA GPUs)

For NVIDIA GPU acceleration:

Step 1: Install NVIDIA Drivers

Download and install the latest drivers from NVIDIA.

Step 2: Install CUDA Toolkit

Download CUDA Toolkit from NVIDIA CUDA Downloads.

Step 3: Verify CUDA

izwi status --detailed

Look for "CUDA: available" in the output.

Data Locations

DataLocation
Models%APPDATA%\izwi\models\
Config%APPDATA%\izwi\config.toml
Logs%APPDATA%\izwi\logs\
ProgramC:\Program Files\Izwi\

To open these folders:

# Open models folder explorer "%APPDATA%\izwi\models" # Open config folder explorer "%APPDATA%\izwi"

Running at Startup

Option 1: Task Scheduler

  1. Open Task Scheduler
  2. Click Create Basic Task
  3. Name: "Izwi Server"
  4. Trigger: When I log on
  5. Action: Start a program
  6. Program: C:\Program Files\Izwi\izwi.exe
  7. Arguments: serve

Option 2: Startup Folder

  1. Press Win + R, type shell:startup, press Enter
  2. Create a shortcut to izwi.exe serve

Uninstall

Via Settings

  1. Open Settings → Apps → Installed apps
  2. Find Izwi
  3. Click Uninstall

Via Control Panel

  1. Open Control Panel → Programs → Uninstall a program
  2. Find Izwi
  3. Click Uninstall

Remove Data (Optional)

# Remove all Izwi data (including models!) Remove-Item -Recurse -Force "$env:APPDATA\izwi"

Troubleshooting

"Windows protected your PC" (SmartScreen)

This appears because the app isn't code-signed yet:

  1. Click More info
  2. Click Run anyway

Command not found: izwi

The installer should add Izwi to your PATH. If not:

  1. Open System Properties → Environment Variables
  2. Under User variables, edit Path
  3. Add C:\Program Files\Izwi
  4. Restart your terminal

Port 8080 already in use

Another application is using port 8080. Use a different port:

izwi serve --port 8888

CUDA not detected

  1. Verify NVIDIA drivers:
    nvidia-smi
  2. Ensure CUDA Toolkit is installed and in PATH
  3. Restart your computer after CUDA installation

Firewall blocking connections

If you can't access Izwi from other devices:

  1. Open Windows Defender Firewall
  2. Click Allow an app through firewall
  3. Add izwi-server.exe

Building from Source

Prerequisites

  1. Install Visual Studio Build Tools
  2. Install Rust
  3. Install Git

Build

git clone https://github.com/agentem-ai/izwi.git cd izwi cargo build --release

Binaries will be in target\release\.

Next Steps