# modly
**Repository Path**: nirenyang/modly
## Basic Information
- **Project Name**: modly
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-15
- **Last Updated**: 2026-05-15
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# 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)
---
## 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-gguf-extension](https://github.com/lightningpixel/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](https://discord.gg/BvjDCvS3yr) to stay up to date with the latest news, report bugs, and share feedback.
Follow Modly and its development on X:
- [Modly on X](https://x.com/modly3d)
- [Lightning Pixel on X](https://x.com/lightningpiixel)
---
## 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.
## Star History
