Kria

AI-powered tool that transforms raw real-life videos into viral-ready short-form content (TikTok, Reels, YouTube Shorts).

Start with the code and test navigation map, current architecture, or runtime evidence and handoff guide.

Quick start

cp .env.example .env    # fill in your values
./scripts/dev-auto.sh    # starts infra, migrations, API, worker, and web with hot reload

• Frontend: http://localhost:3000
• API: http://localhost:8000

Structure

src/apps/web/   — Next.js frontend
src/apps/api/   — Python FastAPI + Celery
src/apps/ios/   — native SwiftUI/AVFoundation app (iOS 18; XcodeGen)
agents/         — agent context (read before working on video processing)
docs/           — pipeline internals, runbooks, specs, designs (start at docs/README.md)
CLAUDE.md       — working agreements, invariants, key paths, env vars
DESIGN.md       — design-system tokens, loading rules, anti-slop rules, a11y baseline
LICENSES.md     — third-party component and font licenses
TODOS.md        — backlog moved to Linear 2026-10-04 (see its header and docs/runbooks/linear-workflow.md); add nothing new here

Native setup, build commands, and architecture boundaries are in the Kria iOS development runbook. The phone-rendering pilot runbook describes the account-gated experimental path, supported edits, consent, and remaining KRI-29 release gates. The iOS-device-only runtime cutover runbook covers the staged production retirement of web/cloud creation while preserving reads and device publication. The KRI-37 native editor validation record covers source previews, authored text controls, verified release scope, and deferred qualification; consult current runtime evidence for capability rollout state. The KRI-43 captions and visuals runbook documents caption styling, visual authoring, additive API fields, timeline behavior, and API-first rollout.

Implemented surfaces

These describe code in the repository. Availability depends on deployment, account gates, and client capabilities; see the runtime evidence guide before treating a rollout label as current production state.

• Chat-first creation — start at /plan, choose Montage, Narrated, or Talking to camera, add your footage, direct Kria in the conversation, approve a render, then keep editing in the same conversation beside the ready cut. Previewable AI edits stay undoable until Save/export; direct editor links reopen this workspace (creation runbook; editor chat runbook; implementation plan). Legacy /create and /create/manual links redirect here.
• Template mode — drop your clips into a viral template; Gemini analyzes each clip and matches it to the right slot
• Music beat-sync — browse a music gallery, pick a song, upload clips; every cut lands on a detected beat (/music)
• Guided Plan edit — describe the story you want in ordinary language, review how Kria uses all uploaded photos and videos, approve before rendering, then edit the approved story's timeline, Looks, music, and supported layers on desktop or mobile (pipeline and rollout guide; mobile timeline plan; native editor parity plan)
• Main Creator Agent — describe the feeling or story for a plan item, review one capability-aware creative direction, and explicitly confirm the typed render (architecture, API, and rollout guide)
• Kria domain agent — one durable creation and revision conversation with useful editorial decisions, reversible server drafts, portable text/timeline/caption/music/mixed-media edits, exact approval before every render, receipt-backed outcomes, and recovery across refreshes and worker failures (runtime architecture; )

Branch conventions

• main — protected, requires PR + 1 approval
• dev — integration branch
• {initials}/{feature-slug} — feature branches (e.g. ee/upload-endpoint)

Cofounder setup

bash setup-cofounder.sh