10分钟上手 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/modlyModly是一款本地运行的开源 AI 3D 生成桌面应用传入一张图片它就在你自己的 GPU 上跑开源模型Hunyuan3D、TripoSG 等输出 3D 网格Mesh由三角面构成的三维模型不联网、不上传数据。按本文走完约 10 分钟你就能装好 Modly 并生成第一个属于自己的 3D 模型。项目速览传统做法做一个 3D 资产要建模师花几小时到几天Modly 把这件事压缩成「选一张照片 → 一键生成」且全部在你本机完成。三个核心能力图片转 3D 网格生成完全本地 GPU 推理可视化节点工作流适合谁独立开发者、需要快速 3D 素材的游戏/原型项目、在意数据隐私不想上云的团队。不适合谁没有独立显卡、或者要求高精度交付级模型的人——生成结果更接近「可用初稿」精细资产仍要后处理。开工前前置检查检查项要求说明系统Windows / Linux / Apple Silicon macOSmacOS 仅支持 M 系列arm64构建Intel 版无法运行GPU带独立显存的 NVIDIA 显卡或 Apple M 系列芯片推理全在本地 GPUHunyuan3D 2 Mini 属约 6GB 量级磁盘至少 10GB 可用空间SSD 优先模型权重从几百 MB 到数 GB首次要下载软件仅源码模式需要 Node.jslaunch.sh会自动检查Python 由首启向导代劳两种获取方式官方安装包——从 Releases 页选对应系统的包Windows 为 Setup、macOS 为 DMG、Linux 为 AppImage约 30 秒装完适合普通用户源码运行——克隆仓库跑一条启动脚本适合开发者首次含完整构建会多花几分钟。下文以源码方式为主线安装包用户跳过「拿到可运行的程序」即可。实操从安装到首次成功拿到可运行的程序目标把 Modly 窗口开出来。克隆仓库并进入目录git clone https://gitcode.com/GitHub_Trending/mo/modly cd modly运行启动脚本Windows 用户用launch.bat./launch.sh脚本会依次检查 Node.js、安装 npm 依赖、构建缺失的out/产物最后自动启动。首次构建大约几分钟。 想改源码调试在api/下建 Python venv 并装api/requirements.txt然后npm run dev细节见根目录README.md。完成初始化目标让首启向导把本地环境配齐。首次启动会提示Choose a data folder选一个剩余空间 10GB 以上、最好是 SSD 的目录。为什么模型权重动辄数 GB推理时要反复从盘里读权重SSD 明显更快。点Continue应用自动执行 Preparing Python → Installing pip → Installing packages 三步进度条实时刷新。为什么不用你动手向导自带 Python 运行时和全部依赖包你不需要自己敲pip install。装完自动启动本地 AI 服务进入主界面初始化结束。⚠️ 若卡在报错面板并提示 antivirus把应用目录加入安全软件白名单点Retry。想看具体日志进Settings → Logs/Errors页。跑通最小任务目标选一张图拿到第一个 3D 模型。进Models页点Install from GitHub粘贴官方扩展仓库的 HTTPS 地址并确认。扩展是 Modly 的插件单位每个扩展就是一个含manifest.json的仓库官方提供 Hunyuan3D 2 Mini / Mini Turbo / Mini Fast、TripoSG、Trellis2 GGUF 五个。安装完成后在同页下载对应模型权重一次性几百 MB 到数 GB。切到Workflows页示例流程已连好 Image → 模型节点如 TripoSG→ Add to Scene点 Image 节点的Browse...选一张背景干净的物体照片。切到Generate页确认选中该工作流点Generate 3D Model。等待 GPU 推理数十秒到几分钟取决于模型和显存3D 网格出现在右侧场景左键拖动旋转、滚轮缩放。 至此「一张照片 → 本地 3D 模型」的最小闭环已经跑通。卡住了对照这张表现象可能原因处理办法launch.sh报 Node.js not installedNode 缺失或不在 PATH装好 Node.js 后重跑脚本启动被杀毒拦截安全软件误报应用目录加白名单点Retry首启安装一直卡住网络慢或磁盘瓶颈换网络、把数据目录挪到空间充足的 SSD生成极慢或显存不足崩溃模型超出显存调低 Inference Steps、Max Faces或换更轻的 Mini 变体模型下载中断网络抖动重新进 Models 页继续已下载部分保留macOS 打不开装了 Intel 版确认下载的是 Apple Siliconarm64包跑通之后去哪儿回顾一下路径装好程序 → 选数据目录 → 装扩展下权重 → 连工作流 → 点一次生成。接下来可以往三个方向走自己写一个含manifest.json的仓库就能成为模型/流程扩展节点实现参考 src/areas/workflows/nodes/后端本身是独立 FastAPI 服务api/main.py可用 tools/modly-cli/ 的 CLI 脚本化调用Jetson 无头部署看 docs/running-on-jetson.md遇到问题或有想法去官方 Discord 社区报 bug、聊需求。【免费下载链接】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），仅供参考