AIUGC — Hebrew AI UGC Ad Platform (backend)

Hebrew-first ad-generation platform for Israeli advertisers. Two services on one pipeline:

• Service A — 3–4s pre-rendered hook clip (curated bank) with a burned Hebrew hook line, hard cut into the customer's phone-filmed demo, with burned Hebrew captions and optional Hebrew voiceover.
• Service B — UGC-style ads with consistent AI personas: a single-setting selfie talking head (ElevenLabs V3 + HeyGen lip-sync behind ~800ms of leading silence), optionally opened by a founder-made clip with the hook text burned over it, released through a founder QC gate.

All output: vertical 9:16, 1080×1920, H.264 MP4. Everything user-facing is Hebrew.

Status

Design + scaffold phase. The pipeline runs headless via CLI first (founder cold-outreach samples), the self-serve web app comes later as a thin wrapper over the same functions. External provider calls are stubbed behind DRY_RUN=1 until API keys exist.

Layout

docs/                  Design documents (start at docs/00-overview.md)
supabase/migrations/   SQL migrations (generated by drizzle-kit + hand-written RLS/seed)
prompts/               Versioned Claude prompt files: prompts/<name>/v<N>.md
packages/core/         ALL business logic: db, jobs, providers, pipelines, config
apps/cli/              `aiugc` CLI — thin wrapper over core
apps/worker/           Job loop — thin wrapper over core
apps/web/              Next.js self-serve app — onboarding-first, Supabase Auth (needs apps/web/.env.local)

Quickstart

pnpm install
cp .env.example .env        # fill DATABASE_URL (Supabase) — DRY_RUN=1 needs nothing else
pnpm typecheck
pnpm test                   # jobs/migrations smoke tests run against in-process Postgres (PGlite)
pnpm --filter @aiugc/cli dev -- --help

CLI

pnpm --filter @aiugc/cli dev <command> (DRY_RUN=1 stubs every external provider). The founder workflow, end to end, is in docs/06-cli-first.md; the Service B half in one breath:

aiugc persona add-image <personaId> selfie.jpg --kind selfie        # the render source
aiugc bank add-opener --persona-image <imageId> --effect hand_cover --label "כף יד" \
  --file opener.mp4 --reveal-at-ms 1600 --safe-area '{"x":60,"y":900,"w":960,"h":300}'
aiugc copy b-script --business <bizId> --persona <id> --structure <id>   # script + draft hook text
aiugc script edit <scriptId> --text "..."                            # re-derives the hook text
aiugc tts <scriptId> && aiugc work --once && aiugc audio approve <audioId>
aiugc render-b --business <bizId> --audio <audioId> --persona <personaId> \
  --opener <clipId> --hook-text "ככה מזמינים בלי לחכות"
aiugc work --once && aiugc qc list

See docs/06-cli-first.md for the full founder workflow and the path from CLI to the self-serve HTTP layer.