qzcli CLI
CLI и MCP-сервер для платформы Qizhi: свободные GPU-узлы, отправка и логи заданий, причины очереди прямо из Claude Code
- 144 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Логин и пароль CAS и cookie хранятся локально в `~/.qzcli`.
- Команды отправки и остановки заданий расходуют квоту кластера и прерывают запущенные задания.
Установка
- Работает в
Ручная установка
pip install -r requirements.txt && pip install -e .Первые команды установки из README, их запускают в папке клона `qzcli_tool`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Логин и пароль CAS и cookie хранятся локально в `~/.qzcli`.
- Команды отправки и остановки заданий расходуют квоту кластера и прерывают запущенные задания.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
qzcli управляет облачной платформой для обучения моделей Qizhi (启智) из терминала в стиле `kubectl` или `docker`. Команда `qzcli login` получает cookie через CAS-авторизацию, `qzcli res -u` обновляет локальный кэш рабочих пространств, групп вычислений и проектов, а `qzcli avail` показывает свободные узлы и GPU по группам. Задания отправляют командами `qzcli create` для распределенного обучения, `qzcli hpc` для CPU-задач на Slurm и `qzcli batch` из JSON-файла. Логи читает `qzcli logs <job-id>` с режимами `tail` и `follow`. Команда `qzcli events` объясняет, почему задание стоит в очереди, и показывает историю сбоев узла, включая ошибки GPU XID, чтобы исключить плохую машину через `--exclude-node`. Отдельный бинарь `qzcli-mcp` открывает те же возможности агенту: он входит в платформу, обновляет ресурсы, ищет свободные узлы, перечисляет задания и показывает сырые статусы. Скилл `skills/qzcli-mcp` требует опираться на `status_raw`, потому что значения статусов платформы могут меняться.
Для кого. Исследователям и инженерам, которые обучают модели на кластере Qizhi и хотят проверять очередь и свободные GPU через Codex или Claude Code.
Подходит, если
- Перед запуском обучения надо узнать, в какой группе есть четыре свободных узла.
- Задание не стартует, и нужна платформенная причина очереди.
- Узел периодически роняет задания, и его история сбоев решает, кого исключать.
- Агент следит за заданиями и сообщает, что изменилось в статусах.
Не подходит, если
- У вас нет учетной записи на платформе Qizhi: инструмент работает только с ней.
- Задачи идут на другом кластере или в обычном облаке.
- Нельзя хранить пароль или cookie CAS на машине агента.
Пример запроса к агенту
Войди на платформу Qizhi и найди группу вычислений с четырьмя полностью свободными восьмикарточными узлами.Ограничения
Инструмент привязан к платформе Qizhi и ее API, документация написана по-китайски. Вход идет через CAS, пароль читается из переменной `QZCLI_PASSWORD`, файла `~/.qzcli/.env` или `~/.qzcli/config.json`. Если значения расходятся, `qzcli login` отказывается отправлять запрос, потому что платформа блокирует аккаунт по числу неудачных попыток. Кэш рабочих пространств нужно обновлять через `qzcli res -u` после добавления проектов. Команды `create`, `hpc` и `stop` занимают квоту кластера и останавливают задания, поэтому агенту нужно подтверждение человека.
Как отключить. Выполните `codex mcp remove qzcli` или `claude mcp remove qzcli`, затем `pip uninstall qzcli`. Cookie и кэш удалите командой `qzcli cookie --clear` и очисткой `~/.qzcli`.
Частые вопросы
Как подключить qzcli к Claude Code или Codex?
Поставьте пакет, затем выполните `claude mcp add qzcli -- qzcli-mcp` или `codex mcp add qzcli -- qzcli-mcp`. Командой `claude mcp list` проверьте подключение. Запускать `qzcli-mcp` вручную не нужно, клиент сам вызывает его.
Какие инструменты видит агент?
Среди них `qz_auth_login`, `qz_set_cookie`, `qz_refresh_resources`, `qz_get_availability`, `qz_list_jobs`, `qz_get_job_detail` и `qz_inspect_status_catalog`.
Как узнать свободные узлы?
Выполните `qzcli avail`. Флаг `-n 4 -e` ищет группы с четырьмя свободными узлами, `--lp` учитывает узлы, занятые заданиями низкого приоритета.
Почему в MCP важен status_raw?
Платформа может поменять значения статусов. Агент смотрит на исходное поле `status_raw`, а упрощенный `status_family` использует только как подсказку.
Где хранится пароль платформы?
Пароль берется из переменной `QZCLI_PASSWORD`, файла `~/.qzcli/.env` или `~/.qzcli/config.json` в таком порядке приоритета. Если значения расходятся, вход блокируется, чтобы не расходовать попытки до блокировки аккаунта.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMCP-сервер и CLI, который дает агенту запрашивать и настраивать облачные, SaaS и API-ресурсы обычными SQL-запросами
CLI на Go: вопросы к AWS, GCP, Azure, Cloudflare и Kubernetes на обычном языке, планы изменений и собственный MCP-сервер
CLI и оператор Kubernetes, который запускает Claude Code, Codex, Gemini, OpenCode и Cursor как задачи и сессии в кластере
CircleCI CLI
circleci-cli
Официальный CLI CircleCI показывает запуски и логи упавших тестов, а skills и MCP подключают его к Claude Code, Codex и Cursor.
Платформа на вашем сервере, которая выдает каждому агенту свою Linux-машину с SSH и MCP-инструментами для команд и файлов
Официальный скилл Vast.ai: агент ищет GPU-предложения, арендует экземпляры и управляет ими через vastai.
Коротко о README
Репозиторий содержит CLI, MCP-сервер, веб-панель `qzcli dashboard` с разбивкой занятых GPU по группам, проектам и пользователям и отчеты о покрытии API версии 2. В репозитории 54 проходящих теста.