Colab CLI

项目介绍

这是一个 Google Colab 的命令行客户端：在本地终端中申请 CPU、GPU（T4、L4、G4、H100、A100）或 TPU（v5e1、v6e1）运行时，并在其上执行 Python 代码。它面向希望以无头方式或脚本化使用 Colab 硬件的开发者，而不是在交互式笔记本里操作：可以运行本地脚本、Jupyter Notebook 或管道传入的 stdin 代码，上传下载远端文件，挂载 Google Drive，用 uv 安装依赖，导出会话历史。colab run 将申请、执行和销毁合并成一条命令，适合一次性的加速器任务。

快速使用

README 推荐用 uv 安装，也支持 pip 安装说明：

uv tool install google-colab-cli

然后申请一个 CPU 会话、通过 stdin 执行代码并释放 VM 快速开始：

colab new
echo 'print("Hello from Google Colab!")' | colab exec
colab stop

只有一个活动会话时可以省略 -s/--session。GPU 场景的文档流程是 colab new -s trainer --gpu A100，配合 colab install、colab exec -f train.py 和 colab download；更多场景见演示流程。

使用约束

CLI 仅支持 Linux 和 macOS，不支持 Windows。访问 Colab API 默认使用应用默认凭据（--auth adc），也可选择 OAuth2 并指定客户端配置文件路径。交互命令（repl、console）需要本地 TTY，在脚本中应通过管道传入 stdin。--high-mem 机型需要 Colab Pro 或 Pro+ 权益，L4 和 TPU 运行时会忽略该选项。会话元数据和令牌保存在 ~/.config/colab-cli/ 下，可用 --config 改到其他位置。使用需遵守 Colab 服务条款和 Google 隐私政策 法律与隐私。代码采用 Apache-2.0 许可证。

HotRepo 点评

仓库当前有 2,055 个 Star、294 个 Fork，2026-11-08 在 Python 日榜最高列第 5 位，当日新增 139 个 Star。目前只有这一条可观察的榜单记录，能说明该项目当天进入了 Python 日榜前列，不足以判断更长周期的热度变化；站内也没有记录到全语言日榜名次。