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

```bash
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

```bash
# 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

```bash
export MINIMAX_API_KEY="your-api-key"
# or
cli-anything-minimax config set api_key "your-api-key"
```

### Chat

```bash
cli-anything-minimax chat --prompt "Explain quantum computing"
cli-anything-minimax stream --prompt "Write a Python quicksort"
```

### TTS

```bash
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

More agent context in HKUDS/CLI-Anything

74 other files this repository gives its agents, the first 60 shown.