跳转至

欢迎

ManimGX

面向智能体的极速 3D 动画引擎,兼容 Manim CE 的 API。
由 Rust 和 wgpu 驱动。用提示词或 pip 安装。可在浏览器中运行。

文档 · 快速入门 · 示例 · API 参考

测试覆盖率 PyPI 版本 npm 版本 PyPI 总下载量 npm 月下载量

求根公式:通过移动彩色矩形和方程项来完成配方 傅里叶级数:一串旋转的箭头勾勒出 π 的轮廓 矩阵移动平面:网格、基向量箭头和单位正方形一同变换
切线沿曲线滑动,其斜率描绘出导数 复函数将网格弯折成抛物线、圆和射线 洛伦兹吸引子:相邻轨迹在三维中分离,勾勒出蝴蝶形状
三个旋转陀螺进动和章动,其轴线在玻璃球面上描绘出曲线 霍普夫纤维化:彩色相连的圆构成嵌套的环面,珠子沿其穿行 彩虹螺旋面弯折成悬链面,同时保持其内蕴曲率

36.2 秒的视频,在 3.08 秒内渲染完成。 在 Apple M4 Pro 上以 1080p60 渲染五个场景,ManimGX 比 ManimCE 快 90.6 倍,比 ManimGL 快 11.5 倍,比 Blender Workbench 快 18.7 倍,从启动到生成 MP4。测量方法:场景、设置和每次运行。

总渲染时间:ManimGX 3.08 秒,ManimGL 35.28 秒,Blender Workbench 57.61 秒,ManimCE 278.83 秒,Blender EEVEE 601.40 秒

所有引擎均使用可用的最快编码预设。数值越低越好。

对比同一场景。 2.5 秒时的相连圆环,由每个引擎渲染。

ManimGX ManimCE ManimGL Blender Workbench Blender EEVEE
ManimGX 在 2.5 秒时渲染的八个相连圆环 ManimCE 在 2.5 秒时渲染的八个相连圆环 ManimGL 在 2.5 秒时渲染的八个相连圆环 Blender Workbench 在 2.5 秒时渲染的八个相连圆环 Blender EEVEE 在 2.5 秒时渲染的八个相连圆环

快速入门

用提示词。 粘贴到 Claude Code、Codex 或 Cursor 中。你的智能体负责设置:

Follow https://www.aipaikj.top/llms.txt.
Install ManimGX, make a 3D animation of the solar system, and open it.

用 pip。 在 macOS、Linux 或 Windows 上安装,需要 Python 3.13+:

pip install manimgx

字体、排版和视频编码均已包含。 如需编辑器设置和引导式首次动画,请参考 快速入门。

从 Python 到 MP4

将以下内容保存为 scene.py:

import manimgx as m


class Hello3D(m.ThreeDScene):
    def construct(self) -> None:
        self.set_camera_orientation(phi=65 * m.DEGREES, theta=-45 * m.DEGREES)
        self.begin_ambient_camera_rotation(rate=0.5)
        cube = m.Cube(side_length=3, fill_opacity=0.3, stroke_width=2)
        self.play(m.Create(cube), run_time=2)
        self.wait(4)

渲染:

manimgx render scene.py

你将得到 Hello3D.mp4,一段 1080p60 视频:

蓝色立方体在相机环绕时被绘制出来

为什么选择 ManimGX?

面向智能体时代的 3D 视频 API。 你的智能体使用 Manim CE 的 API 编写 Python。ManimGX 的 Rust + wgpu 引擎极速渲染 MP4。

  • 完全静态类型。 包括关键字参数和 .animate 链。
  • 2D 与 3D 并存。 曲面、网格和移动相机与文本、方程 和图形并列。
  • 可在浏览器中运行。 npm install manimgx。Pyodide 在 Web Worker 中运行 Python;WebGPU 渲染场景。 嵌入场景无需渲染服务器。
  • 智能体反馈。 manimgx inspect:故事板和 2D 布局检查,在播放结束处或你选择的时刻。
  • 文本与数学。 编写 LaTeX 或 Typst。无需安装 LaTeX。
  • 语音同步。 将动画与口述词语匹配 使用 self.say()。

文档

www.aipaikj.top 提供指南、带源代码的 渲染示例和 API 参考:

  • 快速入门:安装、设置 编辑器并渲染你的第一个场景。
  • 用户指南:学习场景、 动画、3D、文本和声音,每次一个概念。
  • 示例:观看完整影片并阅读 生成它们的 Python 代码。
  • API 参考:查找类、方法 及其类型化参数。
  • 从 Manim CE 迁移: 改编现有场景并查看行为差异之处。

对于智能体,llms.txt 以 Markdown 格式提供设置说明 和文档链接。

巨人肩上

Grant Sanderson 创建了 Manim。ManimGX 以 Manim Community Edition 的 API 为目标,这是广泛使用的 社区维护分支。

Rust 渲染器使用 wgpu 进行原生 GPU 渲染,在浏览器中使用 WebGPU。 其 3D 光照改编自 Google 的 Filament:基于物理的材质、 基于图像的光照、环境光遮蔽、泛光和 AgX 色调映射。 Typst 排版文本和数学,mitex 将 LaTeX 输入转换为 Typst。 x264 将原生视频导出编码为 H.264;FFmpeg 解码导入的音频,使用 libopus 处理 Opus。

Pyodide 在浏览器 worker 中运行 Python 场景。Linux wheel 捆绑 Mesa 的 lavapipe,在没有合适 GPU 时用于 CPU 上的 Vulkan 渲染。

社区

ManimGX 是 Academa 的开源项目,由 Abdullah Geduk 和 Sina Atalay 创建。数境(ShuJing)是其中文适配衍生发行版,由爱派未来科技维护。我们欢迎社区的贡献。

问题、错误报告和功能请求请从 issue 开始。 如需贡献代码,请阅读贡献指南 和开发者指南。

变更日志 · 引用 ManimGX

所有参与者请遵守 行为准则。 请通过 安全策略 私下报告漏洞。

许可证

ManimGX 自身的代码采用 MIT 许可证。 原生 wheel 包含 x264,整体采用 GPL-3.0-or-later。

捆绑的组件保留其许可证:参见 第三方声明、 Linux 渲染器声明, 以及 Noto 和 Noto CJK 字体许可证。

本软件使用了 FFmpeg 的代码,其许可为 LGPL-2.1-or-later。 完整源代码(包括 FFmpeg)位于每个 GitHub 发布版 的 manimgx-X.Y.Z-source.tar.xz 中。