Open-source Higgsfield. Bring your own video-model keys — get the cinematic preset library, character consistency, an AI director, and a desktop app for free.
Higgsfield is really four things: (1) a router that resells Seedance / Kling / Veo / Wan behind one subscription, (2) a paywalled library of "camera control" presets that is just prompt engineering, (3) Soul ID character consistency, and (4) Hermes, an agent that orchestrates the whole pipeline. openfield gives you all four with your own keys and no markup.
You already pay ByteDance / fal / Replicate for the actual model. Higgsfield charges you again for the buttons on top. The buttons are prompt templates. They live in src/presets/ — MIT, readable, extend them.
npm install && npm run build
cp .env.example .env # add ONE key to start (FAL_KEY is highest leverage)Node ≥ 20.
- OpenRouter —
OPENROUTER_API_KEY=…runs the real Nous Hermes 3 (free tier). - Your existing agent (no API key) — already signed into Claude Code or
Codex? Set
OPENFIELD_LLM_BACKEND=claude(orcodex) and openfield drives the Director through your local agent login. No key at all.
openfield models # models + which key reaches each
openfield presets [query] # the free preset library (47+)
openfield compose --subject "a lone samurai in the rain" --presets dolly-in,orbit
openfield generate --subject "..." --model seedance-2.0 --presets orbit --wait
openfield soul add nova --name "Nova" --ref <img-url> --traits "red bob, freckles"
openfield generate --subject "..." --character nova --presets tracking --wait
openfield auto "a moody 3-shot ad for a coffee brand" --model wan-2.2 --wait
openfield ui # local web app (mac + windows + linux)compose and auto --dry make no API call — inspect before you spend credits.
npm run build && openfield ui # → http://localhost:4317
# or the native Electron app:
cd app && npm install && npm startTabs: Studio · Presets · Soul ID · Director. See docs/desktop.md.
Point your MCP client at openfield-mcp. Tools: list_presets, list_models,
compose_prompt, generate_video, check_status, list_characters,
save_character, direct_video. See docs/mcp.md.
subject + presets ──▶ compose() ──▶ router ──▶ provider adapter ──▶ backend model
+ Soul ID (free IP) (pick by (BYOK) (Seedance/Kling/
+ Director key) Veo/Wan/...)
- Providers (
src/providers/) —fal,replicate,custom(self-host). Each reads its own key; openfield never proxies it. - Catalog (
src/providers/catalog.ts) — model id ➜ multiple provider routes; first configured key wins. - Presets (
src/presets/) — 47+ camera / lens / lighting / style / vfx fragments. Stackable, model-agnostic. - Soul ID (
src/soul.ts) — character store + reference threading. docs. - Orchestrator (
src/orchestrator/) — LLM director, brief ➜ storyboard ➜ shots. docs. - Server + UI (
src/server.ts,src/ui/) — zero-dep local app.
- BYOK provider router (fal, Replicate, self-host) + 11-model catalog
- 61 presets across 7 categories (camera, lens, lighting, style, vfx, mood, transition)
- Cinema Studio — camera body / lens / focal / aperture / shot / angle (docs)
- Recipes — one-click template gallery (docs)
- Prompt composer with stacking +
{subject}resolution - Cinema Studio workflow — Projects · Elements/@handle registry (versions, lock, variants, schematics) · full Shotlist Director · Takes economy · Assembly + FCPXML/MP4 export. Real reference-image attachment. (docs)
- Prompt-first Studio: generation bar with Genre/Style/Camera/Character/Location pills, @-mentions, Image/Video, aspect/res/duration/batch/audio, hero + gallery
- Soul ID character consistency + Locations (consistent settings,
@-mentioned) - Operations: image start-frames, upscale, lipsync, video-to-video restyle (docs)
- Video stitching (ffmpeg) for multi-shot exports
- Director: the real Nous Hermes 3 in a multi-tool agent loop (docs)
- MCP server
- Cross-platform app (local web + Electron for mac/win)
- More provider adapters (direct Volcengine, ComfyUI recipes)
New presets and provider adapters are the easiest, highest-value PRs. See CONTRIBUTING.md.
MIT.