Super Remotion

@vindepemarte/super-remotion installs a project-local AI video production kit for Remotion motion graphics, HyperFrames compositing, and agent-driven editing workflows.

It is not a prompt dump. It creates a concrete project contract: resources, rules, agent docs, reusable SFX, run artifacts, media folders, and optional Remotion/HyperFrames scaffolds.

Install

npm install -D @vindepemarte/super-remotion
npx super-remotion
npx super-remotion init

For a global smoke test:

npm install -g @vindepemarte/super-remotion
super-remotion --help

Commands

super-remotion
super-remotion init
super-remotion config openrouter
super-remotion codex
super-remotion doctor
super-remotion produce --video media/source.mp4 --script scripts/script.md
super-remotion qa --run runs/latest
super-remotion render --run runs/latest
super-remotion resume --run runs/latest

OpenRouter Setup

After init, configure OpenRouter with:

npx super-remotion config openrouter \
  --api-key sk-or-your-key \
  --creative openrouter/auto \
  --editor openrouter/auto \
  --vision openrouter/auto \
  --qc openrouter/auto

This writes:

.super-remotion/.env
.super-remotion/.env.example
.super-remotion/config.json

.super-remotion/.env is ignored by .super-remotion/.gitignore.

You can also edit it manually:

SUPER_REMOTION_LLM_PROVIDER=openrouter
OPENROUTER_API_KEY=sk-or-your-key
SUPER_REMOTION_MODEL_CREATIVE=openrouter/auto
SUPER_REMOTION_MODEL_EDITOR=openrouter/auto
SUPER_REMOTION_MODEL_VISION=openrouter/auto
SUPER_REMOTION_MODEL_QC=openrouter/auto
SUPER_REMOTION_MODEL_FALLBACK=ollama:gemma4:12b

Use hybrid if you want OpenRouter when the key exists and local/CLI fallback otherwise:

SUPER_REMOTION_LLM_PROVIDER=hybrid

Then verify:

npx super-remotion doctor

What init Adds

.super-remotion/
  config.json
  .env
  .env.example
  resources/
  skills/super-remotion/
  sfx/
.rules/super-remotion.md
AGENTS.md / CLAUDE.md / GEMINI.md
media/
scripts/
runs/
renders/
motion/
hyperframes/

motion/ is the Remotion workspace. hyperframes/ is the final compositing workspace. runs/<name>/ stores project artifacts and QA reports.

Production Inputs

Best first test:

media/source.mp4
scripts/script.md
references/ref_01_url.txt
references/ref_02_url.txt
references/ref_03_url.txt

If a raw recording exists, Super Remotion treats transcript and word timing as the source of truth. If no recording exists, the script becomes the source of truth and the output is motion-graphics-first.

Current V1 Boundary

This package implements the installer, project resource kit, artifact contracts, media probing, HyperFrames scaffold, QA checks, and render command orchestration. Heavy AI generation, WhisperX transcription, and final production rendering depend on the selected local/external tools being installed and configured.