
Modly Local:开源、由AI驱动的图像转3D网格生成工具
Modly Local能利用完全在你的GPU上运行的开源AI模型,将任何照片转化为3D模型。它是一款支持Windows、Linux和搭载Apple Silicon的macOS的桌面应用程序,由Lightning Pixel开发。
下载
你可以前往Releases页面,下载适用于Windows、Linux或搭载Apple Silicon的macOS的最新安装程序。此外,你也可以克隆仓库,直接运行应用而无需安装:
- Windows:`launch.bat`
- Linux / macOS:`./launch.sh`
快速开始
- 安装JS依赖:`npm install`
- 设置Python后端
- 进入 `api` 目录:`cd api`
- 创建虚拟环境:`python -m venv .venv`
- 激活虚拟环境
- Windows:`.venv\Scripts\activate`
- Linux / macOS:`source .venv/bin/activate`
- 安装依赖:`pip install -r requirements.txt`
- 开发模式运行:`npm run dev`
- 测试
- `npm test`
- `./node_modules/.bin/tsc --noEmit -p tsconfig.node.json`
- `npm run build`
平台说明
- macOS仅支持Apple Silicon。macOS使用原生窗口控件,而Windows和Linux则保留现有的自定义控件。
- 顶部栏包含一个实时RAM指示器,数据来源于主进程。
- 工作流连线在运行前会进行验证;无效的图表会保留在原地,并显示内联或吐司式警告,而不会关闭当前的网格视图。
- 使用 `npm run package:mac` 为搭载Apple Silicon的macOS打包。
- 导入的网格可以在应用内进行平滑和简化处理,优化后的结果会写回工作区。
扩展系统
Modly支持外部模型和处理扩展。每个扩展都是一个GitHub仓库,包含 `manifest.json` 以及其类型所需的运行时入口文件。
官方扩展
| 扩展名称 | 模型 | URL |
|---|---|---|
| modly - hunyuan3d - mini - extension | Hunyuan3D 2 Mini | https://github.com/lightningpixel/modly - hunyuan3d - mini - extension |
| modly - hunyuan3d - mini - turbo - extension | Hunyuan3D 2 Mini Turbo | https://github.com/lightningpixel/modly - hunyuan3d - mini - turbo - extension |
| modly - hunyuan3d - mini - fast - extension | Hunyuan3D 2 Mini Fast | https://github.com/lightningpixel/modly - hunyuan3d - mini - fast - extension |
| modly - triposg - extension | TripoSG | https://github.com/lightningpixel/modly - triposg - extension |
| modly - trellis2 - gguf - extension | Trellis2 GGUF | https://github.com/lightningpixel/modly - trellis2 - gguf - extension |
安装扩展的方法
- 前往“Models”页面,点击“Install from GitHub”。
- 输入扩展仓库的HTTPS URL并确认。
- 如果扩展提供了模型节点,下载模型或其变体。处理扩展在安装和设置完成后即可使用。
工作流
先从基本的工作流开始。例如,在“Workflows”标签页,尝试:“Image -> Generate Mesh -> Add to Scene”。确保每个步骤之间都有连接。前往“Generate”标签页,确保已选择工作流,然后点击“Generate 3D Model”。点击“Settings/Logs/Errors”查看是否有问题。
Modly CLI
代理和脚本可以通过仅使用标准库的CLI调用正在运行的Modly桌面应用,而无需使用UI。CLI是基于Modly标准自动化概念的轻量级辅助工具,会在标准输出上保留最终的机器可读JSON:
- `python tools/modly - cli/agent.py health`
- `python tools/modly - cli/agent.py model list`
- `python tools/modly - cli/agent.py workflow - run status`
- `python tools/modly - cli/agent.py generate --image ./input.png --output ./export.glb`
标准命令包括 `health`、`model`、`workflow - run`、`capability` 和 `process - run`。友好的 `generate` 命令会启动 `POST /workflow - runs/from - image`,轮询返回的运行结果,在请求时导出最终的网格,并在JSON响应中包含恢复元数据,如工作流运行状态和工作流运行取消信息。
兼容性和辅助功能有意分开:旧版包装了旧的 `/generate/*` 作业端点,`dev serve - api` / `dev ensure - server` 仅启动FastAPI后端,不保证Electron/桌面桥接就绪,`experimental comfy - image` / `experimental generate - from - workflow` 是外部ComfyUI编排辅助工具,而非标准的Modly代理契约。隐藏的辅助别名(如 `status`、`export` 和 `batch`)仍可被脚本解析,但不会作为标准根命令显示。`experimental generate - from - workflow --workflow --output
社区
加入Discord服务器,及时了解最新消息、报告漏洞并分享反馈。
赞助商
感谢早期赞助商对Modly的信任,他们的支持让本地AI 3D生成变得更加便捷。赞助商包括DrHepa、benjapenjamin和iammojogo - sudo。
许可证
本项目采用MIT许可证,详情请参阅 `LICENSE` 文件。如果你分叉此项目并基于其构建自己的应用,必须注明原始项目及其创建者:“Based on Modly by Lightning Pixel”,这是MIT许可证归属条款的要求,请在应用的UI或文档中保留此声明。
179



被折叠的 条评论
为什么被折叠?



