Install Portable Kohya_ss GUI (Windows)

A simplified way to install and run Kohya_ss on Windows using a portable version that requires minimal setup and configuration.

Download

Installation

1. Download the archive: Get the portable Kohya_ss GUI from the download link above.
2. Extract the files: Unpack the downloaded ZIP archive to any location on your computer (e.g., C:\Kohya_ss-Portable\).
3. Initial setup: Navigate to the extracted folder and run firstrun.cmd. This will set up the environment and install necessary dependencies.

Usage

To launch the Kohya_ss GUI:

1. Navigate to the extracted folder.
2. Run gui-uv.bat to start the application.
3. The Kohya_ss interface will open in your web browser, ready for use.

Advantages of the Portable Version

• No complex setup: Unlike the WSL installation, this version works directly on Windows without requiring Windows Subsystem for Linux.
• Self-contained: All dependencies are included, reducing the chance of conflicts with other Python installations.
• Easy to update: Simply download a new version and replace the old folder.
• Portable: Can be moved between computers or run from external storage.

System Requirements

• Windows 10 or 11 (64-bit)
• NVIDIA GPU with CUDA support (recommended)
• At least 8GB of RAM (16GB or more recommended for larger models)
• Sufficient disk space for your training data and models

Troubleshooting

If firstrun.cmd fails:

• Make sure you have a stable internet connection for downloading dependencies
• Run the command prompt as administrator if you encounter permission issues
• Temporarily disable antivirus software if it's blocking the installation

If gui-uv.bat doesn't start:

• Check that the initial setup completed successfully
• Verify that your NVIDIA drivers are up to date
• Make sure no other applications are using your GPU intensively