Turn

into a content factory

The open-source CLI that plugs into any coding agent and turns it into a one-prompt video marketer. Trend-watch, clone any style, render in minutes, iterate from the numbers.

Github

1Install the CLI

One curl — fetches the prebuilt binary for your platform. Works on macOS · Linux · Windows.

2Drop in your keys

Interactive wizard, takes ~30s. Paste your openrouter + elevenlabs keys when prompted.

3Run from Claude Code

Open a project, ask Claude Code to make a video. The agent picks up ralphy from your $PATH — no plugin needed.

showcase

Renders that move the scroll.

Photoreal

Hyper Motion

Anthropomorphic

Photoreal

Hyper Motion

Anthropomorphic

Product Ad

UGC Selfie

Pixel Art

Product Ad

UGC Selfie

Pixel Art

Analog Horror

Horror Short

Broadcast

Cinematic

Comic

Analog Horror

Horror Short

Broadcast

Cinematic

Comic

hover a column to pause · click a tile for fullscreen · ← / → to navigate

how it works

A complete content studio
inside your agent.

Trend research, style cloning, video generation, and self-critic — all wired into the same chat you already use for code.

trend-watch

See what's spiking first.

Drop a niche or an @handle. Ralphy crawls TikTok, Reels, and Shorts and reports what's gaining velocity — before it peaks. Hooks, formats, and reference URLs ready to fork.

ralphy trend

$ ralphy trend "@nikitabier" --niche saas
  ✓ scanning TikTok, Reels, Shorts ...
  → 47 clips · last 14d
  → top formats: hyper-motion 38% · talking-head 24%
  → spiking now: "rate my SaaS" hook · +312% w/w
# 6 references attached → ./workspace/trends/saas-2026-05/
$ ralphy clone <url>

style-clone

Clone any look from a URL.

Paste a TikTok, Reel, or Short, or fork a template — commercials, hyper-motion, horror, fruit drama, talking head. Ralphy lifts the visual recipe; you keep the words.

ralphy clone

$ ralphy clone https://tiktok.com/@x/video/72939...
  ✓ analyzing visual style ...
  → palette  cold cinematic · low-key
  → format   hyper-motion · 6 cuts · 22s
  → hook     "have you ever ..."
  → music    drill · 138 bpm

  ✓ template forked → ./styles/hyper-motion-x/
# 11 prompts, 4 refs, 1 music slot · ready to render

render

From idea to finished mp4 in ~8 minutes.

Image keyframes from gemini-3-pro, motion from kling-v3 · veo-3.1 · seedance-2.0, voice from eleven-multilingual-v2, composed through Remotion. Every source file stays on disk.

ralphy render

$ ralphy render --product "Linear" --style hyper-motion
  → planner    5 shots · 22s total
  → researcher 4 references · 1 hook
  → scenarist  prompts locked
  → renderer   gemini-3-pro → kling-v3
  ⠼ rendering shot 03/05 · ETA 2m 14s
  ✓ workspace/linear-001/v01.mp4  (22s · 1080×1920)

iterate

Learn from the numbers. Compound.

Plug views, watch-time and conversions back into the project. Ralphy keeps the variants that work and quietly retires the ones that don't — automatically, on the next run. Same agent, smarter every cycle.

ralphy iterate

$ ralphy iterate --campaign linear-001
  → pulling 7 days of analytics ...
  ✓ TikTok    12.4k views · CTR 4.2%
  ✓ Reels      8.1k views · CTR 3.6%
  ✓ Shorts     2.0k views · CTR 1.1%

  critic suggests:
    • shorter hook (-1.2s)
    • cooler grade (-15° saturation)
    • drop Shorts variant
$ ralphy render --remix

templates

A growing template library.

Five style families today, more landing each week. Every entry is a fork-and-tweak starter — drop your product, restyle, render in one command.

01 · commercialslive

Brand spots

Premium product spots à la Nothing Phone — clean studio light, beauty pans, cinematic copy. Drop your product, keep the polish.

02 · hyper-motionlive

Hyper-motion

Macro speed-ramps and impossible camera work — the Flipper-style hardware reveal that stops a scroll dead. Built for launches.

03 · horrorsoon

Horror shorts

60-second creep-outs with cold lighting and a twist hook. Wildly over-indexes for retention; plug your CTA at the end.

04 · fruit dramasoon

Fruit dramas

Absurdist, character-driven micro-stories with maximum charm-per-second. Format that printed views in 2025; rebrand-friendly.

05 · talking headlive

Talking head

Founder monologue with B-roll and captions. Cheapest format we ship; perfect for daily build-in-public posts and LinkedIn.

MIT-licensedrebrand-friendlyone command to fork+ new families weekly

under the hood

Five orchestrated sub-agents. One mp4.

Under every prompt, five quiet workers your agent dispatches in sequence. Each writes to the same workspace. None charge per seat.

01 · idea

Capture

One sentence in chat. Ralphy stretches it into a brief.

02 · prompt

Optimize

Templates + model rules turn the brief into shot prompts.

03 · board

Plan

