Installation

The only system requirement is FFmpeg (see below).

Run with npx (no install)

The quickest way to try hance, no install step, on macOS or Linux:

npx @orva-studio/hance video.mp4

This downloads and runs the latest hance on demand. Swap npx for bunx if you use Bun.

With an AI agent

Install the skill into your agent with skills.sh:

npx skills add orva-studio/hance

This registers the /hance skill so your agent can drive hance in plain English. Then run the setup command, which verifies FFmpeg and gets you ready in one step:

> /hance setup

Harnesses that don’t use skills.sh can read the same instructions straight from the CLI at runtime — no install — via bunx @orva-studio/hance skills. See AI Agent Usage for details.

Install a persistent binary

For frequent CLI use, install hance to your PATH so you don’t re-download it each run:

curl -fsSL https://hance.video/install.sh | sh

This installs hance and its GPU sidecar to ~/.hance/bin. The installer detects macOS (arm64/x64) or Linux (x64/arm64). No Bun, Rust, or Node required.

Requirements

Hance requires FFmpeg and ffprobe on your system.

macOS

brew install ffmpeg

Linux

sudo apt install ffmpeg

Verify

hance --version