// video · heygen-com/heygen-cli

heygen-cli

Make AI videos from your terminal — the official HeyGen CLI.

💎 Hidden gem★ 142 stars⑂ 25 forksApache-2.0updated 2026-10

▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.

// project facts

Project facts

heygen-cli is an open-source video project by heygen-com (heygen-com/heygen-cli on GitHub). It has 142 GitHub stars and 25 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 4 October 2026.

Repository: heygen-com/heygen-cli
GitHub stars: 142
Forks: 25
License: Apache-2.0
Last updated on GitHub: 4 October 2026
Category: Video
Listing: Hidden gem — a shorter page for a lesser-known project
Official site: Official site

// how it works

How it works

Install the CLI
Get heygen-cli on your machine.
Authenticate
Connect your HeyGen API key.
Script your video
Define avatar, voice, and script in commands.
Generate
Render the AI video from the terminal.

// features

Why people love it

Official CLI

First-party HeyGen tooling.

Terminal workflow

Video generation as shell commands.

Avatar videos

Talking-head AI video production.

Scriptable

Automate in pipelines and CI.

Go binary

Fast, single-binary install.

Apache 2.0

Open source.

// run it

Run it yourself

Step 1 — Clone the repo
Download the source and move into the project folder.
```
git clone https://github.com/heygen-com/heygen-cli.git
cd heygen-cli
```
Step 2 — Check the README
Every project documents its own setup; start with install requirements.
```
cat README.md | head -60
```
Step 3 — Run it
Follow the project's launch command — Docker, pip, npm, or a binary release.
```
# see README for the exact launch command
```

// use cases

What you can build

Generate HeyGen videos from the terminal.
Automate avatar video production.
Script video creation in CI pipelines.
Bulk-produce talking-head videos.

// faq

Questions, answered

Is heygen-cli free to use?

Apache 2.0 code — HeyGen API usage follows HeyGen pricing.

Do I need a HeyGen account?

Yes — API access required.

What can it generate?

AI avatar videos — see HeyGen's docs for capabilities.

Is it really official?

Yes — under the heygen-com GitHub org.

Why a CLI over the dashboard?

The most-starred other Video projects in the LibreAI catalogue — the realistic shortlist if heygen-cli is not the right fit.

yt-dlp★ 195.3k
A feature-rich command-line audio/video downloader
Deep-Live-Cam★ 96.9k
real time face swap and one-click video deepfake with only a single image
obs-studio★ 76.9k
OBS Studio - Free and open source software for live streaming and screen recording
FFmpeg★ 64.7k
Mirror of https://git.ffmpeg.org/ffmpeg.git
OpenMontage★ 62.7k
World's first open-source, agentic video production system. 12 production pipelines, 100+ tools, 700+ agent skill and production-knowledge files. Turn your A…

Get heygen-cli

Free and open — grab the source, star the repo, and start creating.

View on GitHub ↗← More Video tools