# 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.