Skip to main content

Unofficial MiniMax CLI - downloads and runs the Rust binary

Project description

MiniMax CLI

MiniMax CLI

CI

Terminal client for MiniMax M2.1. Chat, agent mode, and native media generation.

Note: Currently tested with the standard MiniMax API only. The MiniMax coding-focused plans have not been tested yet.

What's Unique

MiniMax M2.1 has built-in media generation APIs. This CLI exposes them directly:

# Generate images
/minimax image "a cat wearing a space helmet"

# Generate music
/minimax music "lo-fi beats, rainy day, piano"

# Text-to-speech with voice cloning
/minimax tts "Hello world" --voice custom_voice

# Generate video clips
/minimax video "drone shot of mountains at sunset"

These aren't wrappers around other services - they're native MiniMax capabilities included with your API key.

Install

# npm / bun
npm install -g minimax-cli
bun install -g minimax-cli

# pip / uv
pip install minimax-cli
uv pip install minimax-cli

# cargo (builds from source)
cargo install minimax-cli

Or download prebuilt binaries from Releases.

Usage

minimax              # Interactive TUI
minimax -p "prompt"  # One-shot mode
minimax --yolo       # Agent mode (shell + file tools)

Configuration

Create ~/.minimax/config.toml:

api_key = "your-api-key"

Or set MINIMAX_API_KEY in your environment.

Get an API key at platform.minimax.io.

Features

  • Chat: Streaming responses, 204K context, interleaved thinking
  • Agent mode: File operations, shell execution, MCP tool support
  • Media generation: Images, audio, video, music - all native to MiniMax
  • Skills: Reusable workflows for complex multi-step tasks

Commands

Command Description
/help Show help
/mode Switch modes (normal/edit/agent/plan)
/model Switch models (M2.1 / M2.1-lightning)
/yolo Enable agent mode
/skills List available skills
/minimax Media generation commands
/save /load Session management
/tokens Show usage

Skills

Skills are multi-step workflows that combine chat + media tools. Examples:

  • video-studio - Script, narrate, and render short videos
  • voiceover-studio - Design voices and produce narration
  • audiobook-studio - Convert text to multi-chapter audiobooks
  • music-video-generator - Sync generated music with video

Run with /skills <name>. Create your own in ~/.minimax/skills/.

Documentation

License

MIT


Unofficial project. MiniMax is a trademark of MiniMax Inc.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

minimax_cli-0.1.0a1.tar.gz (4.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

minimax_cli-0.1.0a1-py3-none-any.whl (5.2 kB view details)

Uploaded Python 3

File details

Details for the file minimax_cli-0.1.0a1.tar.gz.

File metadata

  • Download URL: minimax_cli-0.1.0a1.tar.gz
  • Upload date:
  • Size: 4.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for minimax_cli-0.1.0a1.tar.gz
Algorithm Hash digest
SHA256 196e6eede3935cb062a3c5a275a6f9520f85530e6b9c9a5aacd094c9a2fbfa73
MD5 3f16d6482f99d5d25c4a8f1551deaf6b
BLAKE2b-256 55391e0aba591a399eac35e122f74d90a840b9bf4aa38672043e7b13f4877e75

See more details on using hashes here.

Provenance

The following attestation bundles were made for minimax_cli-0.1.0a1.tar.gz:

Publisher: publish.yml on Hmbown/MiniMax-CLI

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file minimax_cli-0.1.0a1-py3-none-any.whl.

File metadata

  • Download URL: minimax_cli-0.1.0a1-py3-none-any.whl
  • Upload date:
  • Size: 5.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for minimax_cli-0.1.0a1-py3-none-any.whl
Algorithm Hash digest
SHA256 d937ff365659e2050238576a65a5b1dd958a383ccc6e15251ea241597d3da13e
MD5 db38956572c838c299bdef2946028436
BLAKE2b-256 8d022893da0d3db8787c72bf52dea38b979bfd4257486a67ac2fe3fa7ccc6cc9

See more details on using hashes here.

Provenance

The following attestation bundles were made for minimax_cli-0.1.0a1-py3-none-any.whl:

Publisher: publish.yml on Hmbown/MiniMax-CLI

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page