Quickstart

1. Install

Requires Node.js 22 or later. These single-line commands work in PowerShell and Bash.

npm install -g @kittaai/cli
kitta --version

2. Connect your account

Create an API key in API settings. Paste it into the hidden prompt below, not into command arguments or screenshots.

kitta auth login
kitta auth status --json

This authenticates an API key; it is not browser OAuth login.

3. Choose a voice

kitta audio models list --json
kitta audio voices list --all --language en --json

Copy an available voice ID from the result and replace VOICE_ID below. Paid generation requires sufficient API quota.

4. Generate and save

kitta audio tts --voice VOICE_ID --text "Hello from Kitta" --output hello.mp3

--output implies waiting for completion. On success, hello.mp3 appears in your current directory and the exit code is 0. Existing files are not overwritten.

If no file arrives

Keep the task ID from diagnostics. A timeout or Ctrl+C stops only local waiting, not the remote task or its charge. Before generating again, read task recovery.

Next: read installation and authentication.