mcpField
M
manimgx

manimgx

github.com/academa-labs创意与媒体2.3k43 次安装4 天前更新
代码仓库

关于 manimgx

ManimGX 是一项 Agent 技能，可根据用户的说明编写并渲染 Python 动画场景。它支持渲染前检查分镜与布局，并交付视频和可编辑源码。

主要功能

  1. 01创建 Python 动画场景
  2. 02检查分镜与时间线
  3. 03检测抽样的 2D 布局问题
  4. 04按指定尺寸和帧率渲染视频
  5. 05交付可编辑场景源码

适用场景

  1. 01将说明制作成动画
  2. 02检查场景时序与布局
  3. 03制作可编辑的教学视频

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/academa-labs/manimgx --skill manimgx

安装后在 Claude Code 中输入/manimgx确认已加载。

详细介绍

ManimGX

使用 ManimGX 将用户的说明转化为场景，检查布局和时间安排，并交付渲染后的视频及其可编辑的 Python 源码。

使用项目现有的 Python 环境。若要单独安装，uv tool install --python 3.14 manimgx 会提供 manimgx 命令。要求 Python 3.13 或更高版本。文本、数学公式和视频编码功能均已包含在软件包中。

导入 manimgx as m。其创作 API 遵循 Manim Community Edition；请查阅 ManimGX 自带的参考文档，了解支持的选项和行为。Agent 入门指南以 Markdown 格式提供指南和示例的链接。使用不熟悉的功能时，请阅读相关页面。

编写场景

将动画放在 Scene 子类的 construct 方法中。时间通过 self.play(...) 和 self.wait(...) 推进；self.add(...) 只会添加对象。使用 VGroup、next_to、arrange 和 to_edge 来组合和放置元素，使标签跟随对应主体。正文使用 Text，LaTeX 数学公式使用原始字符串和 MathTex。

例如，将以下内容保存为 scene.py：

import manimgx as m


class CircleArea(m.Scene):
    def construct(self) -> None:
        circle = m.Circle(radius=1, color=m.BLUE, fill_opacity=0.3)
        formula = m.MathTex(r"A = \pi r^2").next_to(circle, m.RIGHT, buff=0.6)
        m.VGroup(circle, formula).center()
        self.play(m.Create(circle), m.Write(formula))
        self.wait(1)

对于不断变化的数值，使用 ValueTracker 制作动画，并根据其值推导相关几何元素。updater 应使用经过的时间或当前状态，而不是帧数；更改导出的帧率应保留原有运动。3D 摄像机请使用 ThreeDScene。

检查并交付

manimgx inspect scene.py CircleArea
manimgx render scene.py CircleArea -r 1280x720 --fps 30 -o draft.mp4

inspect 会生成分镜图，并报告时间线和采样的 2D 布局问题。查看图像并修复非预期的重叠或裁切；使用 -t 0.5,end 检查特定时刻。这些检查基于采样，3D 场景只会生成分镜图，不会进行 2D 布局检查。除了静帧，也要检查草稿中的运动效果。

按照用户要求的尺寸和帧率渲染最终视频（-r WIDTHxHEIGHT 和 --fps RATE）。如果不指定这些选项，导出视频将为 1920×1080，帧率为 60 fps。交付时请附上输出路径和场景源码。

评论

支持 Markdown