/cli-anything-minimax

name: "cli-anything-minimax"
description: >-
  Command-line interface for MiniMax AI — chat (MiniMax-M3, MiniMax-M2.7) and speech-2.x TTS via the MiniMax API.

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](https://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