Modly 是本地开源桌面应用(Windows/Linux),把照片转成 3D 网格模型,推理完全在本机 GPU 上运行,无需云服务或 API Key,采用 Electron + TypeScript 前端与本地 Python FastAPI 后端,支持 GitHub 扩展。
主要能力:图像到 3D 网格生成;模型变体下载与选择;通过 GitHub 安装扩展;本地运行、不需环境变量或密钥,PyTorch 自动检测 CUDA。官方扩展为 Hunyuan3D 2 Mini。
使用方式:快速启动可运行 launcher.bat(Windows)或 chmod +x launcher.sh && ./launcher.sh(Linux);开发模式依次 git clone https://github.com/lightningpixel/modly、cd modly、npm install、cd api、python -m venv .venv、激活虚拟环境、pip install -r requirements.txt,再回到根目录 npm run dev。常用脚本:npm run dev、npm run build、npm run lint、npm run typecheck。安装扩展:打开 Models 页,点击 Install from GitHub,粘贴 HTTPS URL,下载模型变体后选择模型并上传图片生成。
扩展开发:扩展仓库需包含根目录 manifest.json 与 generator.py,generator.py 实现 generate(image_path, output_path, variant_id, models_dir, **kwargs),返回含 success、output_file 或 error 的字典;可通过 print(json.dumps({"progress":..., "message":...}), flush=True) 上报进度。
适用场景:本地图像转 3D 建模、开发者构建与分发自定义生成扩展。
限制:仅有 Windows/Linux 版本;模型体积较大(4–10 GB)需足够磁盘空间;显存不足时需用更小变体;后端端口与扩展目录等具体常量位置以源码为准,资料未给出明确值;许可证为 MIT,需署名 Modly 与 Lightning Pixel。