Skip to content

wide-trace /open-higgsfield

Self-hosted studio for 38 image and video models
Model toolingNo licenseEnglish README
Stars
6.1k
30 days
+1.8k
Last push
2 months ago

About open-higgsfield

OpenHiggsfield AI is a self-hosted web studio for images and videos. One prompt bar drives 38 models: 8 image and 30 video. You bring your own platform key, so there's no studio subscription. No license file ships with it, so reuse terms stay unclear.

Best for: Prompt tinkerers who want to self-host a studio and plug in their own platform key.

What it does

  • Drives image and video from one prompt bar; the model picks the output
  • Ships a searchable catalog of 38 models (8 image, 30 video)
  • Shows only the settings each model allows: ratio, resolution, duration, audio
  • Takes start frame, end frame, reference, video and audio inputs
  • Keeps a masonry gallery with favorites, reuse and bulk download
  • Restores model, settings and prompt when you reuse a run

Quickstart

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

  1. 1
    Install dependencies with pnpm install
  2. 2
    Start the dev server with pnpm dev and open http://localhost:3000
  3. 3
    Press **Add key** and paste your platform key as id:secret
  4. 4
    Set HF_API_BASE_URL and OPEN_HIGGSFIELD_READ_WRITE_TOKEN in your environment

Models and languages

Models it works with

  • Seedance 2.5
  • Seedance 2.0
  • Kling 3
  • Soul 2
  • Soul Cinema
  • Wan
  • Flux
  • Ideogram
  • Recraft
  • LTX

Interface and docs

  • English

Common questions

What people ask when they look this repo up, answered from its issues and docs.

Is open-higgsfield made by Higgsfield AI?
Nothing in the repo says so. It comes from a new account (wide-trace, made Aug 2026, one repo) and calls itself an alternative to Higgsfield. Don't mix up openhiggsfield.ai, its hosted studio, with open.higgsfield.ai, which is Higgsfield's own API site. Source
What API key does open-higgsfield need?
A Higgsfield API key, made in Higgsfield Console as a key ID plus a secret. Paste it as id:secret. The studio calls Higgsfield's own model endpoints, such as higgsfield-ai/soul/v2/standard. Source
Is open-higgsfield free?
The code and the hosted copy at openhiggsfield.ai cost nothing. But each successful run spends credits on your Higgsfield API account. Failed or NSFW runs aren't charged, and credits expire one year after you add them. Source
Does open-higgsfield support Higgsfield Genjutsu?
Not yet. The model catalog has no Genjutsu entry, and issue #10 asking for it is still open. The last code update (Sept 17, 2026) only added Seedance 2 and 2.5. Source
Where does open-higgsfield keep my history and uploads?
History stays in your browser (IndexedDB), capped at 60 records. Favorites never age out of that cap. Uploads go to Vercel Blob, so self-hosting needs a Blob read-write token. Old result links can break when the platform's CDN expires them. Source
Which Seedance versions does open-higgsfield have?
Seedance 2.5 (with Edit and Extend) and Seedance 2.0 (Fast and Mini). Both sit in the 30-video-model catalog next to Kling 3, Wan, LTX and MiniMax. You pick the model in the prompt bar, and the settings change to match. Source

Alternatives

Other model tooling projects people compare with open-higgsfield.

letorig

video-generator-client

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

Model tooling
  • Seedance 2.5
  • Seedance 2.0
  • Kling 3.0
  • +7
558 GitHub stars+7/30d28 days agoMIT

higgsfield-ai

cli

40+ Higgsfield image, video, 3D and audio models from your terminal

Model tooling
  • Nano Banana Pro
  • Nano Banana 2 Lite
  • Gemini Omni Flash
  • +7
719 GitHub stars+54/30d26 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 stars+33/30d7 days agoNo license

deepbeepmeep

Wan2GP

Desktop app that runs open video, image and audio models on your own PC

Model tooling
  • Wan 2.1/2.2
  • MiniMax H3
  • LTX-2/2.3/2.5
  • +7
12k GitHub stars+1.3k/30d4 days agoCustom license

Featured on OpenMicroDrama

Do you maintain open-higgsfield? 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/wide-trace-open-higgsfield)

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

Reviewed Oct 13, 2026. Calls itself an alternative to Higgsfield AI, but the repo states no affiliation. Every run spends credits on your own Higgsfield API account. No license file. We write these descriptions ourselves. The repo's own docs are the final word.