An open API service indexing awesome lists of open source software.

https://github.com/lightningpixel/modly

Desktop app to generate 3D models from images using local AI — runs entirely on your GPU
https://github.com/lightningpixel/modly

3d ai-local ai-tools desktop-app modly open-source self-hosted

Last synced: about 2 months ago
JSON representation

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

Awesome Lists containing this project

README

          


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

> Created by [Lightning Pixel](https://github.com/lightningpixel)


Modly screenshot

---

## Download

Head to the [Releases](../../releases/latest) page to download the latest installer for Windows or Linux.

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

```bash
# Windows
launcher.bat

# Linux
./launcher.sh
```

---

## Getting started

### 1. Install JS dependencies

```bash
npm install
```

### 2. Set up Python backend

```bash
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

```bash
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](https://github.com/lightningpixel/modly-hunyuan3d-mini-extension) | Hunyuan3D 2 Mini | https://github.com/lightningpixel/modly-hunyuan3d-mini-extension |
| [modly-hunyuan3d-mini-turbo-extension](https://github.com/lightningpixel/modly-hunyuan3d-mini-turbo-extension) | Hunyuan3D 2 Mini Turbo | https://github.com/lightningpixel/modly-hunyuan3d-mini-turbo-extension |
| [modly-hunyuan3d-mini-fast-extension](https://github.com/lightningpixel/modly-hunyuan3d-mini-fast-extension) | Hunyuan3D 2 Mini Fast | https://github.com/lightningpixel/modly-hunyuan3d-mini-fast-extension |
| [modly-triposg-extension](https://github.com/lightningpixel/modly-triposg-extension) | TripoSG | https://github.com/lightningpixel/modly-triposg-extension |
| [modly-trellis2-extension](https://github.com/lightningpixel/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**.

![Install from GitHub](docs/install-from-github.png)

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

![Enter extension URL](docs/install-extension.png)

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

![Install models](docs/install-models.png)

---

### Community

Join the [Discord server](https://discord.gg/FjzjRgweVk) to stay up to date with the latest news, report bugs, and share feedback.

---

## License

MIT License — see [LICENSE](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](https://github.com/lightningpixel/modly) by [Lightning Pixel](https://github.com/lightningpixel)

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