https://github.com/merserk/sd-webui-forge-universal-portable
Install and run SD Classic and Neo Portable.
https://github.com/merserk/sd-webui-forge-universal-portable
stable-diffusion stable-diffusion-webui stable-diffusion-webui-forge
Last synced: 4 months ago
JSON representation
Install and run SD Classic and Neo Portable.
- Host: GitHub
- URL: https://github.com/merserk/sd-webui-forge-universal-portable
- Owner: Merserk
- License: mit
- Created: 2025-11-28T09:26:27.000Z (7 months ago)
- Default Branch: classic
- Last Pushed: 2025-12-16T20:47:47.000Z (6 months ago)
- Last Synced: 2026-01-29T22:58:49.658Z (5 months ago)
- Topics: stable-diffusion, stable-diffusion-webui, stable-diffusion-webui-forge
- Language: Batchfile
- Homepage:
- Size: 42.4 MB
- Stars: 9
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ⚡ SD WebUI Forge - Universal Portable Installer
[](https://www.microsoft.com/windows)
[](https://www.python.org/)
[](https://github.com/astral-sh/uv)
[](https://git-scm.com/)
A lightning-fast, zero-dependency, **fully portable** installer for [SD WebUI Forge](https://github.com/Haoming02/sd-webui-forge-classic).
This script allows you to choose between the **Classic** (Stable) and **Neo** (Experimental) branches. It sets up a self-contained environment using **UV**, making installation and updates significantly faster than standard methods.
## ✨ Features
* **🌍 Universal:** Choose to install **Forge Classic** or **Forge Neo** from a simple menu.
* **⚡ Ultra-Fast:** Uses [uv](https://github.com/astral-sh/uv) for package management, drastically reducing install times.
* **📦 Fully Portable:** Includes Embedded Python 3.13 and MinGit. No global installation required.
* **🔧 Auto-Fixes:** Automatically installs pre-compiled `insightface` wheels for Classic (fixing common installation errors).
* **🧹 Smart Cleanup:** Automatically removes temporary setup files after installation to keep your folder clean.
## 🛠️ Installation Guide
1. **Download** the `install_forge_universal.bat` file.
2. **Place it** in a folder where you want the installation to live (e.g., `C:\AI\`).
* *Tip: Avoid placing it in deeply nested folders to prevent path length limits.*
3. **Double-click** the script.
4. **Select your Edition:**
* Press **[1]** for **Neo** (Newest features, experimental).
* Press **[2]** for **Classic** (Stable, traditional).
5. Wait for the installer to finish.
> **Note:** You can run the installer again to install the *other* version side-by-side in the same folder!
## 🎮 How to Use
Depending on which version you selected, you will see specific launch files:
### For Forge Neo:
* **`run_neo.bat`**: Starts the WebUI.
* **`update_neo.bat`**: Updates the repository and packages.
### For Forge Classic:
* **`run_classic.bat`**: Starts the WebUI.
* **`update_classic.bat`**: Updates the repository and packages.
## 📂 Directory Structure
Your folder will look like this (example showing both installed):
```text
MyFolder/
├── sd-webui-forge-neo/ # Neo Edition Folder
├── sd-webui-forge-classic/ # Classic Edition Folder
│
├── install_forge_universal.bat
│
├── run_neo.bat # Launcher for Neo
├── update_neo.bat # Updater for Neo
│
├── run_classic.bat # Launcher for Classic
└── update_classic.bat # Updater for Classic
```
## 🤝 Credits
* **SD WebUI Forge:** Maintained by [Haoming02](https://github.com/Haoming02/sd-webui-forge-classic).
* **UV:** High-performance Python package installer by [Astral](https://github.com/astral-sh/uv).
* **InsightFace Wheels:** Provided by [Gourieff](https://github.com/Gourieff/Assets).
* **Original Projects:** Based on SD WebUI by Automatic1111 and Forge by lllyasviel.
---
*If you find this useful, give the repository a star! ⭐*