lightningpixel/modly

Public

Desktop app to generate 3D models from images or prompt using local AI — runs entirely on your GPU

  • Stars8.5k+180 tuần này
  • Forks780
  • Watchers57
  • Issues85
  • Ngày tạo18/03/2026
  • Cập nhật gần nhất28/10/2026
  • Ngôn ngữTypeScript
  • Giấy phép—
README.md31.1 KBRaw

Modly logo

Modly

Local, open source, AI-powered image-to-3D mesh generation. Turn any photo into a 3D model using open source AI models running entirely on your GPU. Modly is a desktop application for Windows, Linux, and Apple Silicon macOS.

Created by Lightning Pixel

Modly screenshot


Download

Head to the Releases page to download the latest installer for Windows, Linux, or Apple Silicon macOS.

Alternatively, you can clone the repository and run the app directly without installing:

# Windows
launch.bat

# Linux / macOS
./launch.sh

Getting started

1. Install JS dependencies

npm install

2. Set up Python backend

cd api
python -m venv .venv
.venv\Scripts\activate     # Windows
source .venv/bin/activate  # Linux / macOS
pip install -r requirements.txt

3. Run in development

npm run dev

4. Test

npm test
./node_modules/.bin/tsc --noEmit -p tsconfig.node.json
npm run build

Platform notes

  • AMD GPUs are supported through ROCm on Linux and Windows: a Radeon card is detected automatically and extensions are steered to ROCm PyTorch wheels, with no ROCm install required. See docs/running-on-amd-rocm.md.
  • macOS support targets Apple Silicon only.
  • macOS uses native window controls. Windows and Linux keep the existing custom controls.
  • The top bar includes a live RAM indicator sourced from the main process.
  • Workflow wiring is validated before run; invalid graphs stay in place and surface inline/toast warnings instead of dropping the current mesh view.
  • Package Apple Silicon macOS with npm run package:mac.
  • Imported meshes can be smoothed and decimated in-app; optimized results are written back into the workspace.

Extension system

Modly supports external model and process extensions. Each extension is a GitHub repository containing a manifest.json plus the runtime entry files required by its type.

Official extensions

Extension Model URL
modly-hunyuan3d-mini-extension Hunyuan3D 2 Mini https://github.com/lightningpixel/modly-hunyuan3d-mini-extension
modly-hunyuan3d-mini-turbo-extension Hunyuan3D 2 Mini Turbo

Nội dung README thuộc về lightningpixel và cộng đồng đóng góp, giấy phép Không có giấy phép. Nguồn: github.com/lightningpixel/modly