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:

• 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

1. Always use --json flag for parseable output
2. Check return codes — 0 for success, non-zero for errors
3. Parse stderr for error messages on failure
4. Use absolute paths for TTS output files

Version

1.0.0