wy51ai/easycolab

项目介绍

EasyColab 是一个面向 macOS 和 Windows 的桌面客户端，用来免开浏览器驱动 Google Colab 的 GPU 运行时。macOS 端使用 SwiftUI/AppKit 原生构建，Windows 端使用 PySide6/Qt6，并内置 Python、FFmpeg 和 Colab 连接组件。客户端负责唤醒云端实例，再在实例里拉起模型与服务。

项目默认适配 Colab G4（RTX PRO 6000 Blackwell，96 GB 显存），也支持 H100、A100、L4。功能围绕四套模型工作流展开：MiniMax-H3 文生/图生有声视频；带 Google Drive 持久化的 ComfyUI 节点工作台；提供 OpenAI 和 Anthropic 兼容接口的 Qwen 视觉语言网关；以及 Qwen-Image、Z-Image 的图片生成与指令修图。界面还会绘制 GPU 显存、系统内存和磁盘曲线，显示剩余 CU，并支持闲置自动释放实例。

快速使用

按平台选择最短路径。macOS 上推荐本地编译，避免未公证应用被 Gatekeeper 拦截：

git clone https://github.com/<your-username>/EasyColab.git
cd EasyColab
bash macos_app/build_macos_app.sh
open EasyColab.app

Windows 上可以从 Releases 或 Actions 构建产物下载免安装的 EasyColab-Windows-x64.zip，解压后运行 EasyColab.exe；也可以在本机已安装 Python 3.10–3.13 的情况下运行 windows_app\build_windows_app.bat 自行打包。源码开发模式则创建虚拟环境后执行 python windows_app/easycolab_win.py。

如果只有免费版 Colab 或更习惯网页，打开 Google Colab，上传仓库根目录的 EasyColab_Server.ipynb，选择 G4/A100/L4 运行时并顺序执行单元格。笔记本会输出一个 https://*.gradio.live 地址，把它粘贴到客户端左侧服务地址栏并连接即可。

完整的 Windows 与 macOS 步骤见中文 README，另有英文 README。

使用约束

免网页一键唤醒需要已开通 Colab Pro、Pro+ 或 Google AI Ultra 并拥有可用计算单元的 Google 账号；免费版用户应走 .ipynb 网页路径。macOS 本地编译需要安装 Xcode Command Line Tools，Windows 免安装包则不要求本机安装 Python，源码运行需要 Python 3.10–3.13。仓库不分发模型权重，各模型在运行时从 Hugging Face 下载并遵守各自的许可证；ComfyUI 按 GPL-3.0 单独拉取。本项目采用 Apache-2.0 许可证。

README 说明唤醒能力基于 google-colab-cli，建议只在自购付费账号上自用，不要用免费层做挖矿、批量多号或算力转售。项目也声明与 Google、MiniMax、Qwen 没有隶属或背书关系。macOS 预编译 .app 未经过公证，需要执行 xattr -cr 解除隔离；Windows 压缩包遇到 SmartScreen 时需要选择“仍要运行”。这两步都会降低系统默认防护，运行前应确认二进制来源与获取渠道。Google OAuth 凭证保存在本机；对外提供 Qwen 网关时应保持 API Key 鉴权开启。

HotRepo 点评

在 HotRepo 的新项目榜中，EasyColab 于 2026-11-08 进入 Python 语言榜记录，首个统计窗口内新增 101 Star 和 20 Fork。该项目没有全语言日榜名次记录，Star 曲线也只有一次采样，现有数据不足以判断热度走势。技术上值得注意的是，一个刚出现的客户端同时包含两套原生界面、四套大模型工作流，以及依赖外部 CLI 和付费 CU 的 Colab 唤醒链路；这也带来主要的不确定性：文档把预编译 Windows .exe 和未公证的 macOS .app 放在核心安装路径上，而仓库材料还无法说明这些产物与源码如何对应、由谁发布。