Google Colab CLI запускает код на удалённых GPU и TPU из терминала

Google выпустила Colab CLI — интерфейс командной строки для работы с удалёнными средами Google Colab. Он позволяет запускать код на облачных GPU и TPU, не покидая локальный терминал. Инструмент распространяется с открытым исходным кодом по лицензии Apache 2.0.

С помощью CLI можно создавать сессии, выполнять код и управлять файлами. Команды доступны любому ИИ-агенту с доступом к терминалу, в том числе Claude Code, Codex и Antigravity. В комплект входит файл COLAB_SKILL.md с инструкциями для агентов.

Установка и быстрый запуск

Для установки используется команда uv tool install из репозитория Google Colab на GitHub:

uv tool install git+https://github.com/googlecolab/google-colab-cli

Минимальный пример создаёт сессию с процессором CPU, запускает команду Python и завершает сессию:

colab new                              # создать сессию с CPU
echo "print('hello')" | colab exec   # выполнить код
colab stop                             # завершить сессию

Сессии, вычисления и файлы

Команда colab new создаёт сессию; по умолчанию используется CPU. При необходимости можно запросить GPU T4, L4, A100 или H100. В CLI также предусмотрены варианты TPU v5e1 и v6e1. Доступность ускорителей зависит от активного плана Colab.

Команда colab exec запускает Python-код, полученный через стандартный ввод, из файла .py или ноутбука. CLI читает локальный файл и передаёт его содержимое в среду Colab, поэтому отдельно загружать изменённый файл не нужно. Команда colab stop завершает сессию и освобождает виртуальную машину.

Для перемещения файлов между локальным компьютером и удалённой средой служат команды colab upload и colab download. Команда colab drivemount подключает Google Drive; путь по умолчанию — /content/drive. Команда colab auth настраивает аутентификацию виртуальной машины для сервисов Google Cloud.

Журналы и интерактивная работа

Типичный рабочий цикл состоит из создания среды, запуска скрипта и получения результатов. Команда colab download скачивает модели, наборы данных и другие файлы. Команда colab log экспортирует историю сессии в форматах .ipynb, .md, .txt или .jsonl. Так удалённый запуск можно сохранить на компьютере, например, как ноутбук для повторного просмотра.

Для интерактивной работы с виртуальной машиной предусмотрены команды colab repl и colab console. Команда colab install устанавливает пакеты с помощью uv, а при необходимости использует pip. Метаданные сессий хранятся в ~/.config/colab-cli/sessions.json. При интерактивном запуске repl и console требуется TTY; в скриптах для этих команд нужно передавать данные через стандартный ввод.

Пример: дообучение Gemma 3 1B

В примере Google ИИ-агент запускает процесс дообучения модели google/gemma-3-1b-it методом QLoRA. Для обучения используется набор данных Text-to-SQL, предназначенный для улучшения генерации SQL-запросов. Полный процесс выполняется следующими командами:

colab new --gpu T4
colab install transformers datasets peft trl bitsandbytes accelerate
colab exec -f finetune_run.py
colab log --output gemma_finetune_log.ipynb
colab stop

После выполнения агент скачивает адаптер модели, конфигурацию адаптера, конфигурацию токенизатора и сам токенизатор. Дообученную модель можно загрузить и запустить локально. Пользователю не нужно вручную вводить команду для подготовки облачных ресурсов.

Чем CLI отличается от Colab в браузере

Задача Colab в браузере Colab CLI
Интерфейс Веб-интерфейс ноутбука Локальный терминал
Выбор ускорителя Меню среды выполнения в браузере Флаги --gpu и --tpu у команды colab new
Работа ИИ-агентов Вручную через интерфейс Любой терминальный агент через команды
Запуск локальных скриптов Вставка кода в ячейки или загрузка файла colab exec -f script.py
Получение результатов Ручная загрузка или Google Drive colab download и colab log
Установка пакетов !pip в ячейке colab install: сначала uv, затем pip
Управление сессией Средой управляют через браузер colab new, colab stop и colab status
Файл с инструкциями для агента Нет В комплект входит COLAB_SKILL.md

CLI не заменяет интерфейс ноутбуков Colab: он предназначен прежде всего для скриптов, автоматизации и работы с ИИ-агентами. Вычисления по-прежнему выполняются на инфраструктуре Colab и подчиняются модели работы сервиса.

Возможности и ограничения

  • Терминальный подход подходит для скриптов, CI-систем и циклов работы ИИ-агентов.
  • При создании сессии можно запросить GPU T4, L4, A100 или H100.
  • colab exec передаёт содержимое локальных файлов без отдельного шага загрузки.
  • Журналы можно экспортировать в форматы ноутбуков и текстовых файлов для воспроизводимости.
  • CLI распространяется по лицензии Apache 2.0 и включает файл с инструкциями для агентов.
  • Инструмент совместим с разными агентами, а не только с продуктами одного поставщика.
  • Для доступа требуется аутентификация; по умолчанию используется стратегия oauth2.
  • Для интерактивных команд repl и console нужен TTY; при запуске в скриптах следует передавать данные через стандартный ввод.
  • Вычисления выполняются на стороне Colab и зависят от условий работы его среды.