Modly 新手教程在本地 GPU 上把一张照片变成 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/modlyModly 是一款开源桌面应用用本地 AI 模型把图片生成 3D 网格Mesh全部推理在你的 GPU 上完成无需联网、不上传数据。本文带你完成安装、初始化并跑出第一个可导出的 3D 模型。项目名片完全离线基于 Hunyuan3D 2 Mini、TripoSG 等开源模型图片不离开你的机器桌面体验支持 Windows、Linux 和 Apple Silicon 版 macOS顶部栏内置实时内存指示器扩展机制模型与网格处理节点都以「扩展」形式安装每个扩展是一个含manifest.json的仓库节点工作流用连线编排「图片 → 生成 → 加入场景」的流水线跑之前还会做连线校验。一句话定位Modly 是跑在本地 GPU 上的图生 3D 桌面工作台适合做原型、素材和 3D 资产探索。动手前的准备硬件方面你需要一块有独立显存的 NVIDIA 显卡或 Apple Silicon 的 GPU。⚠️ macOS 目前仅支持 Apple Siliconarm64Intel 版 Mac 没有对应构建。模型权重通常有几个 GB官方 Jetson 文档提到 Hunyuan3D-2 Mini 约需 6 GB 显存级别建议数据目录放在 SSD 上。两种获取方式对比方式做法适合谁官方安装包从 Releases 下载 Windows / Linux / macOS 安装包一路下一步普通用户推荐源码运行git clone https://gitcode.com/GitHub_Trending/mo/modly后运行launch.batWindows或./launch.shLinux / macOS想读源码或参与开发的人源码方式需要本地装好 Node.js脚本会自动执行npm install、构建并启动逻辑见 launch.sh安装包则连 Python 运行环境都替你带齐了。普通用户选安装包即可。把项目跑起来初始化选一个数据目录首次启动会进入初始化界面对应 src/areas/setup/FirstRunSetup.tsx。界面会提示「Models can be several GB each」用 Browse 选一个剩余空间充足的目录后点 Continue。等环境自动就绪应用会依次执行 Preparing Python → Installing pip → Installing packages 三步进度条实时显示。看到主界面左侧侧边栏出现 Workflows、Models 等入口即代表环境就绪本地后端已随之启动。安装一个模型扩展生成模型以扩展形式提供内置入口在Models页源码 src/areas/models/ModelsPage.tsx点击Install from GitHub粘贴扩展仓库的 HTTPS 地址并确认扩展就绪后下载对应模型权重数百 MB 到数 GB一次性下载。官方扩展包括 Hunyuan3D 2 Mini / Mini Turbo / Mini Fast、TripoSG、Trellis2 GGUF 五个。看到 Models 页中该模型显示为已安装/已下载这一步就算完成。第一次真实使用最小完整路径就是一条官方推荐工作流Image → 生成网格 → 加入场景。打开Workflows页确认 Image、模型、Add to Scene 三个节点之间连线完整在 Image 节点点Browse...选一张背景干净的单物体照片模型节点可调整 Inference Steps默认 50、CFG Scale默认 7、Seed默认 42等推理参数默认值先不动切到Generate页确认选中该工作流点击Generate 3D Model。成功标志3D 视口出现网格左下角显示分辨率与顶点数拖动可旋转、滚轮可缩放。点顶部工具栏的Export还能导出网格文件第一次拿到.glb就代表整条链路跑通了。进阶小贴士出图质量不够时优先调大 Inference Steps代价是更慢而不是堆分辨率显存紧张就换 Mini Turbo / Mini Fast 这类更轻量的扩展。除了生成工作流里还能挂网格处理节点官方内置了 smoothing、decimation 等优化能力无桌面环境如 NVIDIA Jetson跑后端的详细方法见 docs/running-on-jetson.md。容易踩的坑与应对启动被杀毒软件拦截把应用目录加入信任白名单然后点 Retry。生成慢或显存不足降低 Inference Steps 和分辨率或换 Mini Turbo / Mini Fast 模型。模型下载中断重新进入 Models 页继续下载即可已下部分不会丢失。macOS 打不开确认下载的是 arm64 版本Intel Mac 目前不支持。任何生成报错进Settings → Logs/Errors查具体日志别只看弹窗。【免费下载链接】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），仅供参考