Modly：本地 AI 图像转 3D 网格生成桌面应用
Modly 是一款开源桌面应用，利用本地 AI 模型将照片转换为 3D 网格，完全在 GPU 上运行，支持 Windows、Linux 和 Apple Silicon macOS。
社区作者 · Aitroys 管理员
它解决什么问题
Modly 是由 Lightning Pixel 创建的本地开源 AI 图像转 3D 网格生成工具。用户可以将任意照片转换为 3D 模型，整个过程完全依靠本地 GPU 上的开源 AI 模型完成，无需上传数据或依赖云端。该应用支持 Windows、Linux 和 Apple Silicon macOS，既可通过下载安装包使用，也可通过克隆仓库直接运行。
Modly 提供了可视化工作流系统，用户可以在 Workflows 标签中搭建图像到网格生成的流程，例如 Image -> Generate Mesh -> Add to Scene，并可在 Generate 标签中一键生成 3D 模型。应用还支持导入网格的平滑与减面优化，并将结果写回工作区。顶栏包含实时 RAM 指示器，工作流在运行前会进行校验，无效图会保留并给出内联或提示警告。
Modly 支持扩展系统，用户可通过 GitHub 仓库安装外部模型和过程扩展。官方提供的扩展包括 Hunyuan3D 2 Mini、Hunyuan3D 2 Mini Turbo、Hunyuan3D 2 Mini Fast、TripoSG 和 Trellis2 GGUF 等模型。扩展安装后，可在 Models 页面下载模型或变体，过程扩展则在安装完成后即可使用。
此外，Modly 还提供基于标准库的 CLI，供代理和脚本调用运行中的桌面应用，支持 health、model、workflow-run、capability、process-run 等命令，并输出机器可读的 JSON 结果。项目采用 MIT 许可证，允许分叉和二次开发，但需保留原项目与创作者的署名。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
一、使用安装包安装
前往 GitHub Releases 页面下载适用于 Windows、Linux 或 Apple Silicon macOS 的最新安装包，按提示安装。
二、从源码运行
步骤 1 · 克隆仓库：
git clone https://github.com/lightningpixel/modly- 进入仓库目录。
- Windows 下运行 launch.bat；Linux/macOS 下运行 ./launch.sh。
三、开发模式搭建
步骤 1 · 安装 JS 依赖：
npm install- 设置 Python 后端：
cd apipython -m venv .venvWindows 激活：.venv\Scripts\activate Linux/macOS 激活：source .venv/bin/activate
pip install -r requirements.txt步骤 3 · 运行开发服务：
npm run dev- 测试与构建：
npm test./node_modules/.bin/tsc --noEmit -p tsconfig.node.jsonnpm run build四、平台注意事项
- macOS 仅支持 Apple Silicon。
- macOS 使用原生窗口控件，Windows 和 Linux 使用自定义控件。
- 顶栏显示来自主进程的实时 RAM 指示器。
- 工作流在运行前会验证连接；无效图保留在原处并显示内联或提示警告。
macOS 打包命令：
npm run package:mac。
- 导入的网格可在应用内平滑和减面，优化结果写回工作区。
五、安装扩展
- 打开 Models 页面，点击 Install from GitHub。
- 输入扩展仓库的 HTTPS URL 并确认。
- 如果扩展提供模型节点，下载模型或某个变体；过程扩展在安装和设置完成后即可使用。
六、基本工作流
在 Workflows 标签中创建并连接步骤，例如：Image -> Generate Mesh -> Add to Scene。然后在 Generate 标签中选择该工作流，点击 Generate 3D Model。如有问题，可在 Settings/Logs/Errors 中查看。
七、CLI 使用示例
python tools/modly-cli/agent.py healthpython tools/modly-cli/agent.py model listpython tools/modly-cli/agent.py workflow-run status <run_id>python tools/modly-cli/agent.py generate --image ./input.png --output ./export.glb详细代理工作流和输出约定见 tools/modly-cli/SKILL.md。
