$Math-To-Manim$

Math-To-Manim

输入文字或图片，自动生成数学物理动画和笔记

Math-To-Manim 是一个用 Python 编写的开源工具，目标是把数学和物理内容自动转成动画视频和学习笔记。用户只需输入一段文字描述或上传一张图片（比如公式截图、几何图形），系统就能生成对应的动态演示，帮助理解抽象概念。它解决的核心问题是：传统数学物理教学依赖静态板书和文字，难以直观展示变化过程，而手工制作动画门槛高、耗时长。该项目通过自动化流程，把文本或图像解析成可渲染的动画脚本，再输出视频或笔记，让教师、学生和内容创作者能快速产出高质量的可视化材料。核心能力包括：文本到动画的转换、图像识别与公式解析、物理模拟与数学函数可视化、以及生成配套学习笔记。适合课堂演示、自学复习和科普视频制作。

开源 free 学习教育

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2698

维护状态活跃

是否开源是

定价模式 free

项目预览

项目数据

分类学习教育

开发团队HarleyCoops

所属国家

官网地址

GitHubhttps://github.com/HarleyCoops/Math-To-Manim

定价模式free

价格说明开源免费使用

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型

GitHub 星标★ 2698

30天Star增速

HF 下载量

上线时间2025-01-20 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-07

浏览次数0

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：进阶约 30 分钟部署方式：命令行工具 4 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

Python 3.10 及以上
Node.js 18 及以上
FFmpeg（用于视频合成）
LaTeX（用于公式渲染）
Manim 所需的系统依赖（含 C 编译工具链等）

安装与启动步骤

1安装系统依赖

先自行装好 Python 3.10+、Node.js 18+、FFmpeg、LaTeX 以及 Manim 的系统依赖，缺一项都可能渲染失败。
2克隆项目仓库

从 GitHub 拉取源码并进入项目目录，后续命令都在该目录内执行。
```
git clone https://github.com/HarleyCoops/Math-To-Manim.git
cd Math-To-Manim
```
3创建虚拟环境

README 明确给出的唯一安装命令，在仓库根目录生成 .venv 虚拟环境。
```
python -m venv .venv
```
4激活虚拟环境

Linux/macOS 用此命令；Windows 执行 .venvScriptsctivate。README 未给出后续依赖安装命令。
```
source .venv/bin/activate
```

关键配置

配置项	必填	说明	示例
`Codex ChatGPT 登录`	是	主流程使用官方 Codex SDK，需要已登录的 ChatGPT 账号来调用模型	`Codex ChatGPT 登录状态`
`gpt-6-astra 模型`	是	官方默认用该模型担任作者与证据审核角色	`gpt-6-astra`

如何确认成功

检查仓库下 runs/astra// 是否生成了完成清单（completion manifest）及渲染产物与日志。

常见问题

Q：必须装 LaTeX 和 FFmpeg 吗？

A：README 的安装说明中把 Manim 系统依赖、FFmpeg 和 LaTeX 与 Python、Node.js 并列要求，属于必需环境，建议全部提前安装。

Q：生成的中间文件和视频在哪里？

A：每次运行都会写入 runs/astra//，其中包含原始请求、已接受的产物、全部候选尝试、独立评审、SDK 线程 ID、工具调用轨迹、渲染日志、抽样帧和完成清单。

Q：任务中断后可以接着跑吗？

A：可以。恢复运行时会复用已接受且匹配的阶段产物，并在完成前重新渲染和复查影片。

Q：需要联网或账号吗？

A：主流程基于官方 Codex SDK 与 Codex ChatGPT 登录调用 gpt-6-astra，因此需要相应账号与网络环境。

注意事项

README 节选的安装部分被截断，创建虚拟环境后是否还需安装 Python 依赖请以仓库最新说明为准。
Manim 渲染依赖 FFmpeg 与 LaTeX，建议先把这两项装好再运行流程。
评审记录通过 SHA-256 哈希与对应文件绑定，请勿手动修改 runs 目录内的产物。

核心亮点

支持文本和图片两种输入方式，降低使用门槛
自动生成动画和笔记，节省手工制作时间
专注数学物理领域，公式和模拟场景针对性强

不足之处

项目较新，文档和社区生态尚在成长中
生成效果可能受输入描述清晰度影响，需要一定调试

适用场景

教师制作课堂动态演示课件
学生把抽象公式转成可视化动画辅助理解
科普创作者快速生成数学物理短视频素材

替代项目

Manim、GeoGebra

项目介绍

Math-To-Manim 是学习教育领域的开源项目，由 HarleyCoops 开发，2025 年首次发布。

在全站 13,821 个收录项目中，它的 GitHub 星标数（2,698）位列前 30%，在学习教育分类中处于中上游。

项目目前处于活跃维护状态，最近一次代码更新于 2026-10-02。开源免费使用。

它主要面向的使用场景是：教师制作课堂动态演示课件。同类可对比的替代方案包括 Manim、GeoGebra。

上一篇：exam-platform

下一篇：free-ai-notebooks