Modly 完整上手指南：本地 3D 生成从照片到网格
【免费下载链接】modlyDesktop app to generate 3D models from images or prompt using local AI — runs entirely on your GPU项目地址: https://gitcode.com/GitHub_Trending/mo/modly
输入一张照片，Modly 在本地 GPU 上把它推理成可旋转的 3D 网格。全程不上传照片、不依赖云端，支持 Windows、Linux 与 Apple Silicon macOS。照下面的三个大动作走，你就能在自己的机器上生成第一个 3D 模型。
它适合谁
- 照片不想交给云端服务，要在自己设备上处理的人
- 手上有 NVIDIA 独立显卡或 Apple Silicon，想把推理留在本地的用户
- 生成之后还要减面、平滑、导出 GLB 等格式的开发者
- 想批量跑 3D 生成、用脚本驱动的自动化玩家
最短路径：三个大动作跑通
1. 获取应用
- 普通用户：在 Releases 页面下载对应系统的安装包，Windows 是 Setup 程序、macOS 是 DMG、Linux 是 AppImage
- 开发者：克隆仓库直接运行，无需安装
git clone https://gitcode.com/GitHub_Trending/mo/modly ./launch.sh # Linux / macOS；Windows 运行 launch.bat- 启动脚本会自动检查 Node.js、装依赖、构建并拉起应用
- 注意：macOS 版本仅支持 Apple Silicon（M 系列芯片），下载时确认 arm64
2. 首次启动
- 按提示选一个数据目录，模型权重有好几个 GB，建议放剩余空间充足的 SSD
- 应用自动执行 Preparing Python → Installing pip → Installing packages，进度条实时显示
- 环境就绪后自动启动本地 AI 服务，随后进入主界面
- 卡在报错面板时，点 Retry 或进 Settings 的 Logs/Errors 页看日志
3. 装模型扩展，跑通最小工作流
- 进 Models 页，点Install from GitHub，粘贴扩展仓库的 HTTPS 地址并确认
- 官方模型可选 Hunyuan3D 2 Mini / Mini Turbo / Mini Fast、TripoSG、Trellis2 GGUF
- 装完扩展后下载对应模型权重（数百 MB 到数 GB，一次性）
- Workflows 页已备好 Image → Generate Mesh → Add to Scene 的最小工作流，在 Image 节点点 Browse… 选一张背景干净的物体照片
- 切到 Generate 页确认选中该工作流，点Generate 3D Model，网格出来后拖拽旋转、滚轮缩放
核心功能详解
扩展机制：模型像插件一样装
作用：把生成模型和处理算法都做成可安装扩展，每个扩展就是一个带manifest.json和运行时入口文件的仓库。
怎么用：Models 页从 GitHub 或本地安装。装完模型类扩展要再下载对应权重；处理类扩展装完即可用。
源码位置：src/areas/models/，扩展安装逻辑在 electron/main/extension-install-utils.ts。
节点工作流：连线即流水线
作用：拖节点、拉连线，编排「图片 → 生成 → 加入场景」的流水线。
怎么用：Workflows 页编辑，运行前会自动校验连线；不合法的图原样保留，用行内提示和 toast 警告。内置节点还有 ForEach、While、Wait、网格导入等。
源码位置：src/areas/workflows/nodes/。
网格后处理与导出：生成的不是终点
作用：FastAPI 后端负责网格优化与导出，导入的网格可平滑、减面，结果写回工作区。
怎么用：生成或导入网格后在应用内直接操作，导出支持 GLB、OBJ、STL、PLY 四种格式。
源码位置：后端在 api/，依赖 trimesh 与 pymeshlab，见 api/requirements.txt。
避坑速查
| 现象 | 处理 |
|---|---|
| 启动报 antivirus 拦截 | 应用目录加白名单后点 Retry |
| macOS 装不上或启动失败 | 确认下载的是 arm64 版本 |
| 生成慢、显存不足 | 降低步数与分辨率，或换 Mini 系列 |
| 模型权重下载中断 | 重进 Models 页续传，已下部分保留 |
| 生成中途报错 | 看 Settings/Logs/Errors 定位 |
接着往下走
跑通后，去生成参数里调推理步数与分辨率，或在 Models 页换更重的官方模型。需要脚本化时，tools/modly-cli/ 提供了generate等命令；无桌面环境的部署见 docs/running-on-jetson.md。照片全程不出机器，生成速度只取决于你的显卡。
【免费下载链接】modlyDesktop app to generate 3D models from images or prompt using local AI — runs entirely on your GPU项目地址: https://gitcode.com/GitHub_Trending/mo/modly
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
