MiniMax CLI
Официальный CLI mmx платформы MiniMax со скиллом для агентов: текст, изображения, видео, речь, расшифровка аудио, анализ картинок и поиск
- 2 210 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Команды отправляют ваши запросы, тексты, изображения и аудио на серверы MiniMax и тратят баланс тарифа
- Ключ API или токены OAuth хранятся в файлах в `~/.mmx`
- Команда `mmx agent setup` меняет конфигурационные файлы выбранных агентов, а в интерактивном режиме может установить их
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/minimax-cliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Команды отправляют ваши запросы, тексты, изображения и аудио на серверы MiniMax и тратят баланс тарифа
- Ключ API или токены OAuth хранятся в файлах в `~/.mmx`
- Команда `mmx agent setup` меняет конфигурационные файлы выбранных агентов, а в интерактивном режиме может установить их
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MiniMax CLI ставит команду `mmx`, через которую агент или человек обращается к моделям платформы MiniMax прямо из терминала. Команда `mmx text chat` ведет диалог с моделью: поддерживает потоковый вывод, системную подсказку, историю из файла и описания инструментов, `mmx image` создает изображения по описанию с выбором соотношения сторон и пакетом из нескольких картинок, `mmx video generate` запускает асинхронную генерацию ролика (модели Hailuo-2.3 и MiniMax-H3, у второй есть стартовый кадр, опорные изображения и видео) и показывает ход выполнения. `mmx speech synthesize` озвучивает текст голосами на выбор с управлением скоростью, `mmx speech transcribe` расшифровывает аудио в текст, json или субтитры srt и vtt, `mmx vision` описывает изображение, `mmx search` ищет в сети средствами MiniMax. Для агентов в репозитории есть скилл `mmx-cli` с описанием каждой команды и флагами для неинтерактивной работы: `--non-interactive`, `--quiet`, `--output json`, `--async`, `--dry-run` и `--yes`. Отдельный скилл `h3-video` описывает работу с видеомоделью MiniMax-H3. Команда `mmx agent setup` настраивает MiniMax как поставщика модели для Claude Code, Codex, Grok Build, OpenCode, Hermes, Pi и Oh my Pi, проверяет ключ и регион до записи и перед изменением файлов делает копию. Авторизация идет через OAuth с кодом устройства и PKCE или по ключу API: `mmx auth login`, `mmx auth login --api-key`. Регион (Global на `api.minimax.io` или CN на `api.minimaxi.com`) определяется автоматически, остаток лимита показывает `mmx quota`.
Для кого. Для разработчиков и авторов контента, у которых есть тариф или ключ MiniMax и которым нужны генерация текста, картинок, видео и речи прямо из терминала и агента.
Подходит, если
- Агенту нужно сгенерировать изображение, ролик или озвучку командой в скрипте, с выводом в json для разбора
- Нужно расшифровать запись встречи или звонка в текст или субтитры, включая режим с говорящими и отметками времени
- Хочется быстро спросить модель MiniMax или поискать в сети средствами платформы без отдельного сервера
- Нужно подключить MiniMax как поставщика модели сразу в нескольких агентах одной командой `mmx agent setup`
- Задачи идут в CI или сервисе: ключ передается флагом `--api-key`, а каталог настроек задается `MMX_CONFIG_DIR`
Не подходит, если
- Нет доступа к MiniMax: CLI обращается только к платформе MiniMax
- Нужны модели других поставщиков: команды `mmx` вызывают только модели MiniMax
- Аудио длиннее 500 секунд или больше 50 МБ: такие файлы для расшифровки не принимаются
- Поиск должен выдавать больше 10 результатов за запрос: интерфейс поиска не поддерживает постраничный вывод
Пример запроса к агенту
Сгенерируй картинку кота в скафандре через mmx и сохрани ее в папку outОграничения
Нужны Node.js 18 или новее и доступ к MiniMax: README требует тариф Token Plan, а настройка агентов различает подписку и ключи `sk-api-...` с оплатой по факту. Предварительная модель `MiniMax-M3.1-Flash-Preview`, которую CLI берет по умолчанию, сейчас доступна по тарифу M Plan или MiniMax Code; для ключа с оплатой по факту нужно явно указать `--model MiniMax-M3`. Расшифровка принимает wav, aiff, flac, m4a, mp3, aac, opus и ogg до 50 МБ и 500 секунд; файл больше 50 МБ отклоняется локально. Для MiniMax-H3 заранее проверяются размеры: изображение до 30 МБ, опорное видео до 50 МБ, аудио до 15 МБ, весь запрос до 64 МБ.
Поиск возвращает до 10 результатов за вызов. Данные уходят на серверы MiniMax выбранного региона. В README заявлена лицензия MIT, но файла LICENSE в репозитории нет, и GitHub лицензию не определяет: права на использование и копирование не определены, уточните у автора. Репозиторий принадлежит самой MiniMax, версия в `package.json` стоит как `0.0.0-dev`, настоящая выводится из тега при выпуске.
Как отключить. Удалите пакет командой `npm uninstall -g mmx-cli` и скилл из менеджера скиллов агента. Выйдите из аккаунта командой `mmx auth logout`, настройки и токены лежат в `~/.mmx` (или в папке из `MMX_CONFIG_DIR`). Конфигурации агентов, записанные командой `mmx agent setup`, верните из созданных ею резервных копий.
Частые вопросы
Как войти в аккаунт?
Команда `mmx auth login` предлагает OAuth (с кодом устройства по RFC 8628 и PKCE, браузер откроется для ввода кода) или вставку ключа API. Для CI подходит `mmx auth login --api-key sk-xxxxx`. OAuth и ключ взаимоисключающие: вход одним способом очищает другой. Приоритет у флага `--api-key`, затем OAuth, затем ключ из настроек.
Как работает генерация видео?
Команда `mmx video generate --prompt ...` запускает задачу и по умолчанию ждет результата, с `--async` сразу возвращает идентификатор. Статус смотрит `mmx video task get --task-id`, файл скачивает `mmx video download --file-id`. Для MiniMax-H3 по умолчанию 2K, 5 секунд и 16:9 при генерации из текста.
Что делает `mmx agent setup`?
Настраивает MiniMax для Claude Code, Codex, Grok Build, OpenCode, Hermes, Pi и Oh my Pi, сохраняя посторонние настройки. По умолчанию берет `MiniMax-M3.1-Flash-Preview` для подписки и `MiniMax-M3` для ключей `sk-api-...` с оплатой по факту. Режим `--dry-run` показывает изменения без реального запроса, сам агент команда не запускает.
Какие регионы и адреса используются?
Global на `api.minimax.io` и CN на `api.minimaxi.com`. Регион определяется автоматически (для ключа проверяются оба), задается флагом `--region` или переменной `MINIMAX_REGION`. Адрес можно переопределить переменной `MINIMAX_BASE_URL`.
Можно ли использовать CLI как библиотеку?
Да. Пакет экспортирует `mmx-cli/sdk` с типами TypeScript, описание лежит в `SDK.md`. Для скриптов также есть переменные окружения: `MINIMAX_OUTPUT`, `MINIMAX_TIMEOUT` и `MINIMAX_VERBOSE` для подробного журнала запросов.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыОфициальный MCP-сервер MiniMax: синтез речи, клонирование и дизайн голоса, генерация изображений и видео
MCP-сервер для Autodesk 3ds Max: агент читает сцену, моделирует, настраивает материалы и модификаторы
Локальный синтез речи для агентов: команда и скилл озвучивают текст, клонируют голос по записи и собирают музыку из партитуры без облака и платы за символы
Набор скиллов для агентов, чтобы генерировать и редактировать изображения, видео и звук через сервис muapi.ai и muapi-cli
Higgsfield CLI
higgsfield-cli
Официальная консольная утилита Higgsfield: более 40 моделей для изображений, видео, 3D и аудио и анализ готового видео из терминала
Скилл пишет промпты для генерации видео, картинок и музыки на 14 платформах и по желанию отправляет их в браузере
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| MiniMax CLI (эта запись) | да | 2 210 | ||
| MiniMax MCP | да | API-ключ | 1 594 | официальный MCP-сервер MiniMax: синтез речи, клонирование голоса, генерация изображений и видео через протокол MCP |
| MiniMax Skills | да | 13 744 | 17 скиллов от MiniMax по разработке и документам, без доступа к моделям генерации из терминала |
Коротко о README
Описание на английском и китайском называет проект официальным CLI платформы и перечисляет возможности: текст, изображения, видео, речь, зрение, поиск и два региона. Затем идут установка, быстрый старт, подробные разделы по каждой группе команд с примерами, переменные окружения, настройка агентов и обновление. В репозитории лежат справочник по SDK, описание ошибок, заметки о проектировании CLI и выпуске версий, а также два скилла для агентов.