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

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