🌐 Languages: English | Русский | ไทย | 中文 | Español | العربية

Haydee AI Outfit Generator GUI

A modern graphical user interface for the Haydee AI Outfit Generator library. Easily generate custom outfits for Haydee without messing with terminals or environment variables!

📥 Download the latest HaydeeOutfitGenerator.exe here

🖼️ Generated Examples

Check out what you can create! The following outfits were generated using this tool and are featured in the Haydee: Tropical Harvest (Fruit-Themed Outfit Pack) mod on the Steam Workshop.

✨ Features

• Modern Dark Interface: Built with CustomTkinter for a sleek, game-themed appearance.
• Three Unique Workflows: Seamlessly switch between generating brand new outfits via AI, getting creative inspiration for your styles, and grouping your existing mods into single multi-mods.
• Granular Generation Control: Individually toggle the generation of Diffuse (Color), Specular (Material/Gloss), and Normal (3D Bump) maps to save API requests or regenerate specific parts.
• Customizable AI Models: Choose exactly which Gemini AI model processes your request (e.g., gemini-3.1-flash-image-preview or other supported models).
• Quality Assurance Loop: Automatically validates the AI-generated textures for structural flaws (like incorrect anatomy or seams) using a more advanced model, and sends feedback to the AI to re-draw it up to 3 times before saving.
• Network Resilience: Built-in 10-minute SDK timeout patches and automatic 3-attempt API retry loops ensure your generations don't fail due to temporary Google API server congestion or 503/504 Deadline Exceeded errors.
• No Terminal Required: Configures all paths and handles logging automatically.
• Asynchronous Processing: The UI remains responsive while the outfit is being generated via AI or while mods are being grouped.
• Standalone Executable: Easily package the app into a single .exe file that any Windows user can run out-of-the-box.

🚀 Quick Start (For Users)

1. Download the latest HaydeeOutfitGenerator.exe release.
2. Launch the application.
3. Fill in the Settings panel:
   • Your Gemini API Key.
   • Path to your Haydee game installation directory.
   • Your Author Name (Optional, applied to all generated or grouped mods).
   • Your AI Model (Defaults to gemini-3.1-flash-image-preview).
   • Your Validation AI Model (Defaults to gemini-3.1-pro-preview).
4. Click Save Settings.
5. Choose your workflow tab:
   • ✨ Generate Outfit: Enter a unique mod name, a descriptive style prompt, and toggle which textures you want to generate (Diffuse, Specular, or Normal) before starting.
   • ** Prompt Ideas**: Feeling stuck? Enter a simple theme (like "Cyberpunk") and get AI-generated outfit concepts. Apply ideas directly to the generator with one click.
   • 📦 Group Mods: Combine multiple existing mods into one multi-mod. Enter the new multi-mod name, the source mods to group (e.g., red, green, blue), and the slot category (e.g., color).
6. Click Start Generation, Generate Prompt Ideas, or Group Outfits and watch the magic happen in the built-in console window!

(Note: The app will automatically save your settings in AppData/Local/HaydeeOutfitGenerator/settings.json so you don't have to enter your details every time.)

🔑 Getting a Gemini API Key

1. Go to Google AI Studio.
2. Sign in with your Google account.
3. Click the "Create API key" button.
4. If prompted, read and accept the terms of service.
5. Click on "Create API key in new project" (or use an existing project).
6. Copy the generated key. You will need to paste it into the Settings panel of the application.

🛠️ Developer Setup

If you want to contribute or build the application yourself:

Prerequisites

• Python 3.12+
• Git

Installation

1. Clone this repository:

   git clone https://github.com/thegamerbay/haydee-ai-outfit-generator-gui.git
   cd haydee-ai-outfit-generator-gui

2. Install dependencies:

   pip install -r requirements.txt

3. Run the application from source:

   python main.py

Building the Executable

This project includes an automated script that uses PyInstaller to package the app into a standalone .exe without a black console window.

To build:

python build.py

After the build completes, your application will be available in the dist/ folder as HaydeeOutfitGenerator.exe.

Running Tests

This project includes automated GUI tests written with pytest and pytest-mock.

1. Install the testing dependencies:

   pip install -r requirements-dev.txt

2. Run the tests:

   pytest tests/

Running Linting

This project uses flake8 to enforce code style.

1. Ensure testing dependencies are installed:

   pip install -r requirements-dev.txt

2. Run the linter:

   flake8 src tests main.py build.py

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.