--- name: varg-video-generation description: Generate AI videos using varg SDK React engine. Use when creating videos, animations, talking characters, slideshows, or social media content. license: MIT metadata: author: vargHQ version: "1.0.0" compatibility: Requires bun runtime. FAL_KEY required. Optional ELEVENLABS_API_KEY, REPLICATE_API_TOKEN, GROQ_API_KEY allowed-tools: Bash(bun:*) Bash(cat:*) Read Write Edit --- # Video Generation with varg React Engine Generate AI videos using declarative JSX syntax with automatic caching and parallel generation. ## Quick Setup Initialize a new project: ```bash bunx vargai init ``` Or just create hello.tsx starter: ```bash bunx vargai hello ``` Check existing API keys: ```bash cat .env 2>\/dev\/null | grep -E "^(FAL_KEY|ELEVENLABS_API_KEY)=" || echo "No API keys found" ``` ## Required API Keys ### FAL_KEY (Required) | Detail | Value | |--------|-------| | Provider | Fal.ai | | Get it | https:\/\/fal.ai\/dashboard\/keys | | Free tier | Yes (limited credits) | | Used for | Image generation (Flux), Video generation (Wan 2.5, Kling) | If user doesn't have `FAL_KEY`: 1. Direct them to https:\/\/fal.ai\/dashboard\/keys 2. Create account and generate API key 3. Add to `.env` file: `FAL_KEY=fal_xxxxx` ### Optional Keys | Feature | Key | Provider | URL | |---------|-----|----------|-----| | Music\/Voice | `ELEVENLABS_API_KEY` | ElevenLabs | https:\/\/elevenlabs.io\/app\/settings\/api-keys | | Lipsync | `REPLICATE_API_TOKEN` | Replicate | https:\/\/replicate.com\/account\/api-tokens | | Transcription | `GROQ_API_KEY` | Groq | https:\/\/console.groq.com\/keys | **Warn user about missing optional keys but continue with available features.** ## Available Features by API Key **FAL_API_KEY only:** - Image generation (Flux models) - Image-to-video animation (Wan 2.5, Kling) - Text-to-video generation - Slideshows with transitions - Ken Burns zoom effects **FAL + ELEVENLABS:** - All above, plus: - AI-generated background music - Text-to-speech voiceovers - Talking character videos **All keys:** - Full production pipeline with lipsync and auto-captions ## Quick Templates ### Simple Slideshow (FAL only) ```tsx \/** @jsxImportSource vargai *\/ import { Render, Clip, Image } from "vargai\/react"; const SCENES = ["sunset over ocean", "mountain peaks", "city at night"]; export default ( {SCENES.map((prompt, i) => ( <\/Clip> ))} <\/Render> ); ``` ### Animated Video (FAL + ElevenLabs) ```tsx \/** @jsxImportSource vargai *\/ import { Render, Clip, Image, Video, Music } from "vargai\/react"; import { fal, elevenlabs } from "vargai\/ai"; const cat = Image({ prompt: "cute cat on windowsill" }); export default (