open-higgsfield README

The project's README from github.com/wide-trace/open-higgsfield. As one markdown file: README.md.

OpenHiggsfield AI — Open-Source Alternative to Higgsfield AI

The free, open-source alternative to Higgsfield AI. Generate images and videos with 32 models from one prompt bar — no closed ecosystem, no studio subscription.

🌐 Try it Online — No Install Required

Hosted version: openhiggsfield.ai

Image and Video in one studio, in the browser — no Node.js, no setup. Add your platform key (id:secret) to start generating. The studio itself is free.


Why OpenHiggsfield AI instead of Higgsfield AI?


Next.js 16 App Router on Vercel · React 19 · plain CSS · Zustand · pnpm


Features

Generate

State and errors


Architecture

Each generate is one object: { model, prompt, media, settings }.


Getting started

pnpm install
pnpm dev            # http://localhost:3000

Open the studio, press Add key, and paste your platform key as id:secret.

Environment

HF_API_BASE_URL=                      # generation API origin, server only
OPEN_HIGGSFIELD_READ_WRITE_TOKEN=     # Vercel Blob read-write token

Commands

Command What it does
pnpm dev Dev server on port 3000
pnpm build Production build
pnpm start Serve the production build
pnpm brand Rebuild the icons and OG card in public/

Layout

src/
  app/          /  is the full-viewport studio and the only page
                /api/blob issues upload tokens
                base.css owns the document canvas
  generation/   generate requests, server actions, API mapping, catalog, stores
  openhiggsfield/
                the studio surface: composer, gallery, viewer, model picker,
                settings, asset picker, selection bar — and openhiggsfield.css

Design principles

Dark studio ground, a single lime accent #d1fe17, Inter throughout. The chrome stays neutral so the generated work is the only color on the surface.

  1. The tool disappears into the task — expression never obscures state or affordance.
  2. Accent is state, not decoration — selection, primary action, liveness only.
  3. Data is data — settings, counts and durations read in tabular numerals. One typeface throughout; no monospace anywhere.
  4. Motion conveys state — the generation lifecycle, the arrival of a run. Nothing loops decoratively.
  5. Every control ships all its states — hover, focus, active, disabled, loading, error, empty.
  6. The catalog is the source of truth — the studio renders what the model declares, never a parallel hardcoded list.

Built for people who work in long sessions, iterating on prompts, inputs and settings.

open-higgsfield (wide-trace/open-higgsfield)

Searching Database…

Что это?OpenHiggsfield AI — бесплатная self-hosted студия с открытым кодом для генерации изображений и видео через одну строку промпта, с 32 разными ИИ-моделями (8 для картинок, 24 для видео); у каждой своя панель настроек, а результаты попадают в одну общую галерею.
Это фреймворк для разработки или готовое приложение?Это готовое веб-приложение (студия на Next.js), а не библиотека или фреймворк — вы клонируете его, размещаете у себя и используете напрямую как инструмент генерации изображений и видео.
Как его запустить?Используйте стандартные скрипты Next.js: `pnpm dev` поднимает dev-сервер на порту 3000, `pnpm build`/`pnpm start` собирают и запускают production-версию, а можно вообще ничего не устанавливать и воспользоваться хостинг-версией на openhiggsfield.ai.
Нужен ли мой собственный API-ключ для генерации?Да — нужно предоставить собственный ключ платформы генерации в формате id:secret; приложение открывает модальное окно с требованием ввести его, и без него генерация не начнётся.
Есть ли подводные камни с историей и сохранёнными файлами?История генераций хранится только в IndexedDB браузера и ограничена 60 записями (избранное не считается); поскольку URL медиа указывают на CDN самой платформы генерации, старые записи могут отмирать, когда CDN отзывает ссылки.
Отправляются ли моя история или ключ на ваши серверы?История остаётся на клиенте в IndexedDB вашего браузера; введённый ключ платформы хранится только в httpOnly cookie, который устанавливает server action, а браузер никогда не обращается к API генерации напрямую.
Сколько моделей он поддерживает и какие?Всего 32 модели — 8 для изображений и 24 для видео — включая Soul 2, Soul Cinema, варианты Kling 3, Wan, Flux, Ideogram, Recraft, LTX, MiniMax, PixVerse, Grok и Qwen; все ищутся в едином каталоге.
Можно ли повторить прошлую генерацию с теми же настройками?Да, действие 'Reuse' в галерее восстанавливает точную модель, настройки и промпт любого прошлого запуска, так что можно перегенерировать результат, а не вводить всё заново.
Что будет, если я случайно что-то удалю?Удаление можно отменить в течение 6 секунд через панель undo, пока оно не стало окончательным.
Зачем это создавать, если можно просто платить за Higgsfield AI?Чтобы избежать привязки к вендору и платы за подписку — OpenHiggsfield AI бесплатный, self-hosted и использует ваш собственный ключ платформы вместо платной студии из закрытой экосистемы.
Creator
wide-trace
Size
0.5 MB
Stars
4.4K
Updated
CommitSep 17
Age
1mo
Commits · 90 Days