企业官网建设流程全解析

Modly 本地 AI 3D 生成 5 分钟上手

【免费下载链接】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 是一款把图片变成 3D 模型的本地 AI 桌面应用：传一张照片，它就在你自己的 GPU 上跑开源模型（Hunyuan3D、TripoSG 等），直接输出可导出的 3D 网格，全程不联网、数据不上传。

下面给你一条最短路径：装应用 → 选目录 → 装模型 → 点生成。

🧊 跑通之后，你手里有什么

先看图：左边是你丢进去的照片，右边是同一个物体生成的 3D 网格，拖拽旋转、滚轮缩放都能直接操作。

出图之后马上能用的事：

• 一键导出.glb/.obj/.stl/.ply，其中.stl可直接进 3D 打印流程；
• 应用内直接平滑（Smooth）、减面（Decimate），优化结果写回工作区；
• 顶栏带实时内存指示，显存吃不吃得住一眼可见。

✅ 装之前先确认这 3 样东西

⚠️ Intel 版 macOS 目前不在支持范围。macOS 启动失败时，先确认装的是 arm64（Apple Silicon）版。

🚀 两条获取路径，按身份选

源码方式两条命令搞定（脚本会自动装依赖、构建并启动，逻辑见 launch.sh）：

git clone https://gitcode.com/GitHub_Trending/mo/modly ./launch.sh # Windows 用 launch.bat

💡 不确定选哪条：只想要模型，无脑选安装包。

🗂️ 首次启动：选个数据目录，等它装完环境

第一次打开会进入初始化流程（对应源码 src/areas/setup/FirstRunSetup.tsx）：

1. 选数据文件夹——界面上写着「Models can be several GB each」，挑个剩余空间充足的目录；
2. 应用自动依次执行「Preparing Python → Installing pip → Installing packages」，进度条实时刷新，不用你手动配 Python 环境；
3. 环境就绪后本地 FastAPI 后端自动启动，直接进入主界面。

⚠️ 卡在报错面板？最高频的是杀毒拦截：把应用目录加进白名单，点 Retry 即可。其他问题进Settings → Logs/Errors查日志。

卡住了？

🧩 装第一个生成模型：每个模型都是一个「扩展」

Modly 里每个 3D 生成模型都是一个可安装的扩展，官方提供 Hunyuan3D 2 Mini / Mini Turbo / Mini Fast、TripoSG、Trellis2 GGUF 几套。

装法固定三步：

1. 进Models页，点Install from GitHub；
2. 粘贴扩展仓库的 HTTPS 地址，确认；
3. 扩展装完后，下载对应模型权重（数百 MB 到数 GB，一次性下载）。

💡 权重下载中断不慌：重新进 Models 页继续即可，已下部分不会丢。

⚡ 生成第一个 3D 模型：Image → Generate Mesh → Add to Scene

官方推荐的最小工作流就三个节点，连好线就能跑：

操作顺序：

1. Workflows页确认 Image、模型节点、Add to Scene 三者之间已连线（运行前应用会校验连线，没连好会直接给提示）；
2. 在 Image 节点点Browse...，选一张背景干净的物体照；
3. 切到Generate页，确认已选中该工作流，点Generate 3D Model；
4. 等 GPU 推理完成，网格出现在右侧 3D 场景，拖拽旋转、滚轮缩放；
5. 有报错随时查Settings/Logs/Errors。

生成参数都集中在模型节点上：Inference Steps、CFG Scale、Seed 等。机器吃紧就先降 Inference Steps，或换更轻量的 Mini 系列。

卡住了？

🔌 出图之后：导出、优化和脚本化

跑通最小工作流后，还有几条进阶路线：

• 网格后处理：顶栏 Import / Smooth / Decimate，导入的网格能在应用内平滑、减面，结果写回工作区；
• 命令行驱动：tools/modly-cli/agent.py可以不走界面直接生成并导出，例如python tools/modly-cli/agent.py generate --image ./input.png --output ./export.glb；
• 无头部署：Jetson 这类无桌面环境可以只跑 FastAPI 后端加 curl 驱动，完整步骤见 docs/running-on-jetson.md。

安装包（或源码）→ 选数据目录 → 装扩展与权重 → 连好工作流 → 点 Generate 出模型

【免费下载链接】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