A 5-shot storyboard, references attached, durations locked.

04 · render

Generate

Image · video · voice · music — composed through Remotion.

05 · refine

Iterate

Critic scores, sliders move, the loop closes itself.

one prompt → finished mp4~8m wall-clock~$10 in API12 iterations0 humans waiting

roadmap

Max quality. Min attention.

Two axes drive every shipping decision: how good is the output, and how little of your time did it cost. Five categories, click to expand.

Auto-rescore + auto-regen loop

Quality gates retry a failing scene up to 3× before surfacing it. No human gate between scoring and regen.

Multi-pass evaluator (scene / audio / captions)

`ralphy eval` runs scene segmentation, loudness + dead-air, caption density, and per-scene vision pass — produces a structured report a fixer agent can act on.

Identity lock via master shots

Product and model master shots get pinned and passed via `--ref` to every generation — prevents identity drift between scenes.

Model-aware fallback

Kling for default UGC selfies, Seedance for horror / POV / non-default physics — routing rules in MODELS.md, not coded into prompts.

in progress

Vision defect detector

Pre-VO pass that catches hands, eyes, text artifacts, and continuity breaks — kills the worst drift before it reaches render.

in progress

Multi-variant + best-pick

Three takes per scene, vision-scored, the loser variants get garbage-collected. The agent never asks which to keep.

Cross-scene continuity check

Wardrobe, lighting, and prop continuity verified across the full storyboard — not just within a single shot.

Self-tuning quality thresholds per niche

Horror, talking-head, and product-spot have different floors. Thresholds learn from accepted vs rejected outputs over time.

Auto-budget cap per scene

When auto-regen loops, the agent caps total spend per scene before escalating to the user — no runaway $50 retries.

Multi-pass video analyzer (Gemini)

References get decomposed into shot list, camera grammar, sound design, and cultural subtext — not just transcribed VO.

Frame + timecode shot extraction

`ralphy ref pull` runs yt-dlp, extracts keyframes, transcribes audio, runs vision per shot — feeds the analyzer with structured data, not raw mp4.

VO re-voicing through ElevenLabs

Reference VO transcript becomes the script; ElevenLabs re-voices it in any persona — same words, your brand voice.

in progress

Camera grammar capture

Focal length, dolly, push-in, whip-pan — extracted as a vocabulary, injected into shot prompts so motion matches the reference, not just composition.

in progress

Pacing & cut-rhythm replication

Edit timecodes lifted straight from the reference. Hooks land on the same beat as the source — viewers can't tell why it feels right.

in progress

Audio fidelity match

Tone, energy, and ambient texture transferred — not just the spoken script. Music brief inferred from the reference's stem.

Per-character voice cloning

ElevenLabs voice library indexed per project; the same character keeps the same voice across every render in the campaign.

Music style match (stems-aware)

Detect tempo, key, instrument palette from the reference stem and brief the music model accordingly — not generic genre tags.

Cultural subtext annotation

Slang, meme references, regional cues flagged in the analyzer's report so the scenarist either keeps them deliberately or substitutes for the target audience.

Companion asset repo (ralphy-assets)

Brainrot characters, gameplay loops, and trend music live in alecs5am/ralphy-assets — sha-pinned, version-controlled, agent-installable.

Asset catalog with pool-by-kind

`ralphy assets list --kind <kind>` shows the curated pool before the agent writes a prompt naming a specific character or track.

Vibe-reference + vibe-style templates

5 full-stack production templates (composition.md + reference) and 38 prompt cookbooks shipped in-repo, indexed by 5 segment-persona categories.

Top-20 viral-2026 playlist

Curated cross-category roster for agent test-drives — the fastest path from blank workspace to a known-good render.

in progress

Daily trend feed

What's spiking on TikTok / Reels / Shorts by niche, refreshed daily and queryable via `ralphy trend` — before formats peak.

in progress

Per-niche playbooks

DTC commerce, B2B SaaS, creator-lifestyle, entertainment-viral, cinematic narrative — each with its own hook bank, model picks, and quality floor.

Auto-template extraction from references

Drop 3 high-performing references in a niche → ralphy distils a vibe-reference template you can fork into new campaigns.

Style cookbook → 200+

Current 38 vibe-style packs grow to 200+ via community contributions and auto-extraction from public references.

Community template marketplace

Operators publish vibe-reference + vibe-style packs, the agent installs them on demand. Star-ranked, niche-indexed, MIT-licensed by default.

Trend prediction model

Not just what's spiking — what's about to. Velocity + niche-saturation signals to flag formats while they're still cheap.

AGENTS.md routing contract

Every user request matched to a playbook before any generation. The hard discipline that prevents the agent from improvising on covered topics.

Skill packs for Claude Code

researcher / scenarist / art-director / editor / producer / evaluator / release / postmortem — drop into .claude/skills, auto-routed by AGENTS.md.

JSON-first CLI output

Every command defaults to machine-greppable JSON. `-p` for pretty tables when a human is reading. Agents never have to parse ANSI.

Project memory logs (auto-written)

