Skip to content

higgsfield-ai /cli

40+ Higgsfield image, video, 3D and audio models from your terminal
Model toolingMITEnglish README
Stars
621
30 days
New
Last push
12 days ago

About cli

Higgsfield CLI puts 40+ hosted image, video, 3D and audio models in your terminal. You also get workflows for dubbing, reframing and voice change. You'll need a Higgsfield account and login to use it.

Best for: Developers who want to script Higgsfield's models from the shell or an agent pipeline.

What it does

  • Generates images, video, 3D assets and audio with 40+ hosted models
  • Runs workflows like draw-to-video, reframe, voice change and dubbing
  • Trains a Soul ID so the same face shows up across your shots
  • Scores a finished video for hook, attention and retention
  • Builds matched narration and clip blocks into one explainer video
  • Deploys websites and browser games from the same command line

Quickstart

Rewritten from the README. Check the repo for the latest steps.

  1. 1
    Install on macOS or Linux with curl: the command below
    curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
  2. 2
    Or install with Homebrew: the command below
    brew install higgsfield-ai/tap/higgsfield
  3. 3
    Or install anywhere, including Windows, with npm: the command below
    npm install -g @higgsfield/cli
  4. 4
    Log in: higgsfield auth login
  5. 5
    Make an image and wait for the result URL: the command below
    higgsfield generate create nano_banana_2 --prompt "a quiet beach at sunrise" --wait

Models and languages

Models it works with

  • Nano Banana Pro
  • Nano Banana 2 Lite
  • Gemini Omni Flash
  • FLUX.2
  • Higgsfield Soul V2
  • Google Veo 3.1
  • Kling v3.0
  • Seedance 2.5
  • GPT Image 2.5
  • Wan 2.7

Interface and docs

  • English

Alternatives

Other model tooling projects people compare with cli.

wide-trace

open-higgsfield

Self-hosted studio for 38 image and video models

Model tooling
  • Seedance 2.5
  • Seedance 2.0
  • Kling 3
  • +7
3.9k GitHub stars14 days agoNo license

Puts Seedance, Kling, MiniMax and Wan video models behind one Python tool

Model tooling
  • Seedance 2.5
  • Seedance 2.0
  • Kling 3.0
  • +7
551 GitHub stars4 days agoMIT

MiniMax-AI

cli

MiniMax images, video, speech and text from your terminal

Model tooling
  • MiniMax H3
  • Hailuo-2.3
  • MiniMax-M3
  • +1
2.2k GitHub stars2 days agoNo license

Wan-Video

Wan2.2

Open video models for text, image, speech and character animation

Model tooling
  • Wan 2.2-T2V-A14B
  • Wan 2.2-I2V-A14B
  • Wan 2.2-TI2V-5B
  • +5
18k GitHub stars10 days agoApache-2.0

Featured on OpenMicroDrama

Do you maintain cli? Add this badge to your README so English speakers can find our write-up.

Featured on OpenMicroDrama
markdown
[![Featured on OpenMicroDrama](https://openmicrodrama.com/badges/featured.svg)](https://openmicrodrama.com/projects/higgsfield-ai-cli)

The badge links to this page. Want your description changed? Email support@openmicrodrama.com.

Reviewed Oct 1, 2026. Official CLI for the hosted Higgsfield platform; generation runs on their servers, not your machine. We write these descriptions ourselves. The repo's own docs are the final word.