math-ai-org/mathcode

MathCode – 形式化数学编码助手

简介

• MathCode 是一个基于终端和浏览器的编码助手，与 Lean 4 证明助手紧密集成。它让您可以编写代码和形式化证明、查询当前的证明目标、搜索 Lean 库，并验证证明的正确性。

主要功能

• Lean 4 驱动的证明检查 – MathCode 可以检查目标、搜索声明、测试候选引理，并运行 Lean 的严格验证器来确认证明。
• 双重 UI – 使用命令行界面 (mathcode …) 或启动本地 WebUI 来呈现数学公式和图表。
• 知识库 – 已验证的定理及其明确假设可以存储并在 Obsidian 库中进行探索，建立个人的结果和依赖关系图库。
• 可扩展技能 – 您可以为代理添加 Python 分析工具、自定义 “MCP” 插件以及其他特定于项目的技能。

如何开始

1. 克隆存储库并运行提供的 setup.sh 脚本。
2. 验证所需的 codex 后端 (codex auth login)。
3. 运行 ./run 进行终端会话，或运行 ./run webui 使用浏览器 UI。
4. 若需要完整的证明助手功能，可选择使用 bash setup.sh --with-lean 安装 Lean 4 (约 10 GiB)。

支持平台

• macOS Apple Silicon (arm64)
• Linux x86_64 (需具备 glibc 和 AVX2)

典型工作流程

mathcode -p "prove that the square of an even number is even"

该指令会启动一个交互式会话，MathCode 会建议引理、使用 Lean 进行检查，并将最终定理记录在您的库中。

文档与社区

• 在线文档：https://math-ai-org.github.io/mathcode/docs/
• 发布版本、问题追踪和 Discord 社区链接皆可在 README 中找到。

重要性 MathCode 弥合了日常编码环境与形式化数学之间的鸿沟。通过将 Lean 验证嵌入熟悉的终端/WebUI 工作流程，它让开发人员和研究人员更容易在不离开常用工具的情况下编写机器验证的证明。

引用 若您在研究中使用 MathCode，请引用如下：

@misc{mathcode2026,
  title = {MathCode: A Frontier Mathematical Coding Agent},
  author = {Team Math-AI},
  year = {2026},
  url = "https://github.com/math-ai-org/mathcode"
}