How thehiggsfieldai/openhiggsfield works
OpenHiggsfield is a self-hostable character-to-film studio. Its main workflow is to choose or upload a character, create a story, review scenes and an estimate, connect provider credentials, render clips, and assemble a film. The graph also preserves the separate beta creative-studio capabilities visible in the source index. Relationships are limited to documented README statements and shown imports or calls; some UI and server behavior is unsampled, so uncertain wiring is omitted.
Main entry points: studio-api.mjs Creative studio API · server.mjs HTTP server · App.tsx Studio app · pipeline.ts Render pipeline
Components 27
Studio experience
- Studio app
apps/story-studio/src/App.tsx - Story creation UI
apps/story-studio/src/components/app/create-form.tsx - Production progress
apps/story-studio/src/components/app/film-production.tsx - Film library
apps/story-studio/src/components/app/films-page.tsx - Provider connections
apps/story-studio/src/components/app/connections-page.tsx
Story production
- Render pipeline
apps/story-studio/src/lib/studio/pipeline.ts - Scene director
apps/story-studio/src/lib/studio/director.ts - Story catalog
apps/story-studio/src/lib/studio/data.ts - fal provider
apps/story-studio/src/lib/studio/fal.ts - Voice tools
apps/story-studio/src/lib/studio/voices.ts - Job records
apps/story-studio/src/lib/studio/store.ts - Story and character API
deploy/story/api.mjs - Film rendering service
deploy/story/films.mjs - MP4 assembly
deploy/story/film-export.mjs
Accounts and media
- HTTP server
deploy/studio/server.mjs - Magic-link auth
deploy/studio/auth.mjs - Account management
deploy/studio/account.mjs - Provider media
deploy/studio/media.mjs
Beta creative tools
- Workspace tools
deploy/beta/workspace-tools.mjs - Creative studio API
deploy/beta/studio-api.mjs - Image generation
deploy/beta/image-studio.mjs - Video model routing
deploy/beta/model-routing.mjs - Model catalog
deploy/beta/models.mjs - Creative treatment
lib/creative-treatment.ts - Research assessment
deploy/beta/research-assessment.mjs - Credential vault
deploy/beta/vault.mjs
Other components
- Studio user
Connections 29
- Studio user → Studio app: uses
README.md - Studio app → Story creation UI: renders
apps/story-studio/src/App.tsx - Studio app → Production progress: renders
apps/story-studio/src/App.tsx - Studio app → Film library: renders
apps/story-studio/src/App.tsx - Studio app → Provider connections: renders
apps/story-studio/src/App.tsx - Studio app → Render pipeline: starts jobs
apps/story-studio/src/App.tsx - Render pipeline → Scene director: requests scenes
apps/story-studio/src/lib/studio/pipeline.ts - Render pipeline → Story catalog: reads catalog
apps/story-studio/src/lib/studio/pipeline.ts - Render pipeline → fal provider: requests generation
apps/story-studio/src/lib/studio/pipeline.ts - Render pipeline → Voice tools: checks voice
apps/story-studio/src/lib/studio/pipeline.ts - Render pipeline → Job records: saves records
apps/story-studio/src/lib/studio/pipeline.ts - Scene director → fal provider: uses provider
apps/story-studio/src/lib/studio/director.ts - Scene director → Story catalog: reads data
apps/story-studio/src/lib/studio/director.ts - HTTP server → Magic-link auth: configures auth
deploy/studio/server.mjs - HTTP server → Account management: creates handler
deploy/studio/server.mjs - HTTP server → Provider media: creates handler
deploy/studio/server.mjs - HTTP server → Story and character API: creates handler
deploy/studio/server.mjs - HTTP server → Film rendering service: creates handler
deploy/studio/server.mjs - Film rendering service → Story and character API: reads characters
deploy/story/films.mjs - Film rendering service → Provider media: resolves media
deploy/story/films.mjs - Film rendering service → MP4 assembly: assembles film
deploy/story/films.mjs - HTTP server → Creative studio API: routes requests
deploy/studio/server.mjs - Creative studio API → Workspace tools: dispatches tools
deploy/beta/studio-api.mjs - Creative studio API → Image generation: dispatches images
deploy/beta/studio-api.mjs - Creative studio API → Video model routing: estimates models
deploy/beta/studio-api.mjs - Video model routing → Model catalog: filters catalog
deploy/beta/model-routing.mjs - Creative studio API → Creative treatment: validates treatment
deploy/beta/studio-api.mjs - Creative studio API → Research assessment: uses assessment
deploy/beta/studio-api.mjs - Creative studio API → Credential vault: uses credentials
deploy/beta/studio-api.mjs