Skip to content

outscal/video-generator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

10 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Outscal Video Generator

An AI-powered video generation tool that creates animated videos from text scripts using Claude Code.

Platform Python Built with Claude Code Built with React TTS

πŸ“‘ Table of Contents

πŸ’‘ 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

πŸš€ 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  β”‚ β†’ β”‚   Audio   β”‚ β†’ β”‚ Direction β”‚ β†’ β”‚ Assets β”‚ β†’ β”‚ Design β”‚ β†’ β”‚ Video β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜   β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜   β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜   β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜   β””β”€β”€β”€β”€β”€β”€β”€β”€β”˜   β””β”€β”€β”€β”€β”€β”€β”€β”€β”˜   β””β”€β”€β”€β”€β”€β”€β”€β”˜
Step What Happens
🎨 Style Choose from available art styles
πŸ“ Script Provide your narration script (max 2000 characters)
πŸ”Š Audio Convert script to speech using ElevenLabs
🎬 Direction Generate scene-by-scene video direction
πŸ–ΌοΈ 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

Pencil-Demo.mp4

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.

Infographic

Infographic-Demo.mp4

Clean, modern, and professional style with bold colors, geometric shapes, and data visualization elements. Uses flat design principles with clear iconography. Ideal for business presentations, explainer videos, and data-driven content.

Neon

Neon-Demo.mp4

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.

About

genrates video using ai

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published