lipnardo

Production-grade Claude Code skill for AI avatar talking-head video generation, powered by the HeyGen REST API.

Fills the gaps in HeyGen's 11 official skills: batch generation, template variable injection, photo-to-avatar pipeline, credit estimation, webhook management, and crash-recoverable orchestration.

Quick Start (2 minutes)

Step 1: Get a HeyGen API key

Sign up at app.heygen.com, then go to Settings → API and create a key. Pay-as-you-go starts at a $5 minimum balance.

Step 2: Download and install

git clone https://github.com/AgriciDaniel/lipnardo.git
cd lipnardo
bash install.sh

Windows (PowerShell):

powershell -ExecutionPolicy Bypass -File .\install.ps1

The installer:

• Checks Python 3.8+ is available
• Symlinks the skill into ~/.claude/skills/lipnardo/
• Creates ~/Documents/lipnardo_videos/ for output
• Optionally writes your API key to ~/.heygen/config.json (chmod 600)

Step 3: Make videos

Open Claude Code and say:

"Generate a 30-second avatar video saying: Welcome to Acme Industries"

Or use the command directly:

/lipnardo generate --prompt "A professional explaining quarterly results" --aspect-ratio 16:9

What You Can Do

Say this...	What happens
"Generate an avatar video saying X"	AI Video Agent creates it (v3 endpoint)
"Make a multi-scene video from this script"	Studio mode (up to 50 scenes)
"Generate 100 personalized videos from this CSV"	Batch mode with 3-concurrent queue
"Translate this video to Spanish with lip-sync"	v3 translation, speed or precision mode
"Turn this photo into a talking avatar"	Full Photo Avatar IV training pipeline
"Convert this text to speech"	Starfish TTS engine
"How much will this cost?"	Pre-flight cost estimation
"Download video XYZ before the URL expires"	Local download with retry

Features

• 12 production scripts, ~3,500 lines, stdlib-only (zero pip install)
• 3 generation modes: Video Agent (v3), Studio (v2), Template
• Batch orchestration with concurrent limit, retry, exponential backoff, and crash-recoverable manifests
• Cost ledger at ~/.heygen/costs.json (chmod 600, atomic writes)
• Translation with speed or precision mode (v3 endpoint)
• Photo Avatar IV pipeline: upload → group → train → generate
• Webhook management for async generation
• Security-hardened: SSRF guards, batch financial caps, ID sanitization

Requirements

• Claude Code — Get it here (CLI, Desktop, or VS Code extension)
• Python 3.8+ — stdlib only, no extra packages required
• HeyGen API key — free signup, $5 minimum balance for first paid generation
• Internet — videos are generated on HeyGen's servers, then downloaded locally

Pricing

Pricing is set by HeyGen and billed to your API balance. Lipnardo does not add fees.

Feature	Cost / second	Per minute
Avatar III video	$0.0167	~$1.00
Video Agent (v3)	$0.0333	~$2.00
Photo Avatar (IV)	$0.0500	~$3.00
Digital Twin (IV)	$0.0667	~$4.00
Translation (speed)	$0.0333	~$2.00
Translation (precision)	$0.0667	~$4.00
Starfish TTS	$0.000667	~$0.04