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

---

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-hunyuan3d-mini-turbo-extension	Hunyuan3D 2 Mini Turbo	https://github.com/lightningpixel/modly-hunyuan3d-mini-turbo-extension
modly-hunyuan3d-mini-fast-extension	Hunyuan3D 2 Mini Fast	https://github.com/lightningpixel/modly-hunyuan3d-mini-fast-extension
modly-triposg-extension	TripoSG	https://github.com/lightningpixel/modly-triposg-extension
modly-trellis2-gguf-extension	Trellis2 GGUF	https://github.com/lightningpixel/modly-trellis2-gguf-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.

---

Automation and companion tooling

In this fork/branch, Modly is also being exercised as a headless automation target for external tooling.

The current direction is to support a practical automation flow around:

• capabilities discovery
• workflow runs from image input
• process runs for mesh-only operations such as export and optimization
• external CLI / MCP orchestration layered on top of Modly

That companion tooling lives here:

• DrHepa/modly_CLI_MCP

The goal of that repository is to provide an installable CLI and MCP server that can drive real Modly capabilities without duplicating product logic inside the tooling layer.

At this stage, that companion project already supports:

• capability discovery against Modly
• workflow-run create / status / wait / cancel
• process-run create / status / wait / cancel

while keeping UI-only surfaces such as Add to Scene outside the automation contract.

---

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.

Star History