cli-anything-minimax

# 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