Every gen, user prompt, and uploaded asset gets appended to JSONL logs under `workspace/projects/<id>/logs/`. The agent re-reads them across sessions.

in progress

Front-stage CLI verbs

`trend` / `clone` / `make` / `iterate` collapse the current 40-command surface into four agent-friendly actions on top of the resource CRUD.

in progress

MCP server

Ralphy callable from any MCP-aware runtime — Claude desktop, Cursor, ChatGPT — without installing the CLI. The agent owns the loop end-to-end.

in progress

Codex + Cursor skill ports

Same playbooks, mirrored into Codex's AGENTS.md format and Cursor's rules layer. Skill discipline travels with the agent, not the IDE.

Skill marketplace install

`ralphy skill install <pack>` for community-authored playbooks. Versioned, scoped, sandboxed — installing a skill never executes code on read.

Web Studio (human fallback)

Drag-drop reference, preview, render — for the rare humans who'd rather click than chat. Secondary surface, never the canonical one.

Batch-from-template (N≥10)

`ralphy batch-from-template` ships variant grids without a hand-held loop. Per-render cost + quality logged for rollup.

Cost tracking per render

Every model call (image / video / VO / music) writes input, output, and cost to generations.jsonl — total spend per project is a single jq away.

ralphy doctor + status

One-command health check: keys, deps, render env, model availability — surfaces what's broken before the first render fails.

Cross-platform install (brew / curl / npm / ps1)

macOS, Linux, Windows — same binary, four install paths, all referencing the same GitHub Release. install.sh handles quarantine + PATH automatically.

in progress

Cloud rendering

Remotion Lambda / serverless GPU — the laptop fan stops, render time decouples from your hardware, batches finish overnight.

in progress

Analytics fetch from platforms

Pull views, watch-time, CTR from TikTok / Reels / Shorts back into `ralphy iterate` — feeds the next render decision automatically.

Auto-publish (scheduled)

Scheduled posting via TikTok / Reels / Shorts APIs. Metrics flow back into the project log; the loop closes itself.

A/B in-flight

Two hooks per batch, performance-weighted, winning variants automatically promoted to a template for future runs.

Cost guardrails + auto-fallback

Per-project budget cap; when threshold trips, the agent auto-fallbacks to a cheaper model + reports before continuing the batch.

stack

Not a SaaS. A toolkit you fork.

Ralphy is glue. Skills live as markdown. The model registry is one file. The template library is open. MIT, always — your keys, your repo, your files.

lives inside

Claude CodeCursorCodexany agent CLIbare $ ralphy

OpenRouterVercel AI GatewayElevenLabsRemotiongemini-3-prokling-v3veo-3.1seedance-2.0

ship as

TikTokReelsYouTube ShortsXMeta adsAmazon listings…or any channel you ship to

open source

Built with operators. Not at them.

The best skills, templates, and prompts come from the founders, marketers, and operators running it every day. Push your style family — the next person ships with your playbook on day one.

Ship a template

Found a format that prints engagement? Bundle the style, refs, prompts — push it. Anyone running Ralphy installs your playbook in one command.

Write a skill

A skill is a single markdown file in your repo — add a new model, a new transition, an analytics hook, a caption style. Drop it in, Ralphy picks it up on the next run.

Bring a use case

Drop your funnel, your numbers, your bottleneck in #ideas. The community picks up what feels obvious in hindsight, ships it next week.

Just use it

Star the repo, post the render that landed, tell us which step felt slow. That's how we know which corner to polish first.

Discord

Where founders, marketers, and indie operators trade prompts, templates, and that one weird ffmpeg flag. Dev team hangs in #beta.

join the campfire →

GitHub

Source, issues, releases — and the template library. Open a PR, get your style family into the next install.

fork & ship →

X / Twitter

Daily render drops, model news, what just landed in main. Tag @ralphy_studio with your numbers to get reposted.

follow →

Docs · Mintlify

CLI reference, skill authoring, model registry, template authoring — searchable, with worked examples for each family.

read the docs →

Ship something real
in minutes

Get started for free

Star on GitHub2.4k

Turninto a content factory

Renders that move the scroll.

A complete content studioinside your agent.

See what's spiking first.

Clone any look from a URL.

From idea to finished mp4 in ~8 minutes.

Learn from the numbers. Compound.

A growing template library.

Five orchestrated sub-agents. One mp4.

Max quality. Min attention.

Autonomous quality

Auto-rescore + auto-regen loop

Multi-pass evaluator (scene / audio / captions)

Identity lock via master shots

Model-aware fallback

Vision defect detector

Multi-variant + best-pick

Cross-scene continuity check

Self-tuning quality thresholds per niche

Auto-budget cap per scene

Reference fidelity

Knowledge pool

Agent-native surface

Pipeline & distribution

Not a SaaS. A toolkit you fork.

Built with operators. Not at them.

Ship a template

Write a skill

Bring a use case

Just use it

Discord

GitHub

X / Twitter

Docs · Mintlify

Ship something realin minutes

Turn

into a content factory

A complete content studio
inside your agent.

Ship something real
in minutes