Installation
The CLI is installed automatically with Izwi. Verify installation:
izwi --version
Global Options
These options work with all commands:
| Option | Description |
|---|
--server <URL> | Server URL (default: http://localhost:8080) |
--config <PATH> | Configuration file path |
--output-format <FORMAT> | Output format: table, json, plain, yaml |
--quiet | Suppress all output except results |
--verbose | Enable verbose output |
--no-color | Disable colored output |
--help | Show help information |
--version | Show version |
Commands
Server
| Command | Description |
|---|
serve | Start the inference server |
status | Show server health and status |
Models
| Command | Description |
|---|
list | List available models |
pull | Download a model |
rm | Remove a downloaded model |
models | Model management subcommands |
Inference
| Command | Description |
|---|
tts | Text-to-speech generation |
transcribe | Speech-to-text transcription |
diarize | Speaker diarization |
align | Forced alignment |
chat | Interactive chat |
Utilities
| Command | Description |
|---|
bench | Run benchmarks |
config | Manage configuration |
completions | Generate shell completions |
version | Show version information |
Quick Examples
Start the server
izwi serve izwi serve --mode desktop izwi serve --port 9000
Download and use models
izwi list izwi pull qwen3-tts-0.6b-base izwi list --local
Generate speech
izwi tts "Hello world" --output hello.wav izwi tts "Hello world" --play
Transcribe audio
izwi transcribe audio.wav izwi transcribe audio.wav --format json
Speaker diarization
izwi diarize meeting.wav izwi diarize meeting.wav --transcribe --num-speakers 3
Forced alignment
izwi align audio.wav "Hello world, this is a test."
Interactive chat
izwi chat izwi chat --model gemma-3-1b-it --system "You are a helpful assistant"
Getting Help
Get help for any command:
izwi --help izwi serve --help izwi tts --help
Environment Variables
| Variable | Description |
|---|
IZWI_HOST | Server host |
IZWI_PORT | Server port |
IZWI_MODELS_DIR | Models directory |
IZWI_USE_METAL | Enable Metal acceleration |
IZWI_MAX_BATCH_SIZE | Maximum batch size |
IZWI_MAX_CONCURRENT | Maximum concurrent requests |
IZWI_TIMEOUT | Request timeout (seconds) |
RUST_LOG | Log level |
NO_COLOR | Disable colored output |
See Also
