Troubleshooting

Fix common issues with the Rime CLI.

“no API key configured”

rime usage reports this when no key is stored; the TTS commands instead fail with “authentication failed: invalid API key”. Run rime login or set the environment variable:

export RIME_CLI_API_KEY=your_key_here

“authentication failed: invalid API key”

Verify your API key at app.rime.ai/tokens. Then run rime login again.

”unsupported format: … (supported: wav, mp3)”

The CLI writes only WAV or MP3. mist and mistv2 default to MP3, and the other models default to WAV; the API, not the CLI, rejects a format a model cannot serve. Select a supported format explicitly:

rime tts "Hello" -s cove -m mistv2 -f mp3

No audio playback

• Check your system audio output settings
• Try saving to a file instead: rime tts "Hello" -s astra -m coda -o output.wav
• Headless builds (e.g., Docker) require -o FILE since playback is disabled

”command not found: rime”

If you installed via the shell script, open a new terminal window or run:

source ~/.zshrc   # or ~/.bashrc