⚡ SD WebUI Forge - Universal Portable Installer

A lightning-fast, zero-dependency, fully portable installer for SD WebUI Forge.

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 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. the install_forge_universal.bat file.
2. Place it in a folder where you want the installation to live (e.g., C:\AI\SD Forge Neo and Classic\).
   • 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):

SD Forge Neo and Classic/
├── sd-webui-forge-neo/          # Neo Edition Folder
├── sd-webui-forge-classic/      # Classic Edition Folder
│
├── install_forge_universal.bat  # Installer for Neo and Classic
│
├── run_neo.bat                  # Launcher for Neo
├── update_neo.bat               # Updater for Neo
│
├── run_classic.bat              # Launcher for Classic
└── update_classic.bat           # Updater for Classic

📖 Project Lineage & History

Understanding the different versions of the WebUI can be confusing. Here is how this project came to be:

• 🟢 [Automatic1111] Stable Diffusion WebUI
  The original, foundational Gradio-based interface for Stable Diffusion that started it all.
  • 🟡 ↳ [lllyasviel] SD WebUI Forge
    A major fork of A1111 optimized for better resource management, significantly faster inference, and lower VRAM usage.
    • 🔵 ↳ [Haoming02] Forge Classic & Neo
      When the original Forge slowed in updates, it was forked by Haoming02 to keep the project alive, splitting into two distinct branches:
      • 🟦 Forge Classic: Ensure maximum compatibility with older, legacy extensions.
      • 🟧 Forge Neo: Modernized UI, newer features, and better performance.

This repository provides a universal, portable installer to easily run either the Classic or Neo branch.

🤝 Credits

• SD WebUI Forge: Maintained by Haoming02.
• UV: High-performance Python package installer by Astral.
• InsightFace Wheels: Provided by Gourieff.
• Original Projects: Based on SD WebUI by Automatic1111 and Forge by lllyasviel.
• Python: The core programming language environment by Python Software Foundation.
• MinGit: Minimal, portable version of Git for Windows by the Git for Windows Team.

---

If you find this useful, give the repository a star! ⭐