Local AI Image Generator

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

📖 Overview

Local AI Image Generator is a packaged, production-grade desktop environment designed to run Stable Diffusion models natively on Windows with maximum performance and zero installation complexity.

Say goodbye to manual Python installations, corrupted PyTorch dependencies, global Node.js setups, or broken CUDA toolchains. This workspace automatically downloads, configures, and serves the entire local image generation stack inside a single directory.

---

⚡ Quick Start

1. Launch

Double-click start.bat in the root directory.

On your first launch, the automated installer script will download a portable Node.js build, configure dependencies, detect your GPU, download pre-compiled backend binaries, and compile the user interface.

2. Put Weights in Place

Place any .safetensors, .gguf, or .ckpt model file into:

app/models/

(Or use the Model Manager tab in the browser dashboard to download one from our curated library).

3. Generate Offline

Open http://localhost:1420 in your default web browser, select your model, write a prompt, and start creating!

---

✨ Features

100% Offline & Private All inference runs entirely on your local GPU/CPU. Your prompts, images, and data never leave your computer.	Auto-Detected GPU Acceleration Seamlessly detects and configures **CUDA** for Nvidia cards, or falls back to the high-performance **Vulkan** engine for AMD & Intel Arc GPUs.
No Global Dependencies Zero system footprint. Node.js is downloaded as a portable binary into a sandbox folder, leaving your environment paths untouched.	Dynamic Backend Controller A native Node.js process manager hosts the React frontend, streams system telemetry, manages downloads, and handles inference server lifecycles.
Real-time Hardware Telemetry Monitor your PC's real-time CPU, RAM, GPU, and VRAM utilization directly inside the workspace UI.	Drag & Drop Model Importing Upload local model files from other folders on your PC or download weights directly from Hugging Face via the built-in UI downloader.

---

🏗️ Project Structure

local-ai-image-generator/
├── start.bat                  # main double-click launcher
├── .gitignore
├── README.md                  
│
├── scripts/
│   ├── setup.ps1              # dynamic 4-stage dependency manager
│   ├── reset.ps1              # repair utility (clears builds, keeps your models/images)
│   └── serve.cjs              # static UI server & backend controller
│
└── app/
    ├── frontend/              # React + Vite dashboard source code
    ├── backend/               # pre-compiled stable-diffusion.cpp GPU binaries
    │   ├── win/cuda/          # CUDA acceleration backend (sd-cuda.exe)
    │   └── win/vulkan/        # Vulkan acceleration backend (sd-vulkan.exe)
    ├── models/                # weight repository (.safetensors, .gguf, .ckpt)
    ├── outputs/               # generated PNGs and JSON parameters metadata
    ├── tools/node/            # portable Node.js sandbox
    └── dist/                  # built frontend assets (compiled on setup)

---

🖥️ GPU Compatibility Matrix

The application server configures itself to utilize the best performance pathways on your PC:

GPU Brand	Tech	Status	Setup Output
Nvidia	CUDA	✅ Native Support	Maps sd-cuda.exe with Nvidia SDK 12 optimizations.
AMD Radeon	Vulkan	✅ Native Support	Maps sd-vulkan.exe with Vulkan API acceleration.
Intel Arc	Vulkan	✅ Native Support	Maps sd-vulkan.exe for GPU acceleration.
None / Integrated	CPU	⚠️ Thread Fallback	Runs on logical threads (slow, for testing).

---

🛠️ Troubleshooting

🔄 Resetting / Repairing

If you encounter corrupted downloads or want to rebuild your frontend assets, run:

scripts/reset.ps1

Note: This cleans the portable environment files and downloads fresh copies, but safely preserves your downloaded models inside app/models/ and images in app/outputs/.

🔌 Port Conflict Warnings

The launcher utilizes two ports on local address 127.0.0.1:

• 1420 (Frontend Dashboard Server)
• 8080 (Local Inference C++ API Server)

Ensure no other applications or development services are binding to these ports before launching.

---

📝 License

This project bundles stable-diffusion.cpp under the MIT License. Individual model weights are subject to their respective licenses — please check model cards on Hugging Face or Civitai before commercial application.