<p align="center"> <img src="resources/icons/icon.png" width="96" alt="Modly logo" /> </p>

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 and Linux (macOS coming soon)

Created by Lightning Pixel

<p align="center"> <img src="docs/app-screenshot.png" alt="Modly screenshot" /> </p>

---

Download

Head to the Releases page to download the latest installer for Windows or Linux.

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

# Windows
launcher.bat

# Linux
./launcher.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

---

Extension system

Modly supports external AI model extensions. Each extension is a GitHub repository containing a manifest.json and a generator.py.

Official extensions

| Extension | Model | URL | |-----------|-------|-----| | modly-hunyuan3d-mini-extension | Hunyuan3D 2 Mini | https://github.com/lightningpixel/modly-hunyuan3d-mini-extension | | modly-triposg-extension | TripoSG | https://github.com/lightningpixel/modly-triposg-extension | | modly-trellis2-extension | TRELLIS.2 | https://github.com/lightningpixel/modly-trellis2-extension |

How to install an extension

1. Go to the Models page and click Install from GitHub.

2. Enter the HTTPS URL of the extension repository and confirm.

3. Once the extension is installed, download the model or one of its variants.

---

Community

Join the Discord server to stay up to date with the latest news, report bugs, and share feedback.

---

License

MIT License — see LICENSE for details.

If you fork this project and build your own app from it, you must credit the original project and its creator:

Based on Modly by Lightning Pixel

This is a requirement of the MIT license attribution clause. Please keep this credit visible in your app's UI or documentation.