About cli-anything-minimax
cli-anything-minimax is a command-line harness for MiniMax AI, for people and agents that need chat completions or text-to-speech through the MiniMax API. It combines interactive and one-shot commands with session and configuration management.
Key features
- 01Chat and streaming completions
- 02Text-to-speech synthesis
- 03List chat models and voices
- 04Manage sessions and configuration
Use cases
- 01Send a prompt to a MiniMax chat model
- 02Generate speech audio from text
- 03Inspect available models or voices
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/cli-anything-minimaxin Claude Code to confirm it loaded.
Details
From the project READMEcli-anything-minimax
A CLI harness for MiniMax AI — providing chat completions and text-to-speech synthesis through the MiniMax API.
Installation
pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=minimax/agent-harness
Prerequisites:
- Python 3.10+
- MiniMax API key from platform.minimax.io
Usage
Basic Commands
# Show help
cli-anything-minimax --help
# Start interactive REPL
cli-anything-minimax
# Chat with MiniMax-M3
cli-anything-minimax chat --prompt "What is AI?"
# Alternate chat model
cli-anything-minimax chat --prompt "Quick answer" --model MiniMax-M2.7
# Stream chat response
cli-anything-minimax stream --prompt "Write a poem about code"
# Synthesize speech
cli-anything-minimax tts --text "Hello world" --output hello.mp3
# JSON output for agents
cli-anything-minimax --json chat --prompt "Hello"
TTS options
--text (required) / --model / --voice / --output plus voice and audio
controls: --speed (0.5..2.0), --vol (0..10), --pitch (-12..12),
--sample-rate (8k/16k/22.05k/24k/32k/44.1k), --bitrate (32k/64k/128k/256k),
--format (mp3/pcm/flac), --channel (1/2). See tts --help for defaults.
Command Groups
Chat
| Command | Description |
|---|---|
chat | Chat with MiniMax LLM |
stream | Stream chat completion |
TTS
| Command | Description |
|---|---|
tts | Synthesize text to speech (hex-decoded MP3 via SSE) |
voices | List available voice IDs |
Session
| Command | Description |
|---|---|
session status | Show session status |
session clear | Clear session history |
session history | Show command history |
Config
| Command | Description |
|---|---|
config set | Set a configuration value |
config get | Get a configuration value (or show all) |
config delete | Delete a configuration value |
config path | Show the config file path |
Utility
| Command | Description |
|---|---|
test | Test API connectivity |
models | List chat models |
models --tts | List TTS models |
Examples
Configure API Key
export MINIMAX_API_KEY="your-api-key"
# or
cli-anything-minimax config set api_key "your-api-key"
Chat
cli-anything-minimax chat --prompt "Explain quantum computing"
cli-anything-minimax stream --prompt "Write a Python quicksort"
TTS
cli-anything-minimax tts --text "Hello!" --output hello.mp3
cli-anything-minimax tts --text "Fast" --model speech-2.8-turbo --voice English_Insightful_Speaker --output fast.mp3
Chat Models
| Model ID | Description |
|---|---|
MiniMax-M3 | Next-generation flagship model (default) |
MiniMax-M2.7 | Peak Performance. Ultimate Value. |
TTS Models
| Model ID | Description |
|---|---|
speech-2.8-hd | High-definition TTS (default) |
speech-2.8-turbo | Fast TTS |
speech-2.6-hd | High-definition TTS |
speech-2.6-turbo | Fast TTS |
speech-02-hd | High-definition TTS |
speech-02-turbo | Fast TTS |
speech-01-hd | High-definition TTS |
speech-01-turbo | Fast TTS |
For AI Agents
- Always use
--jsonflag for parseable output - Check return codes — 0 for success, non-zero for errors
- Parse stderr for error messages on failure
- Use absolute paths for TTS output files
Version
1.0.0