📌 项目地址：lightningpixel/modly | ⭐ 5,296 颗星 | 🔧 TypeScript | 📜 未标注
这项目解决了什么问题
把一张普通照片变成可用的 3D 模型，目前在线的 AI 生成服务不少，但你要么把图片传到别人的服务器，要么忍受排队和计费。Modly 是一个桌面应用，直接把开源 AI 模型跑在你的 GPU 上，图片不需要离开本机，输出的是真实可用的 3D 网格，而不是那些只有部分视角的伪 3D 效果。
它支持 Windows、Linux 和 Apple Silicon macOS，安装后可以在本地独立运行完整流程。
怎么跑起来
最省事的方式是直接去 Releases 页面下载对应系统的安装包。如果你想从源码跑，README 也给了完整步骤：
# Windows 平台启动
launch.bat
# Linux / macOS 平台启动
./launch.sh
如果要在开发模式下运行，先装 JS 依赖：
npm install
然后配置 Python 后端：
cd api
python -m venv .venv
.venvScriptsactivate # Windows
source .venv/bin/activate # Linux / macOS
pip install -r requirements.txt
最后启动：
npm run dev
测试和构建命令也直接列在 README 里：
npm test
./node_modules/.bin/tsc --noEmit -p tsconfig.node.json
npm run build
Apple Silicon 的 macOS 分包用这个命令：
npm run package:mac
整个应用由前端桌面壳、本地 Python 后端、AI 模型三部分组成。模型不在主程序里，而是通过扩展机制加载。
扩展系统才是关键
Modly 没有把所有模型绑死在一起，而是做了一个可插拔的扩展系统。每个扩展是一个 GitHub 仓库，包含 manifest.json 和对应的运行时入口文件。也就是说，你可以根据想要的生成效果，换上不同团队做的开源模型。
官方已经提供了五个扩展：
| 扩展 | 模型 |
|---|---|
| modly-hunyuan3d-mini-extension | Hunyuan3D 2 Mini |
| modly-hunyuan3d-mini-turbo-extension | Hunyuan3D 2 Mini Turbo |
| modly-hunyuan3d-mini-fast-extension | Hunyuan3D 2 Mini Fast |
| modly-triposg-extension | TripoSG |
| modly-trellis2-gguf-extension | Trellis2 GGUF |
其中 Hunyuan3D 是腾讯开源的图像转 3D 模型，TripoSG 和 Trellis2 也是目前社区里比较活跃的生成模型。第五个扩展是 Trellis2 的 GGUF 量化版，意味着你可以在显存更有限的情况下尝试跑更大的模型。
安装方式很直接：在 Models 页面点击 Install from GitHub，输入扩展仓库的 HTTPS 地址，确认后按提示完成安装。具体的后续步骤 README 没有展开，新版本以官方文档为准。
运行前，Modly 会校验 workflow 的连线。如果图是无效的，它不会直接崩溃，也不会把你当前正在看的网格视图丢掉，而是把错误留在原处，用内联提示或 toast 告诉你哪里有问题。这个细节很实用，因为生成链路里任何一个环节配错了，直观的提示比白屏好得多。
几个值得注意的平台差异
README 明确写了几个限制：
- macOS 只支持 Apple Silicon，Intel Mac 跑不了。
- macOS 使用原生窗口控件，Windows/Linux 是自定义控件。
- 主进程会提供一个实时的 RAM 占用指示器，显示在顶部栏里。
- 导入的网格可以在应用内直接做平滑和减面（decimate），优化后的结果会写回 workspace，不需要再导出到别的工具。
适合什么样的人
如果你手上有一批未公开的角色概念图或产品设计图，想快速转成 3D 白模做灰盒验证，但图不能上传到云端，那 Modly 的“完全本地运行”就是最核心的价值。它当然需要一块能跑生成模型的 GPU，但省掉的是上传下载、注册账号、按次付费这些在线服务的麻烦。
由于它是 Electron 桌面应用 + Python 后端 + 可插拔模型的架构，部署起来比单纯的命令行工具多一层环境配置，但换来的是可视化的图形界面、模型切换和流程校验。如果只是想跑个命令行测试，那这不是你要找的工具。
另外，扩展是从 GitHub 仓库安装的，相当于往应用里执行第三方代码，安装前值得看一眼仓库的可信度。README 本身没有提到具体许可证，项目说是 open source，但具体条款需要去仓库确认。
如果你想在自己的电脑上体验“不需要联网就能把照片变成 3D 模型”这件事，Modly 是目前把开源模型集成得比较完整的一个桌面端选择。