Modly：本地开源的 AI 图像转 3D 网格桌面应用

工具定位

Modly 是一款本地运行的开源桌面应用，用开源 AI 模型完成图像转 3D 网格生成，不依赖云端推理。官方声明支持 Windows、Linux 和 Apple Silicon macOS；macOS 不支持 Intel 机型。下载安装包或克隆仓库后，可用 launch.bat（Windows）或 launch.sh（Linux/macOS）直接运行。

开发与运行

README 给出的开发流程是：先用 npm install 安装 JS 依赖；然后进入 api 目录创建 Python 虚拟环境，并按平台激活后安装 requirements.txt；再用 npm run dev 启动开发模式。测试命令包括 npm test、TypeScript 类型检查和 npm run build。

平台说明

• Linux 与 Windows 上的 AMD GPU 通过 ROCm 支持：应用会自动识别 Radeon 显卡，并引导使用 ROCm 版 PyTorch 轮子，无需自行安装 ROCm。
• 顶栏提供实时内存指示。
• 工作流在运行前会校验连线；无效图不会被执行，而是给出内联或提示消息。
• 导入的网格可在应用内平滑与减面，结果写回工作区。

扩展机制

扩展以 GitHub 仓库形式分发，需包含 manifest.json 与对应类型的运行时入口文件。官方列出的模型扩展有 Hunyuan3D 2 Mini、Mini Turbo、Mini Fast、TripoSG 和 Trellis2 GGUF。安装方式是在 Models 页面点击 “Install from GitHub” 并填入仓库 HTTPS 地址。

清单支持多种权重声明形式：model_sources 可声明多个 Hugging Face 仓库，按顺序下载并逐项校验；weight_groups 允许同一扩展内的多个节点共享权重；weight_variants 用于同一权重的多种量化或精度变体，各变体可单独安装或删除，并可选标注下载体积与显存需求。README 同时说明，新字段与旧的 hf_repo 等字段并存，旧节点行为不变。

场景与 CLI

模型扩展可将 scene 声明为节点输入或输出；场景是包含 scene-manifest.json 的工作区目录，而非任意 JSON 文件。当前 POST /generate/from-artifact 只接受 scene 这一种产物类型。

Modly CLI 仅依赖 Python 标准库，供脚本直接调用正在运行的桌面应用，规范命令为 health、model、workflow-run、capability 与 process-run；generate 是友好封装，会启动工作流轮询并在请求时导出网格。README 明确区分规范命令与兼容/实验性接口，后者不构成规范契约。

许可证为 MIT，README 要求基于该项目构建的应用保留对原作者与项目的署名。