企业官网建设流程全解析

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/modly

Modly是一款本地运行的开源 AI 3D 生成桌面应用：传入一张图片，它就在你自己的 GPU 上跑开源模型（Hunyuan3D、TripoSG 等），输出 3D 网格（Mesh，由三角面构成的三维模型），不联网、不上传数据。按本文走完，约 10 分钟你就能装好 Modly 并生成第一个属于自己的 3D 模型。

项目速览

传统做法做一个 3D 资产要建模师花几小时到几天，Modly 把这件事压缩成「选一张照片 → 一键生成」，且全部在你本机完成。

三个核心能力：

• 图片转 3D 网格生成
• 完全本地 GPU 推理
• 可视化节点工作流

适合谁：独立开发者、需要快速 3D 素材的游戏/原型项目、在意数据隐私不想上云的团队。不适合谁：没有独立显卡、或者要求高精度交付级模型的人——生成结果更接近「可用初稿」，精细资产仍要后处理。

开工前：前置检查

两种获取方式：官方安装包——从 Releases 页选对应系统的包（Windows 为 Setup、macOS 为 DMG、Linux 为 AppImage），约 30 秒装完，适合普通用户；源码运行——克隆仓库跑一条启动脚本，适合开发者，首次含完整构建会多花几分钟。下文以源码方式为主线，安装包用户跳过「拿到可运行的程序」即可。

实操：从安装到首次成功

拿到可运行的程序

目标：把 Modly 窗口开出来。

1. 克隆仓库并进入目录：

git clone https://gitcode.com/GitHub_Trending/mo/modly cd modly

2. 运行启动脚本（Windows 用户用launch.bat）：

./launch.sh

脚本会依次检查 Node.js、安装 npm 依赖、构建缺失的out/产物，最后自动启动。首次构建大约几分钟。

💡 想改源码调试：在api/下建 Python venv 并装api/requirements.txt，然后npm run dev，细节见根目录README.md。

完成初始化

目标：让首启向导把本地环境配齐。

1. 首次启动会提示Choose a data folder：选一个剩余空间 10GB 以上、最好是 SSD 的目录。为什么：模型权重动辄数 GB，推理时要反复从盘里读权重，SSD 明显更快。
2. 点Continue，应用自动执行 Preparing Python → Installing pip → Installing packages 三步，进度条实时刷新。为什么不用你动手：向导自带 Python 运行时和全部依赖包，你不需要自己敲pip install。
3. 装完自动启动本地 AI 服务，进入主界面，初始化结束。

⚠️ 若卡在报错面板并提示 antivirus：把应用目录加入安全软件白名单，点Retry。想看具体日志，进Settings → Logs/Errors页。

跑通最小任务

目标：选一张图，拿到第一个 3D 模型。

1. 进Models页，点Install from GitHub：粘贴官方扩展仓库的 HTTPS 地址并确认。扩展是 Modly 的插件单位，每个扩展就是一个含manifest.json的仓库，官方提供 Hunyuan3D 2 Mini / Mini Turbo / Mini Fast、TripoSG、Trellis2 GGUF 五个。
2. 安装完成后在同页下载对应模型权重，一次性几百 MB 到数 GB。
3. 切到Workflows页：示例流程已连好 Image → 模型节点（如 TripoSG）→ Add to Scene；点 Image 节点的Browse...选一张背景干净的物体照片。
4. 切到Generate页，确认选中该工作流，点Generate 3D Model。
5. 等待 GPU 推理（数十秒到几分钟，取决于模型和显存），3D 网格出现在右侧场景：左键拖动旋转、滚轮缩放。

🎉 至此，「一张照片 → 本地 3D 模型」的最小闭环已经跑通。

卡住了？对照这张表

跑通之后去哪儿

回顾一下路径：装好程序 → 选数据目录 → 装扩展下权重 → 连工作流 → 点一次生成。接下来可以往三个方向走：自己写一个含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