Outscal Video Generator

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

📑 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:

[!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 │
└─────────┘   └─────────┘   └───────────┘   └───────────┘   └────────┘   └────────┘   └───────┘

[!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)

...