vox-ai-motion-graphics-generator

agent
Guvenlik Denetimi
Uyari
Health Uyari
  • No license Ò€” Repository has no license file
  • Description Ò€” Repository has a description
  • Active repo Ò€” Last push 0 days ago
  • Community trust Ò€” 65 GitHub stars
Code Gecti
  • Code scan Ò€” Scanned 10 files during light audit, no dangerous patterns found
Permissions Gecti
  • Permissions Ò€” No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

🎬 Turn any topic into a finished Vox-style paper-collage explainer / motion graphics video β€” script, collage keyframes, animation, voice-over, music & captions, all automated. An agent skill for Claude Code, Codex & other coding agents.

README.md

Vox AI Motion Graphics Generator

Turn any topic into a finished Vox-style paper-collage explainer video


🚨 The problem with making explainer videos today:

  • ❌ Fragmented workflow β€” separate tools for scripting, image gen, animation, voice-over, music, and captions
  • ❌ No narrative structure β€” raw text-to-video models don't understand story arcs, hooks, or pacing
  • ❌ Inconsistent look β€” the collage aesthetic drifts from shot to shot
  • ❌ Hours of manual editing β€” stitching, ducking music, and burning captions by hand

πŸ’‘ The solution:

🎬 Screenwriter, Collage Artist, Animator, and Editor β€” all in one automated pipeline.

Type one topic. The agent writes the story beats, renders each beat as a torn-paper collage poster, animates it, adds a narrator voice-over, music, and burned-in captions β€” then stitches everything into a finished final.mp4. You stay in control with just two approval gates: the story beat map and the visual theme.


Awesome Generative AI Apps

🎨 Explore 50+ more open-source AI apps β†’

πŸŽ₯ Demo

▢️ Watch the demo β€” one topic in, a fully narrated & captioned Vox-style collage video out.

"Make me a 15-second Vox-style collage video on the history of coffee." β†’ a styled final.mp4, fully narrated and captioned.


πŸ“‘ Table of Contents


✨ Key Features

  • One topic β†’ finished film β€” a single one-line prompt produces a complete, captioned, narrated video
  • Authentic Vox collage aesthetic β€” torn paper, cutouts, tape, halftone dots, newspaper clippings, bold flat color, big headlines
  • Story-first β€” picks a narrative arc (timeline, problem-agitate-solution, how-it-works…) and writes a hook-led beat map before generating anything
  • Style bake-off β€” renders the same beat in 3–4 themes so you pick the look before committing
  • Living-poster motion β€” animates each collage keyframe into dynamic motion instead of static slides
  • Voice + music + captions β€” narration, background music ducked under the voice, and burned-in captions, all automated
  • Two human gates, everything else automated β€” approve the beat map, pick the theme; the pipeline handles the rest
  • Agent-native β€” a self-contained skill any coding agent (Claude Code, Codex, …) can read and run
  • One API key + ffmpeg β€” no cluster of accounts to wire up

🎨 The Look

The aesthetic is the modern editorial paper-collage popularized by Vox explainers and creators like Stav Zilber and rom1trs: hand-cut paper cutouts, torn edges, tape, halftone dots, newspaper clippings, bold flat colors per beat, and big cutout headlines β€” brought to life with dynamic motion, a narrator voice-over, music, and burned-in captions.

The collage look is born in the image step (each beat is a finished collage poster), and the motion is added after β€” so the DNA of the style is locked in before anything moves.


πŸ”„ How It Works

A single topic flows through a 6-stage pipeline driven by one beats.json per project:

topic
  β”‚
  β”œβ”€ 1. Beat Map        Pick a narrative arc β†’ write beats.json          ◀── GATE 1: approve the beat map
  β”œβ”€ 2. Style Bake-Off  Render the same beat in 3–4 themes               ◀── GATE 2: pick the look
  β”œβ”€ 3. Keyframes       One collage poster per beat
  β”œβ”€ 4. Motion          Animate each poster into a clip
  β”œβ”€ 5. Voice & Music   Narration + background music
  β”œβ”€ 6. Assemble        Stitch clips, duck music, burn captions (ffmpeg)
  └─ final.mp4

Two human decision gates keep you in control β€” approve the story beat map and select the visual theme. Everything else is fully automated.


🧩 Models

Pipeline Job Model
Keyframes (text-to-image) flux-dev
Motion (image-to-video) runway-image-to-video / veo3-image-to-video / wan2.1
Narration (text-to-speech) minimax-speech-2.6-turbo
Music suno-create-music

πŸš€ Quick Start

1. Install local dependencies

  • ffmpeg + ffprobe (brew install ffmpeg on macOS)
  • Python 3 with Pillow (pip install pillow)

2. Configure environment keys

export MUAPI_API_KEY="your-api-key"     # image / video / voice / music models β€” key from muapi.ai
export OPENAI_API_KEY="your-openai-key"  # story planning

3. Ask your coding agent (with this skill loaded)

"Make me a 15-second Vox-style collage video introducing the history of coffee."

The agent drafts a beat map, runs a style bake-off, generates keyframes, animates the clips, generates speech and music, and assembles the result under out/<project>/final.mp4.


πŸ› οΈ Project Structure

.
β”œβ”€β”€ SKILL.md            # the full agent workflow + the two approval gates
β”œβ”€β”€ AGENTS.md           # entry point for any coding agent
β”œβ”€β”€ scripts/            # one script per pipeline stage
β”‚   β”œβ”€β”€ style_bakeoff.py
β”‚   β”œβ”€β”€ keyframes.py
β”‚   β”œβ”€β”€ clips.py
β”‚   β”œβ”€β”€ audio.py
β”‚   β”œβ”€β”€ assemble.py
β”‚   └── ...
β”œβ”€β”€ references/         # prompt guide, beat/story library, voices
└── examples/           # sample beats.json

This is an agent skill β€” Claude Code auto-loads it from SKILL.md; Codex and other agents follow SKILL.md via AGENTS.md. Just ask for a "vox video" or a "collage video."


πŸ”— Related Projects


⭐ Star this repo if it helped you β€” and explore 50+ more open-source AI apps β†’

Yorumlar (0)

Sonuc bulunamadi