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 и зависят от условий работы его среды.