3 步把照片变成能导出的本地 3D 模型:Modly 快速上手指南
【免费下载链接】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
你只有一张产品照,却想要能转着看的 3D 模型?Modly 把开源模型搬进你的电脑:图片转 3D 网格全程在自家 GPU 上本地推理,照片不上传。照本文走一遍,约 10 分钟装完并出第一个模型。
哪些电脑装 Modly 不费劲:平台与显卡要求
| 项目 | 说明 |
|---|---|
| 支持平台 | Windows、Linux、macOS(仅 Apple Silicon 版) |
| 显卡 | 建议带独立显存的 GPU:NVIDIA 或 Apple 芯片;显存越宽裕,能开的推理参数越高 |
| 磁盘 | 模型权重单个就有几个 GB,挑剩余空间 10 GB 以上、最好是 SSD 的盘 |
| 参考基准 | 官方在 32 GB 统一内存的 Jetson 上验证过 ~6 GB 级的 Hunyuan3D 2 Mini,见 docs/running-on-jetson.md |
| 适合人群 | 想让照片变 3D 资产、又在意数据不出门的 3D 爱好者与开发者 |
| 不太适合 | 只有集显的轻薄本,生成时容易爆显存 |
下载和安装一次办完:普通用户与开发者两条路
普通用户:3 步装好
- 到仓库 Releases 页下载对应平台的安装包(Windows 的 Setup、macOS 的 DMG、Linux 的 AppImage);
- 按向导选安装目录一路下一步,约 30 秒完成;
- 从桌面或开始菜单点开 Modly 图标。
开发者:源码直跑
git clone https://gitcode.com/GitHub_Trending/mo/modly # 把仓库拉下来 ./launch.sh # 自动检查 Node、装依赖、构建并启动;Windows 改跑 launch.bat脚本做的事不复杂:确认 Node.js 就位,缺 node_modules 就执行 npm install,没构建过就跑 npm run build,最后用 npm run preview 拉起应用(逻辑见launch.sh)。
跑通第一次:首启、装扩展、出第一个网格
第一次打开 Modly 会进初始化页,先要你挑一个数据文件夹。权重文件单个就好几个 GB,空间选大点;点 Continue 后,应用自动连做三件事:Preparing Python、Installing pip、Installing packages,进度条实时刷新(该页逻辑见src/areas/setup/FirstRunSetup.tsx)。这时你应该看到:后端启动提示消失,进入主界面——左侧工作流面板,右侧空的 3D 视图。
能生成之前还缺一样东西:扩展。每个生成模型都以扩展形式提供,官方清单在 README 的 Official extensions 一节,包括 Hunyuan3D 2 Mini(另有 Turbo、Fast 两个提速版)、TripoSG、Trellis2 GGUF。打开 Models 页点Install from GitHub,把扩展仓库的 HTTPS 地址粘进去确认;装完再点下载对应权重,几百 MB 到几个 GB,一次下载长期复用(入口在src/areas/models/ModelsPage.tsx)。这时你应该看到:卡片上出现下载进度条,跑完变成已安装状态。
最后走最短流水线:Image → Generate Mesh → Add to Scene三个节点。切到 Workflows 标签,确认节点之间的连线齐全;在 Image 节点点Browse…挑一张背景干净的照片(节点组件在src/areas/workflows/nodes/ImageNode.tsx)。再回 Generate 标签,确认工作流处于选中状态,点Generate 3D Model。GPU 推理跑完,网格就立进右侧 3D 视图,鼠标拖一拖能旋转,滚轮推近拉远。
这时你应该看到:照片里的主角躺在场景中央,左下角报出三角面数与顶点数。
干得漂亮,照片到可导出 3D 资产的最短闭环,到此跑通 🎉
卡住了先看这:5 种高频情况
| 现象 | 第一怀疑对象 | 解法 |
|---|---|---|
| 首启停在报错面板 | 杀毒软件拦了环境写入 | 给应用目录开杀毒白名单,再点面板上的Retry |
| launch.sh 提示 Node.js 缺失 | 系统没装 Node | 装好 Node.js 后重跑脚本 |
| 模型下载断在半途 | 网络波动 | 重进 Models 页触发继续,已下进度会接回 |
| 生成很慢或中途显存吃紧 | 推理参数偏高 | 调低 Inference Steps 与 octree 分辨率,或换 Mini 系列轻量扩展 |
| macOS 装完打不开 | 拿错了架构 | 确认是 Apple Silicon(arm64)安装包 |
跑通之后还能玩什么
- 换扩展对比手感:Turbo/Fast 版更省时间,Trellis2 GGUF 走量化路线,Models 页随时加装;
- 把网格带出去:Generate 工具栏的 Export 支持 glb、obj、stl、ply 四种格式;嫌面多可直接 Smooth 平滑、Decimate 减面,后端由 trimesh、pymeshlab 处理(依赖清单在
api/requirements.txt); - 不点鼠标也能生成:Modly CLI 一条命令完成图片到导出全流程,用法看
tools/modly-cli/SKILL.md。
一句话版:挑个大盘 → Models 页装扩展、下权重 → 三个节点连好线 → 点 Generate 3D Model,照片就变成本地的 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
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考