# ComfyUI Serverless — Documentation

Welcome. This is the complete guide for using and managing the ComfyUI serverless deployment.

## For Users

- **[Getting Started](GETTING_STARTED.md)** — Install and launch (Mac + Windows)
- **[Troubleshooting](TROUBLESHOOTING.md)** — Common errors and how to fix them

## For Admins

- **[Add a Model](ADD_MODELS.md)** — How to add a new model to the deployment
- **[Add a Custom Node](ADD_CUSTOM_NODES.md)** — How to add a new custom node pack
- **[Deploy](DEPLOY.md)** — How to deploy changes to fal.ai
- **[Claude Code Rules](claude-rules.md)** — Rules for Claude Code / Codex to help you safely

## Quick Links

| Action | Command |
|--------|---------|
| Launch (Mac) | `./run.sh` |
| Launch (Windows) | `run.bat` or `.\run.ps1` |
| Deploy server | `cd server && make deploy` |
| Monitor runners | https://fal.ai/dashboard/apps/<org>/<app>/runners |
| Browse outputs | http://localhost:8188/outputs |

## Architecture

```
Your Machine (local)                     fal.ai Cloud
┌───────────────────────┐               ┌────────────────────┐
│ Proxy (localhost:8188)│ ── HTTPS ──▶  │ ComfyUI Server     │
│ Frontend + file mgmt  │               │ H100 GPU           │
│ Video preview (ffmpeg)│               │ Auto-scales        │
│ Output gallery        │ ◀── SSE ───   │ Results to CDN     │
└───────────────────────┘               └────────────────────┘
```
