🖼️ Local AI Image Generator

A fully self-contained, offline-first AI Art Studio for Windows

Generation Workspace	Model Library	Image Constraints

📖 Overview

Local AI Image Generator is a zero-configuration, portable desktop environment for running Stable Diffusion (Safetensors/GGUF/CKPT) offline on Windows. Double-clicking start.bat automatically handles dependency setup, GPU backend matching (CUDA/Vulkan), and launches a high-performance local web workspace.

⚡ Quick Start

Launch: Double-click start.bat (downloads portable Node.js and pre-compiled GPU backend binaries on first run).
Add Models: Drop .safetensors, .gguf, or .ckpt weights into app/models/ (or download them via the Model Manager tab in the UI).
Generate: Open http://localhost:1420 in your browser, select your model, and write a prompt.

✨ Features

100% Offline & Private: Inference runs completely locally on your hardware.
Auto-Detected GPU Acceleration: Configures CUDA for Nvidia cards, and Vulkan for AMD or Intel Arc GPUs.
Zero System Footprint: Node.js is sandboxed inside the folder. No global environment paths are altered.
Integrated Model Manager: Paste a Hugging Face URL to download weights directly, or drag-and-drop local weight files to import them.
Real-time Telemetry: Monitor RAM, VRAM, CPU, and GPU load directly in the UI.
Local Gallery: Saves generated PNGs alongside prompt metadata JSONs to app/outputs/.

📁 Repository Structure

local-ai-image-generator/
├── start.bat                  # Main double-click entrypoint
├── LICENSE                    # MIT Open Source license
├── .gitignore
├── README.md                  
├── scripts/
│   ├── setup.ps1              # Automated GPU-detect and environment installer
│   ├── reset.ps1              # Cleans runtime environments (keeps models & outputs)
│   └── serve.cjs              # UI web server and backend lifecycle manager
└── app/
    ├── frontend/              # UI source code (Vite + React)
    ├── models/                # Place weights here (.safetensors, .gguf, .ckpt)
    └── outputs/               # Saved images and parameters metadata

🖥️ GPU Compatibility Matrix

GPU Vendor	Tech	Status	Notes
Nvidia	CUDA	✅ Native	Maps `sd-cuda.exe` with Nvidia SDK 12 optimizations.
AMD Radeon	Vulkan	✅ Native	Maps `sd-vulkan.exe` with Vulkan API acceleration.
Intel Arc	Vulkan	✅ Native	Maps `sd-vulkan.exe` for Intel hardware.
Integrated / None	CPU	⚠️ Fallback	Runs on logical CPU threads (slow).

🛠️ Troubleshooting

Reset Environment: If a build fails or you want to clear dependencies, run scripts/reset.ps1. (This preserves your models and generated images).
Port Conflicts: The application binds to ports 1420 (Frontend) and 8080 (Backend API). Ensure these are free.

📝 License

This project is licensed under the MIT License - see the LICENSE file. Bundles stable-diffusion.cpp (MIT License). Model weights are subject to their respective creators' licenses.

4.1 KiB Raw Blame History