video-generator

📑 Table of Contents

• How It Works
• Prerequisites
• Quick Start
• Video Creation Workflow
• Video Art Styles
• Commands Reference

💡 How It Works

Unlike traditional AI video generators that output video files, this tool generates React/TSX code that renders as animated videos. The AI writes the code—the code becomes the video.

📋 Prerequisites

• Claude Code CLI installed and configured. see Claude Code Quickstart

🚀 Quick Start

⚡ TL;DR: Clone repo → Run /tools:init → Set API key → Run /create-video

1. Clone and Setup

1. Get the repository: Either clone the repository or download it as a ZIP file and extract it.

2. Open Claude Code in the repository directory to ensure all commands work properly.

2. Install Dependencies

Run the initialization command in Claude Code:

/tools:init

This command will automatically:

• install the requirements needed to start generating video
• will direct you to setup the api key and will tell you how.

[!NOTE] This command only needs to be run once during initial setup.

3. API Key Setup (Required)

After installation completes, you need to set up your API key (this will be instructed after the /tools:init comand as well):

1. Get your API key: Visit https://production2.outscal.com/v2/get-video-generation-api-key and register or login
2. Add your API key to the .env file:

   OUTSCAL_API_KEY="your_api_key_here"
   

   Replace your_api_key_here with the actual API key you received.

4. Optional Environment Variables

The following environment variable is optional and only needed if you want to use a different voice:

| Variable | Description | Required | |----------|-------------|----------| | ELEVENLABS_VOICE_ID | Voice ID from ElevenLabs. You can pick different voice IDs from your ElevenLabs account if you want to change the voice. | No |

[!NOTE] Only ElevenLabs' pre-made voices are supported. Custom or cloned voices will not work.

5. Create Your Video

Run the video creation command:

/create-video

[!TIP] Run this command every time you want to create a new video.

🔄 Video Creation Workflow

When you run /create-video, the tool will guide you through this pipeline:

┌─────────┐   ┌─────────┐   ┌───────────┐   ┌───────────┐   ┌────────┐   ┌────────┐   ┌───────┐
│  Style  │ → │ Script  │ → │ Direction │ → │   Audio   │ → │ Assets │ → │ Design │ → │ Video │
└─────────┘   └─────────┘   └───────────┘   └───────────┘   └────────┘   └────────┘   └───────┘

| Step | What Happens | |------|--------------| | 🎨 Style | Choose from available art styles | | 📝 Script | Provide your narration script (max 2000 characters) | | 🎬 Direction | Generate scene-by-scene video direction | | 🔊 Audio | Convert script to speech using ElevenLabs | | 🖼️ Assets | Create SVG assets for the video | | ✏️ Design | Generate detailed design specifications | | 🎥 Video | Create and deploy video (displays deployed URL) |

[!TIP] After videos are created and deployed, use /tools:list-videos to view all deployed video URLs.

🎨 Video Art Styles

When creating a video, you'll be asked to choose from three distinct visual styles:

Pencil

https://github.com/user-attachments/assets/d0eac993-6b4f-4757-8317-936550ba3b93

A hand-drawn, sketch-like aesthetic that gives videos a personal, artistic feel. Features rough edges, sketch lines, and a notebook-paper appearance. Great for educational content that wants to feel approachable and informal.

Neon

https://github.com/user-attachments/assets/e3356b5f-8f5b-4e98-b146-25054382057a

Vibrant, futuristic style with glowing effects, dark backgrounds, and bright accent colors. Features electric highlights and cyberpunk-inspired visuals. Perfect for tech topics, gaming content, or when you want a high-energy, modern look.

📖 Commands Reference (FYI)

| Command | Description | |---------|-------------| | /tools:init | Install all project dependencies | | /tools:list-videos | List all deployed video URLs for the project | | /create-video | Start the full video creation workflow | | /gen:audio --topic "topic-name" | Generate audio only | | /gen:director --topic "topic-name" | Generate video direction only | | /gen:assets --topic "topic-name" | Generate SVG assets only | | /gen:design --topic "topic-name" | Generate design specifications only | | /gen:video --topic "topic-name" | Generate video components only |

[!IMPORTANT] If you run individual gen: commands instead of /create-video, you must run all subsequent commands in the workflow sequence for your changes to take effect. For example, if you run /gen:director, you'll need to manually run /gen:assets, /gen:design, and /gen:video afterwards.

Star History