The free, open-source alternative to Higgsfield AI. Generate AI images and videos using 200+ state-of-the-art models — without the closed ecosystem or subscription fees.

Open Higgsfield AI is an open-source AI image, video, and cinema studio that brings Higgsfield-style creative workflows to everyone. Powered by Muapi.ai, it supports text-to-image, image-to-image, text-to-video, and image-to-video generation across models like Flux, Nano Banana, Midjourney, Kling, Sora, Veo, Seedream, and more — all from a sleek, modern interface you can self-host and customize.

Why Open Higgsfield AI instead of Higgsfield AI?

• Free & open-source — no subscription, no vendor lock-in
• Self-hosted — your data stays on your machine
• 200+ models — text-to-image, image-to-image, text-to-video, image-to-video
• Multi-image input — feed up to 14 reference images into compatible models
• Extensible — add your own models, modify the UI, build on top of it

For a deep dive into the technical architecture and the philosophy behind the "Infinite Budget" cinema workflow, see our comprehensive guide and roadmap.

• Image Studio — Generate images from text prompts (50+ text-to-image models) or transform existing images (55+ image-to-image models). Switches model set automatically based on whether a reference image is provided. Quality and resolution controls visible for models that support them.
• Multi-Image Input — Upload up to 14 reference images for compatible edit models (Nano Banana 2 Edit, Flux Kontext Dev, GPT-4o Edit, and more). Multi-select picker with order badges, batch upload, and a "Use Selected" confirmation flow.
• Video Studio — Generate videos from text prompts (40+ text-to-video models) or animate a start-frame image (60+ image-to-video models). Same intelligent mode switching as Image Studio.
• Cinema Studio — Higgsfield AI-style interface for photorealistic cinematic shots with pro camera controls (Lens, Focal Length, Aperture)
• Upload History — Reference images are uploaded once and stored locally. A picker panel lets you reuse any previously uploaded image across sessions — no re-uploading.
• Smart Controls — Dynamic aspect ratio, resolution/quality, and duration pickers that adapt to each model's capabilities (including t2i models with resolution or quality options)
• Generation History — Browse, revisit, and download all past generations (persisted in browser storage)
• Image & Video Download — One-click download of generated outputs in full resolution
• API Key Management — Secure API key storage in browser localStorage (never sent to any server except Muapi)
• Responsive Design — Works seamlessly on desktop and mobile with dark glassmorphism UI

The Image Studio automatically switches between two model sets:

Models that accept multiple reference images expose a multi-select picker when active:

When a multi-image model is selected the upload trigger switches to multi-select mode:

• Checkboxes with order numbers — images are sent to the model in the order you select them
• Batch upload — pick multiple files at once from your file dialog
• Count badge on the trigger shows how many images are active; a + badge appears when more slots are available
• "Use Selected" button confirms and closes the picker

The Video Studio follows the same pattern:

The Cinema Studio offers precise control over the virtual camera, translating your choices into optimized prompt modifiers:

Every image you upload is saved locally (URL + thumbnail) so you never upload the same file twice:

• Click the upload button to open the reference image picker
• Previously uploaded images appear in a 3-column grid with thumbnails
• Single-image models — click a thumbnail to instantly select and close
• Multi-image models — toggle multiple thumbnails (shown with order numbers), then click Use Selected
• Upload new images with the Upload files button (supports multi-file selection in multi-image mode)
• Remove individual images from history with the ✕ button
• History persists across browser sessions (stored in localStorage)

• Node.js (v18+)
• A Muapi.ai API key

# Clone the repository
git clone https://github.com/Anil-matcha/Open-Higgsfield-AI.git
cd Open-Higgsfield-AI

# Install dependencies
npm install

# Start the development server
npm run dev

Open http://localhost:5173 in your browser. You'll be prompted to enter your Muapi API key on first use.

npm run build
npm run preview

src/
├── components/
│   ├── ImageStudio.js    # Dual-mode t2i/i2i studio with dynamic model switching & multi-image support
│   ├── VideoStudio.js    # Dual-mode t2v/i2v studio with dynamic model switching
│   ├── CinemaStudio.js   # Pro studio with camera controls & infinite canvas flow
│   ├── UploadPicker.js   # Upload button + history panel; single & multi-image select modes
│   ├── CameraControls.js # Scrollable picker for camera/lens/focal/aperture
│   ├── Header.js         # App header with settings and controls
│   ├── AuthModal.js      # API key input modal
│   ├── SettingsModal.js  # Settings panel for API key management
│   └── Sidebar.js        # Navigation sidebar
├── lib/
│   ├── muapi.js          # API client: generateImage, generateVideo, generateI2I, generateI2V, uploadFile
│   ├── models.js         # 200+ model definitions with endpoints, inputs, maxImages, quality/resolution mappings
│   └── uploadHistory.js  # localStorage CRUD + canvas thumbnail generation for upload history
├── styles/
│   ├── global.css        # Global styles and animations
│   ├── studio.css        # Studio-specific styles
│   └── variables.css     # CSS custom properties
├── main.js               # App entry point
└── style.css             # Tailwind imports

The app communicates with Muapi.ai using a two-step pattern:

1. Submit — POST /api/v1/{model-endpoint} with prompt and parameters
2. Poll — GET /api/v1/predictions/{request_id}/result until status is completed

Authentication uses the x-api-key header. During development, a Vite proxy handles CORS by routing /api requests to https://api.muapi.ai.

File uploads use POST /api/v1/upload_file (multipart/form-data) and return a hosted URL that is passed to image-conditioned models. For multi-image models the full images_list array is forwarded to the API in one request.

• Vite — Build tool & dev server
• Tailwind CSS v4 — Utility-first styling
• Vanilla JS — No framework, pure DOM manipulation
• Muapi.ai — AI model API gateway

Higgsfield AI is a proprietary AI video and image generation platform. Open Higgsfield AI is a community-driven, open-source alternative that provides similar creative capabilities without the closed ecosystem:

MIT

Built with Muapi.ai — the unified API for AI image and video generation models.

Deep Dive: For more details on the "AI Influencer" engine, upcoming "Popcorn" storyboarding features, and the future of this project, read the full technical overview.

Looking for a free Higgsfield AI alternative? Open Higgsfield AI is an open-source AI image and video generation studio and Higgsfield AI replacement that you can self-host, customize, and extend.