Initial commit

2026-05-04 09:38:56 +02:00
commit 7be72a3650
16 changed files with 1525 additions and 0 deletions
@@ -0,0 +1,44 @@
+# Kawai
+
+Local AI image and video generator. Simple UI. NSFW-capable. Auto GPU detection (Nvidia / AMD / Intel / CPU).
+
+## Quick start
+
+```
+python launcher.py
+```
+
+Run with **any Python** you have installed. The launcher bootstraps `uv` and uses it to fetch a clean Python 3.11 runtime + venv, then installs the right PyTorch build for your GPU. Nothing about your system Python is touched.
+
+First run takes a few minutes (uv install + Python 3.11 download + torch + dependencies). Subsequent runs start instantly.
+
+### What the launcher does
+
+1. Installs `uv` to `.tools/` if not present.
+2. Creates `venv/` with Python 3.11 (uv downloads the interpreter on demand).
+3. Detects GPU (Nvidia / AMD / Intel / CPU) and installs matching PyTorch wheel.
+4. Installs latest `diffusers`, `transformers`, etc.
+5. Opens browser UI at `http://127.0.0.1:7860`.
+
+### Reset
+
+Delete `venv/` and `.tools/` to force a clean reinstall.
+
+## Hardware tiers
+
+| VRAM | Default image model | Default video model |
+|------|--------------------|---------------------|
+| 4 GB | SDXL Turbo (fp16) | disabled |
+| 8 GB | Pony Diffusion XL | LTX-Video (fp8) |
+| 12 GB | Illustrious XL | LTX-Video (fp16) |
+| 16 GB+ | Illustrious XL + refiner | Wan 2.1 |
+
+User can override defaults in UI.
+
+## Safety
+
+CSAM detection on all outputs (NudeNet age classifier + hash check). All other content allowed: NSFW, gore, violence.
+
+## Status
+
+Windows only. Linux support planned.