Modly：把一张照片变成立体模型的本地AI工具，3步看到第一个3D结果-二趣网

Modly：把一张照片变成立体模型的本地AI工具，3步看到第一个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 上，照片变 3D 网格（Mesh）全程不联网、不传数据。跟着下面的步骤操作，10 分钟内你会在 3D 场景里看到第一个自己生成的模型。

一张表看懂：Modly 适合干什么

本地 AI 3D 生成工具很多，Modly 的特点是「装好的桌面应用 + 可扩展」，不需要自己搭环境。

能力	使用场景	适合谁
图片转 3D 网格	一张物体照片生成可旋转、可导出的 3D 模型	想快速把图片变 3D 资产的设计师、3D 爱好者
全程本地推理	所有模型在你 GPU 上跑，数据不出机器	在意隐私、无外网环境的用户
扩展机制	像装插件一样安装 Hunyuan3D 2 Mini、TripoSG 等新模型	想按需换模型的用户
节点工作流	Image → 生成 → Add to Scene 可视化连线编排	想批量处理多张图片的人
网格后处理	导入的 mesh 可在应用内平滑、减面、导出	需要直接产出可用资产的人

最短路径：3 个动作出结果

最短体验路径只有 3 段，按顺序做完即可。

1. 跑起来。在 Releases 页面下载对应系统的安装包（Windows 为 Setup、macOS 为 DMG、Linux 为 AppImage）安装；或直接运行源码版：

git clone https://gitcode.com/GitHub_Trending/mo/modly ./launch.sh

脚本会自动检查 Node.js、安装依赖并构建启动，源码逻辑见 launch.sh。

⚠️ macOS 仅支持 Apple Silicon（M 系列芯片）版本；两个平台建议有一块带独立显存的 NVIDIA 或 Apple GPU。

2. 装一个模型。进入Models页，点击Install from GitHub，粘贴扩展仓库的 HTTPS 地址并确认。安装完成后在扩展卡片里选择权重变体，点击Install下载权重（一次性下载，数百 MB 到数 GB）。

3. 连好节点，点生成。打开Workflows标签页，确认 Image → 模型节点 →Add to Scene三个节点已连线；在 Image 节点点击Browse…选一张背景干净的物体图，切到Generate标签页，选中该工作流后点击Generate 3D Model，等 GPU 推理结束，网格出现在右侧 3D 场景中，可拖动旋转、滚轮缩放。✅

完整流程分三阶段

阶段A 环境就位：一键启动步骤与首次初始化

源码版零手工配置，launch.sh会依次完成依赖安装、构建和启动。真正需要你操作的只有首次初始化：

选择数据文件夹：界面提示模型文件可达数 GB，选剩余空间充足的目录，SSD 更佳；
等待自动安装三步：Preparing Python → Installing pip → Installing packages，进度条实时刷新（对应 src/areas/setup/FirstRunSetup.tsx）；
环境就绪后自动启动本地 AI 后端，进入主界面。

⚠️ 若停在报错面板并出现 antivirus 提示，说明杀毒软件拦截了自动安装：把应用文件夹加入白名单，再点Retry。

阶段B 模型与扩展：GitHub 扩展安装三步法

Modly 里每个生成模型都是一个可安装的扩展，官方扩展包括 Hunyuan3D 2 Mini / Mini Turbo / Mini Fast、TripoSG、Trellis2 GGUF（完整清单见 README）。

进入Models页，点击Install from GitHub；
粘贴扩展仓库的 HTTPS 地址，确认安装；
在扩展卡片里选择权重变体，点击Install开始下载。

💡 新手建议先装 0.6B 参数的 Hunyuan3D 2 Mini 系列，显存占用低、出图快。

阶段C 产出第一个结果：连线检查与生成参数

官方推荐的最小工作流是 Image → Generate Mesh → Add to Scene，跑之前做两个检查：

连线检查：每个节点之间必须有连接，Workflows 页会在运行前校验，断线会以警告提示而不是直接丢弃模型视图；
参数检查：模型节点上的 Inference Steps、CFG Scale 等参数保持默认即可，显存紧张时把 Inference Steps 调低。

确认无误后，在Generate标签页点击Generate 3D Model。生成结果落在右侧 3D 场景，顶栏的Import、Library、Smooth、Decimate按钮可继续做后处理。任何报错都能通过Settings/Logs/Errors页面定位。

卡壳急救：对照这张表

现象	常见原因	处理方式
首次启动报错面板提示 antivirus	杀毒软件拦截了环境自动安装	应用目录加入信任白名单，点Retry
生成很慢或显存不足崩溃	模型偏重、推理步数过高	调低 Inference Steps，或换 0.6B 的 Hunyuan3D 2 Mini
权重下载中断	网络波动	重新进入 Models 页继续下载，已下部分不会丢
macOS 装完打不开	下载了非 arm64 构建	确认安装包是 Apple Silicon（arm64）版本
界面无报错但一直不出结果	后端服务异常或工作流连线有误	打开 Settings/Logs/Errors 查看日志

下一步去哪

想继续深入：节点与工作流的行为实现见 src/areas/workflows/，Linux / Jetson 无桌面环境的运行方式见 docs/running-on-jetson.md。如果你要用脚本或 Agent 驱动 Modly，tools/modly-cli/ 提供了纯标准库的 CLI，一条命令即可从图片生成并导出 mesh：python tools/modly-cli/agent.py generate --image ./input.png --output ./export.glb。

【免费下载链接】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），仅供参考

企业官网建设流程全解析