# Ralphy

> The AI film studio that lives in your terminal.

## Docs

- [Asset manifest](https://ralphy.mintlify.app/advanced/asset-manifest.md): asset-manifest.json — per-project slot pointer table, slot-id convention, and the auto-versioning archive flow.
- [Advanced](https://ralphy.mintlify.app/advanced/index.md): Format specs for everyone authoring against Ralphy — templates, skills, playbooks, schemas.
- [Memory schemas](https://ralphy.mintlify.app/advanced/memory-schemas.md): The three JSONL logs under a project's logs directory — append-only fields, lifecycle, and read patterns.
- [Models registry](https://ralphy.mintlify.app/advanced/models-registry.md): MODELS.md format — sections, per-model matrix tables, lifecycle, and how to add a new entry.
- [Playbook format](https://ralphy.mintlify.app/advanced/playbook-format.md): Playbook structure, sub-doc convention, AGENTS.md routing, and the agents-md lint.
- [Skill format](https://ralphy.mintlify.app/advanced/skill-format.md): SKILL.md frontmatter contract, the 1536-char description cap, and the ralphy vs ralphy-dev namespace split.
- [Template format](https://ralphy.mintlify.app/advanced/template-format.md): template.yaml Zod schema, vibe-reference vs vibe-style, segment categories, slug rules, and version gating.
- [Changelog](https://ralphy.mintlify.app/changelog/index.md): What's new in Ralphy.
- [Assets](https://ralphy.mintlify.app/cli/assets.md): ralphy assets list, pull, install, clean — the companion-repo pool, required template assets, and example projects.
- [Env and config](https://ralphy.mintlify.app/cli/env-config.md): Required env vars, .env precedence, the global config file, and the ralphy config verb.
- [Error catalog](https://ralphy.mintlify.app/cli/error-catalog.md): Every E_ code the CLI emits, its exit class, message template, and remediation hint.
- [Eval and research](https://ralphy.mintlify.app/cli/eval-research.md): ralphy eval video for post-render QA and ralphy research for URL or topic teardowns.
- [Examples](https://ralphy.mintlify.app/cli/examples.md): ralphy example list and pull — import full example projects from ralphy-assets.
- [Generation verbs](https://ralphy.mintlify.app/cli/generation-verbs.md): ralphy generate image, video, voiceover, music, sfx, captions — model picks, refs, append-only versioning, dry-run.
- [CLI reference](https://ralphy.mintlify.app/cli/index.md): Technical reference for the ralphy binary: global flags, verb groups, error catalog, end-to-end flows.
- [Models](https://ralphy.mintlify.app/cli/models.md): ralphy models list, show, alias — inspect the OpenRouter video catalog ralphy ships against.
- [Output modes](https://ralphy.mintlify.app/cli/output-modes.md): Pretty, JSON, NDJSON, and quiet — what each mode emits and when to use which.
- [CLI overview](https://ralphy.mintlify.app/cli/overview.md): Global flags, TTY auto-detection, project auto-detection, the bare-ralphy dashboard, cancellation.
- [Project verbs](https://ralphy.mintlify.app/cli/project-verbs.md): new, clone, project create / list / show / update / delete, plus log and timeline.
- [Rendering verbs](https://ralphy.mintlify.app/cli/rendering-verbs.md): ralphy render plus the audio, video, voice, editor utility verbs that bracket the render.
- [Resource CRUD](https://ralphy.mintlify.app/cli/resource-crud.md): The unified create / list / show / update / delete shape that brand, persona, ref, template, asset, batch, and friends all share.
- [Setup and doctor](https://ralphy.mintlify.app/cli/setup-doctor.md): The two verbs that get you from a fresh machine to a working ralphy.
- [Skills and playbooks](https://ralphy.mintlify.app/cli/skills-playbooks.md): ralphy skill install across agents, the sentinel-bounded merge contract, and how playbooks differ from skills.
- [Templates](https://ralphy.mintlify.app/cli/templates.md): ralphy template list, suggest, use, show, register — slug resolution across repo and workspace.
- [Architecture](https://ralphy.mintlify.app/concepts/architecture.md): Three moving parts: the agent in your editor, the ralphy CLI, and the workspace on disk.
- [Asset catalog](https://ralphy.mintlify.app/concepts/asset-catalog.md): The ralphy-assets companion repo holds gameplay loops, brainrot characters, and trend music as a generic pool.
- [Brands and personas](https://ralphy.mintlify.app/concepts/brands-personas.md): Reusable identity entities: who the video is from, and who is in it.
- [Generations log and manifest](https://ralphy.mintlify.app/concepts/generation-log.md): Every model call is appended to generations.jsonl. Every produced file is a versioned slot in asset-manifest.json.
- [Concepts](https://ralphy.mintlify.app/concepts/index.md): The shape of Ralphy: projects, refs, templates, agents, the workspace.
- [Playbooks and skills](https://ralphy.mintlify.app/concepts/playbooks-and-skills.md): Playbooks are role docs the agent reads on demand. Skills are slash-invocable workflows.
- [Projects](https://ralphy.mintlify.app/concepts/projects.md): A project is one video. This page covers the lifecycle, the on-disk layout, and the registry.
- [References and the ref-required gate](https://ralphy.mintlify.app/concepts/references.md): When a brief names a real person, brand, or IP, Ralphy refuses to generate without a reference.
- [Templates](https://ralphy.mintlify.app/concepts/templates.md): Vibe-reference and vibe-style templates, organized into five segment-persona categories.
- [What is Ralphy](https://ralphy.mintlify.app/concepts/what-is-ralphy.md): Ralphy is an AI film studio that lives in your terminal. Here is the shape of the idea.
- [Workspace](https://ralphy.mintlify.app/concepts/workspace.md): Where projects, brands, refs, caches, and renders live on disk.
- [Connect your editor](https://ralphy.mintlify.app/quickstart/connect-editor.md): Use Cursor, Copilot, or Codex instead of Claude Code. One ralphy skill install wires the routing in.
- [Your first video](https://ralphy.mintlify.app/quickstart/first-video.md): From a one-line brief to a rendered mp4, driven by chat in your editor. About 8 minutes.
- [Quickstart](https://ralphy.mintlify.app/quickstart/index.md): Clone the repo, open it in Claude Code, ask Claude to set you up, render your first video. About 10 minutes.
- [Install](https://ralphy.mintlify.app/quickstart/install.md): Clone the repo, open it in Claude Code, ask Claude to set you up. The standalone binary is the alternative.
- [What just happened](https://ralphy.mintlify.app/quickstart/what-happened.md): A file-by-file walkthrough of everything Ralphy wrote during your first video.
- [ralphy asset](https://ralphy.mintlify.app/reference/cli/asset.md): Manage and generate assets
- [ralphy assets](https://ralphy.mintlify.app/reference/cli/assets.md): Pull / list / clean assets from the ralphy-assets companion repo
- [ralphy audio](https://ralphy.mintlify.app/reference/cli/audio.md): FFmpeg audio recipes (loudnorm, sidechain duck, concat). All wrap cli/lib/ffmpeg-recipes.ts.
- [ralphy banner](https://ralphy.mintlify.app/reference/cli/banner.md): Print the Ralphy ASCII banner
- [ralphy batch](https://ralphy.mintlify.app/reference/cli/batch.md): Manage batch operations
- [ralphy brand](https://ralphy.mintlify.app/reference/cli/brand.md): Manage brands (design systems)
- [ralphy clone](https://ralphy.mintlify.app/reference/cli/clone.md): Lift the style of a public clip into a reusable vibe-style template. Chains ref pull → frames → analyze → blueprint → template create.
- [ralphy config](https://ralphy.mintlify.app/reference/cli/config.md): Manage configuration
- [ralphy daemon](https://ralphy.mintlify.app/reference/cli/daemon.md): Manage the local job worker (background process that executes queued ralphy jobs)
- [ralphy doctor](https://ralphy.mintlify.app/reference/cli/doctor.md): Env health check — keys, dependencies, project link. JSON for scripts; -p for human view.
- [ralphy editor](https://ralphy.mintlify.app/reference/cli/editor.md): Editor-stage observability — preflight clip checks, trim-analysis, composition QA.
- [ralphy eval](https://ralphy.mintlify.app/reference/cli/eval.md): Evaluate the quality of a rendered video
- [ralphy example](https://ralphy.mintlify.app/reference/cli/example.md): Pull / list complete reference projects from the companion repo
- [ralphy generate](https://ralphy.mintlify.app/reference/cli/generate.md): Generate a single asset (image / video / voiceover / music / captions). Logs cost + path automatically.
- [ralphy init](https://ralphy.mintlify.app/reference/cli/init.md): Initialize workspace and config
- [ralphy models](https://ralphy.mintlify.app/reference/cli/models.md): Inspect available OpenRouter video models and their per-model parameter constraints
- [ralphy new](https://ralphy.mintlify.app/reference/cli/new.md): Create a new project under <workspace>/projects/<id>/ with a canonical layout. Lightweight on-ramp — pass a brief to seed BRIEF.md or just --id <slug> for an em
- [ralphy persona](https://ralphy.mintlify.app/reference/cli/persona.md): Manage personas (voice + style)
- [ralphy profile](https://ralphy.mintlify.app/reference/cli/profile.md): Share workspace artifacts across users via committed profiles/
- [ralphy project](https://ralphy.mintlify.app/reference/cli/project.md): Manage video projects
- [ralphy prompts](https://ralphy.mintlify.app/reference/cli/prompts.md): Prompt cookbook + library lookup (02.03 / 02.0L)
- [ralphy queue](https://ralphy.mintlify.app/reference/cli/queue.md): Manage the local job queue (add work, watch progress, cancel, retry)
- [ralphy ref](https://ralphy.mintlify.app/reference/cli/ref.md): Manage references (websites, social media)
- [ralphy render](https://ralphy.mintlify.app/reference/cli/render.md): Render a project to MP4. Engine: HyperFrames (HTML + GSAP). Writes workspace/projects/<id>/render/final.mp4. Adds EBU R128 loudnorm with --loudnorm. Also auto-e
- [ralphy research](https://ralphy.mintlify.app/reference/cli/research.md): Topic-level research: aggregate multiple sources into a single report
- [ralphy setup](https://ralphy.mintlify.app/reference/cli/setup.md): Setup wizard — API keys, dev services
- [ralphy skill](https://ralphy.mintlify.app/reference/cli/skill.md): Manage Ralphy skill installs across AI agents
- [ralphy status](https://ralphy.mintlify.app/reference/cli/status.md): Show enabled capabilities + linked project
- [ralphy template](https://ralphy.mintlify.app/reference/cli/template.md): Manage scenario/video templates
- [ralphy version](https://ralphy.mintlify.app/reference/cli/version.md): Print the ralphy version (same as -v / --version)
- [ralphy video](https://ralphy.mintlify.app/reference/cli/video.md): FFmpeg video recipes (extract-segment, burn-subs, tonemap-hdr, concat). Wraps cli/lib/ffmpeg-recipes.ts.
- [ralphy voice](https://ralphy.mintlify.app/reference/cli/voice.md): ElevenLabs voice library inspection — pre-flight checks before VO batches.
- [ralphy whoami](https://ralphy.mintlify.app/reference/cli/whoami.md): Show the per-user profile (skill score 0-10, developer badge, signals, recommendation for adaptive intake). On first call, auto-backfills from workspace/project
- [ralphy workspace](https://ralphy.mintlify.app/reference/cli/workspace.md): Manage workspace
- [Batches](https://ralphy.mintlify.app/working/batches.md): Three or more videos from one template is a batch. Never run a loop by hand — use ralphy batch.
- [Brands, personas, and refs](https://ralphy.mintlify.app/working/brand-persona-refs.md): When to lock identity. How to attach brands, personas, and reference images, and when the ref gate refuses to budge.
- [Generating assets](https://ralphy.mintlify.app/working/generating-assets.md): The five generate sub-verbs, default models, the --ref flag, dry-run, slot IDs, and automatic versioning.
- [Working with Ralphy](https://ralphy.mintlify.app/working/index.md): Day-to-day how-to for non-technical creators and power users — briefs, templates, generation, review, render, batches, profiles.
- [Logs and costs](https://ralphy.mintlify.app/working/logs-and-costs.md): Three append-only JSONL logs. ralphy project log, timeline, jq rollups, and the auto-generated postmortem.
- [Picking a template](https://ralphy.mintlify.app/working/picking-a-template.md): ralphy template suggest is the first move. 54 templates, two kinds, five categories — how to pick and what gets copied.
- [Profiles](https://ralphy.mintlify.app/working/profiles.md): Export your workspace under profiles/your-nick, share via PR, import other people's brand-persona-ref kits.
- [Rendering the final mp4](https://ralphy.mintlify.app/working/rendering.md): ralphy render reads the manifest, runs HyperFrames, writes final.mp4. The loudnorm pass, render history, perf targets.
- [Reviewing and iterating](https://ralphy.mintlify.app/working/reviewing-iterating.md): Regen writes a versioned file next to the original. Review variants, promote a winner, never lose work.
- [Starting a project](https://ralphy.mintlify.app/working/starting-a-project.md): The intake protocol — five questions, a draft plan, a wait for go, then one beat at a time.
- [How to talk to Ralphy](https://ralphy.mintlify.app/working/talking-to-ralphy.md): Chat is the interface. How phrasing maps to playbooks, with worked utterances and override syntax.

## OpenAPI Specs

- [openapi](https://ralphy.mintlify.app/api-reference/openapi.json)