# sunnychase/open-higgsfield-ai architecture

> Architecture diagram of the GitHub repository sunnychase/open-higgsfield-ai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sunnychase/open-higgsfield-ai
- Repository: https://github.com/sunnychase/open-higgsfield-ai

## Overview

Open Higgsfield AI is a browser-based image, video, and cinematic image-generation studio that sends generation requests to Muapi.ai. The user enters a prompt, chooses a model and supported output settings, and receives results to view, revisit, or download; Cinema Studio also converts camera choices into prompt modifiers. The README documents browser-persisted generation history and API-key management. Source excerpts support the main routing, studio, prompt, and API-client links; finer details of settings and history implementation were not sampled.

Main entry points: [`src/components/CinemaStudio.js`](https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/components/CinemaStudio.js) (Cinema Studio), [`src/lib/muapi.js`](https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/lib/muapi.js) (Muapi client), [`src/main.js`](https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/main.js) (App router), [`src/components/ImageStudio.js`](https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/components/ImageStudio.js) (Image Studio)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_main["App router<br/>[main.js]"]
  node_header["Header navigation<br/>[Header.js]"]
  node_sidebar["Studio sidebar<br/>[Sidebar.js]"]
  node_settings["Settings panel<br/>[SettingsModal.js]"]
  node_auth["API key dialog<br/>[AuthModal.js]"]
end

subgraph group_studios["Creative studios"]
  node_image["Image Studio<br/>[ImageStudio.js]"]
  node_cinema["Cinema Studio<br/>[CinemaStudio.js]"]
  node_video["Video Studio<br/>[VideoStudio.js]"]
  node_camera["Camera controls<br/>[CameraControls.js]"]
end

subgraph group_generation["Generation services"]
  node_models["Model catalog<br/>[models.js]"]
  node_prompt["Cinema prompt builder<br/>[promptUtils.js]"]
  node_client["Muapi client<br/>[muapi.js]"]
end

subgraph group_browser["Browser state"]
  node_storage[("Browser localStorage")]
end

node_user(("Studio user"))
node_muapi{{"Muapi.ai API"}}

node_user -->|"navigates"| node_header
node_main -->|"creates"| node_header
node_main -->|"routes to"| node_image
node_main -->|"routes to"| node_cinema
node_main -->|"routes to"| node_video
node_header -->|"dispatches navigation"| node_main
node_main -->|"opens settings"| node_settings
node_user -->|"creates image"| node_image
node_user -->|"creates shot"| node_cinema
node_user -->|"creates video"| node_video
node_cinema -->|"reads selections"| node_camera
node_cinema -->|"builds prompt"| node_prompt
node_image -->|"reads options"| node_models
node_video -->|"reads options"| node_models
node_client -->|"resolves endpoints"| node_models
node_image -->|"submits generation"| node_client
node_cinema -->|"submits generation"| node_client
node_video -->|"submits generation"| node_client
node_client -->|"submits and polls"| node_muapi
node_muapi -->|"returns results"| node_client
node_image -->|"requests key"| node_auth
node_cinema -->|"requests key"| node_auth
node_video -->|"requests key"| node_auth
node_auth -->|"saves API key"| node_storage
node_settings -->|"manages API key"| node_storage
node_client -->|"reads API key"| node_storage
node_image -->|"persists history"| node_storage
node_cinema -->|"persists history"| node_storage
node_video -->|"persists history"| node_storage
node_user -->|"browses studio"| node_sidebar

click node_main "https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/main.js"
click node_header "https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/components/Header.js"
click node_sidebar "https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/components/Sidebar.js"
click node_settings "https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/components/SettingsModal.js"
click node_image "https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/components/ImageStudio.js"
click node_cinema "https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/components/CinemaStudio.js"
click node_video "https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/components/VideoStudio.js"
click node_camera "https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/components/CameraControls.js"
click node_auth "https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/components/AuthModal.js"
click node_models "https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/lib/models.js"
click node_prompt "https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/lib/promptUtils.js"
click node_client "https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/lib/muapi.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_header,node_sidebar,node_settings,node_auth,node_user toneBlue
class node_image,node_cinema,node_video,node_camera toneAmber
class node_models,node_prompt,node_client,node_muapi toneMint
class node_storage toneRose
```

## Components

### Application shell

- [App router](https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/main.js): `src/main.js`
- [Header navigation](https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/components/Header.js): `src/components/Header.js`
- [Studio sidebar](https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/components/Sidebar.js): `src/components/Sidebar.js`
- [Settings panel](https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/components/SettingsModal.js): `src/components/SettingsModal.js`
- [API key dialog](https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/components/AuthModal.js): `src/components/AuthModal.js`

### Creative studios

- [Image Studio](https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/components/ImageStudio.js): `src/components/ImageStudio.js`
- [Cinema Studio](https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/components/CinemaStudio.js): `src/components/CinemaStudio.js`
- [Video Studio](https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/components/VideoStudio.js): `src/components/VideoStudio.js`
- [Camera controls](https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/components/CameraControls.js): `src/components/CameraControls.js`

### Generation services

- [Model catalog](https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/lib/models.js): `src/lib/models.js`
- [Cinema prompt builder](https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/lib/promptUtils.js): `src/lib/promptUtils.js`
- [Muapi client](https://github.com/sunnychase/open-higgsfield-ai/blob/main/src/lib/muapi.js): `src/lib/muapi.js`

### Browser state

- **Browser localStorage**

### Other components

- **Studio user**
- **Muapi.ai API**

## Connections

- Studio user → Header navigation: navigates
- App router → Header navigation: creates
- App router → Image Studio: routes to
- App router → Cinema Studio: routes to
- App router → Video Studio: routes to
- Header navigation → App router: dispatches navigation
- App router → Settings panel: opens settings
- Studio user → Image Studio: creates image
- Studio user → Cinema Studio: creates shot
- Studio user → Video Studio: creates video
- Cinema Studio → Camera controls: reads selections
- Cinema Studio → Cinema prompt builder: builds prompt
- Image Studio → Model catalog: reads options
- Video Studio → Model catalog: reads options
- Muapi client → Model catalog: resolves endpoints
- Image Studio → Muapi client: submits generation
- Cinema Studio → Muapi client: submits generation
- Video Studio → Muapi client: submits generation
- Muapi client → Muapi.ai API: submits and polls
- Muapi.ai API → Muapi client: returns results
- Image Studio → API key dialog: requests key
- Cinema Studio → API key dialog: requests key
- Video Studio → API key dialog: requests key
- API key dialog → Browser localStorage: saves API key
- Settings panel → Browser localStorage: manages API key
- Muapi client → Browser localStorage: reads API key
- Image Studio → Browser localStorage: persists history
- Cinema Studio → Browser localStorage: persists history
- Video Studio → Browser localStorage: persists history
- Studio user → Studio sidebar: browses studio
