如何在Google Colab环境中成功安装manimgl

直接在Colab执行!pip install manimgl失败的核心诱因是系统依赖缺失、基础构建工具版本过旧、Colab无图形环境的适配参数未配置，完全可以通过按顺序执行固定步骤完成安装，无额外特殊配置：

前置依赖安装 #

先完成基础构建工具、ManimGL所需系统库的安装，解决源码编译阶段的egg_info类报错：

• 升级Python侧构建工具链：
  !pip install --upgrade pip setuptools wheel
• 拉取安装系统级编译依赖：
  !apt-get update -qq && apt-get install -y -qq build-essential python3-dev libcairo2-dev libpango1.0-dev libglib2.0-dev libgles2-mesa-dev

ManimGL 正式安装 #

完成前置依赖后，直接安装稳定兼容版本即可，无需手动从源码拉取构建：

• 执行稳定版安装命令：
  !pip install manimgl==1.6.1

注意：不要跳过前置依赖步骤直接执行该命令，否则会触发setup.py egg_info类编译报错。

Colab 专属适配配置 #

Colab是无本地图形窗口的远程运行环境，安装完成后需要手动配置渲染参数，否则后续生成动画时会报显示设备连接错误：

• 导入库时提前指定无窗口渲染模式：

import os
os.environ["MANIMGL_USE_WINDOW"] = "0"
os.environ["SDL_VIDEODRIVER"] = "dummy"

• 验证安装是否成功，可直接运行最小测试动画代码，确认能正常导出mp4文件即代表安装完成。

常见报错排查 #

• 若仍触发Command errored out with exit status 1: python setup.py egg_info报错，优先检查是否漏装libcairo2-dev、libpango1.0-dev两个核心系统库，这两个库是ManimGL渲染文字、图形的必需编译依赖
• 不要在未升级setuptools的环境下直接安装ManimGL，旧版本setuptools无法兼容新版源码包的构建流程
• 避免安装开发预览版本的ManimGL，这类版本未做全平台兼容，容易在Colab环境下触发导入错误

内容的提问来源于stack exchange，提问作者Antoine Krajnc