beyondmrk/super-ai-gen

How beyondmrk/super-ai-gen works

super-ai-gen is a guarded CLI pipeline for generating client-specific stills and video clips with Higgsfield. The main workflow is preflight checks and project setup, manifest preparation, dry-run cost estimation, then staged generation with resumable outputs. Separate safeguards enforce client/model and creative constraints. An optional Windows account router selects and validates the correct Higgsfield login. Edges follow README statements or shown source references and calls; several router internals are represented from their module documentation and indexed references rather than full source inspection.

Main entry points: fire.py Generation runner · prefire.py Preflight gate · router.py Account router · accounts.py Login manager

Components 22

Generation pipeline

Preflight gate prefire.py
Preflight marker
Shot manifest manifest_template.json
Generation runner fire.py
Cost estimates fire.py
Generated assets
Resume state

Run safeguards

Client registry clients.example.json
Reference panels panels.py
Cast consistency castlock.py
CLI recovery hf_call.py

Account routing

CLI launcher hf-accounts/router/hfstub.cs
Account router hf-accounts/router/router.py
Login selection hf-accounts/router/hfacct.py
Strict spend checks hf-accounts/router/strict.py
Check stamps hf-accounts/router/stamps.py
Account checker hf-accounts/router/hf_check.py

Account administration

Login manager hf-accounts/router/accounts.py
Router installer hf-accounts/router/install.py

Other components

Operator
Google Drive
Higgsfield CLI

Connections 28

Operator → Preflight gate: starts preflight README.md
Preflight gate → Client registry: reads client README.md
Preflight gate → Google Drive: checks and creates folders README.md
Preflight gate → Higgsfield CLI: checks account and workspace prefire.py
Preflight gate → Preflight marker: writes gate result README.md
Operator → Shot manifest: prepares shots README.md
Operator → Generation runner: runs dry-run or stage README.md
Generation runner → Shot manifest: reads shots README.md
Generation runner → Preflight marker: checks gate result README.md
Generation runner → Client registry: resolves client policy fire.py
Generation runner → Cost estimates: calculates stage cost README.md
Generation runner → Higgsfield CLI: submits generations README.md
Generation runner → Generated assets: writes stills and clips README.md
Generation runner → Resume state: records resumable state README.md
Generation runner → Reference panels: expands references fire.py
Generation runner → Cast consistency: uses cast lint fire.py
Generation runner → CLI recovery: delegates CLI handling fire.py
CLI launcher → Account router: hands off CLI call hf-accounts/router/router.py
Account router → Login selection: selects login hf-accounts/router/router.py
Account router → Strict spend checks: checks strict policy hf-accounts/router/router.py
Strict spend checks → Check stamps: validates spend stamp hf-accounts/router/strict.py
Account checker → Higgsfield CLI: queries account hf-accounts/router/hf_check.py
Account checker → Check stamps: writes passing check hf-accounts/router/hf_check.py
Login manager → Account checker: uses account checks hf-accounts/router/accounts.py
Login manager → Login selection: uses routing registry hf-accounts/router/accounts.py
Login manager → Strict spend checks: uses stamp policy hf-accounts/router/accounts.py
Router installer → Login selection: uses router configuration hf-accounts/router/install.py
Account router → Higgsfield CLI: runs real CLI hf-accounts/router/router.py

Drawn by GitDiagram on November 13, 2026 from the repository's file tree, README and source files. Read as Markdown ·