Avatar Video

avatar-video

Full pipeline: text script → portrait image → voice audio → lip-synced video.

/init - First-Time Setup

~/.claude/skills/avatar-video/scripts/setup.sh

This creates ~/.avatar-video/.env with your FAL_KEY. Get one at https://fal.ai → Dashboard → API Keys.

nano-banana must also be installed (see /nano-banana skill).

Quick Reference

Full Pipeline (text → video)

# Premium quality (OmniHuman 1.5) — ~$3.68 for 30s
~/.claude/skills/avatar-video/scripts/generate-avatar.sh \
  "Hi, I'm your your app assistant. I'm here to help you navigate your VA disability claim." \
  --quality premium

# Budget quality (Infinite Talk) — ~$1.88 for 30s
~/.claude/skills/avatar-video/scripts/generate-avatar.sh \
  "Welcome to our service" \
  --quality budget

Individual Steps

# 1. Generate portrait (uses nano-banana)
nano-banana "professional headshot of a woman, studio lighting, neutral background" -s 1K -o portrait

# 2. Generate voice (MiniMax Speech)
~/.claude/skills/avatar-video/scripts/minimax-tts.sh \
  "Hello, welcome to your app" \
  --voice Friendly_Person \
  --output speech.mp3

# 3a. Lip-sync with OmniHuman 1.5 (premium)
~/.claude/skills/avatar-video/scripts/omnihuman-lipsync.sh \
  --image portrait.png \
  --audio speech.mp3 \
  --output avatar-video.mp4

# 3b. Lip-sync with Infinite Talk (budget)
~/.claude/skills/avatar-video/scripts/infinitetalk-lipsync.sh \
  --image portrait.png \
  --audio speech.mp3 \
  --output avatar-video.mp4

Orchestrator Options

| Flag | Default | Description | |------|---------|-------------| | --quality | premium | premium (OmniHuman) or budget (Infinite Talk) | | --engine | auto | omnihuman or infinitetalk (overrides --quality) | | --voice | Friendly_Person | MiniMax voice ID | | --voice-speed | 1.0 | Speech speed (0.5-2.0) | | --image | - | Skip image gen, use existing portrait | | --audio | - | Skip voice gen, use existing audio | | --output | avatar-{timestamp} | Output filename (no extension) | | --dir | current directory | Output directory | | --image-prompt | auto | Custom prompt for portrait generation |

MiniMax Speech Voices

Built-in voices (pass to --voice):

| Voice ID | Description | |----------|-------------| | Wise_Woman | Mature, authoritative female | | Friendly_Person | Warm, approachable (default) | | Deep_Voice_Man | Deep, resonant male | | Calm_Woman | Soothing, relaxed female | | Casual_Guy | Informal, conversational male | | Lively_Girl | Energetic, youthful female |

Custom voice cloning: provide a voice sample URL as --voice .

Engine Comparison

| Feature | OmniHuman 1.5 | Infinite Talk | |---------|---------------|---------------| | Cost | $0.12/s (lip-sync) | $0.03/s (480p), $0.06/s (720p) | | 30s video | ~$3.60 | ~$0.90-$1.80 | | Max length | 30s audio | 10 minutes | | Quality | Best — full body motion, gestures | Good — solid lip-sync | | Resolution | 720p/1080p | 480p/720p | | Best for | Short premium content, ads | Long-form, bulk, prototyping |

Full Pipeline Costs (30-second video)

| Step | Tool | Cost | |------|------|------| | Image | nano-banana (Gemini Flash) | ~$0.05 | | Voice | MiniMax Speech 2.6 Turbo | ~$0.03 | | Lip-sync (budget) | Infinite Talk 720p | ~$1.80 | | Lip-sync (premium) | OmniHuman 1.5 | ~$3.60 | | Total (budget) | | ~$1.88 | | Total (premium) | | ~$3.68 |

Cost Tracking

Every generation logs to ~/.avatar-video/costs.json. View summary:

~/.claude/skills/avatar-video/scripts/generate-avatar.sh --costs

API Keys

| Service | Key | Source | |---------|-----|--------| | MiniMax Speech, OmniHuman, Infinite Talk | FAL_KEY | ~/.avatar-video/.env | | nano-banana (image gen) | GEMINI_API_KEY | ~/.nano-banana/.env |

All fal.ai services use a single key. Get one at https://fal.ai.

Troubleshooting

• "FAL_KEY not found" — Run setup: ~/.claude/skills/avatar-video/scripts/setup.sh
• "Audio must be under 30s" (OmniHuman) — Use Infinite Talk for longer audio, or trim script
• Upload failed — Check FAL_KEY is valid; fal.ai file upload requires auth
• Queue timeout — OmniHuman can take 2-5 min; the script polls automatically
• nano-banana not found — Install via /nano-banana skill init

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: barkleesanders
• Source: barkleesanders/claude-code-starter
• License: MIT

Install and usage instructions live in the source repository linked above.