cli-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:
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
--json flag 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
HKUDS