README.md

Comfy Labs

A growing collection of tiny AI apps, displayed in a gallery. Each card opens a self-contained app (text-to-image, logo maker, sticker maker, …) that anyone can use. Every app runs its own ComfyUI Cloud workflow on cloud GPUs.

How it works

Gallery (/)  →  App page (/apps/<slug>)  →  form  →  useGenerate(slug, inputs)
  → POST /api/generate { slug, inputs }
      → registry.getApp(slug) → buildWorkflow(app, inputs) → ComfyUI Cloud
  → poll /api/status/{jobId} → signed output URL → rendered result

Add a new app (3 steps)

1. apps/<your-slug>/workflow.json — your ComfyUI workflow in API format.
2. apps/<your-slug>/app.config.ts — metadata + a mapping of UI fields → workflow node inputs (default export an AppDefinition).
3. Add one import + array entry in lib/registry.ts.

The gallery, routing, and API pick it up automatically. You never touch lib/comfy-client.ts, the API routes, or the generate hook.

Local dev

cp .env.example .env.local   # add your COMFY_API_KEY
npm install
npm run dev

Get an API key at https://platform.comfy.org/profile/api-keys

Deploy

Connected to Vercel — pushing to main auto-deploys. Env vars (COMFY_API_KEY, COMFY_API_BASE) are set in the Vercel project settings.