How anuar234/higgsapi works
Higgsapi is a browser-based video editor centered on regenerating footage at a clip boundary, with AI editing, an in-editor tool-using agent, project/profile features, and local-backend generation services. The primary workflow is to select a timeline clip, prepare neighboring footage and boundary frames, write and review a prompt, generate a replacement, and place it in the same timeline position. The graph uses README-described relationships where implementation excerpts are unavailable; those links are cited to the README rather than presented as inspected source calls.
Main entry points: server.mjs Backend API · editor.tsx Editor page · qwen-agent.ts Editor tool loop · regenerate.ts Clip regeneration
Components 20
Browser editor
- Editor page
apps/web/src/pages/editor.tsx - Timeline engine
apps/web/src/engine/timeline/controller.ts - Editor engine
apps/web/src/engine/create-engine.ts - Scene renderer
packages/runtime/src/systems/render.ts - Media encoder
packages/encoder/src/encoder.ts
AI generation
- Clip regeneration
apps/web/src/engine/regenerate.ts - AI edit planning
apps/web/src/engine/ai-edit/plan.ts - Generation controls
apps/web/src/components/genai/use-generate-video.tsx
Agent tools
- Agent chat
apps/web/src/agent-chat/chat-panel.tsx - Editor tool loop
apps/web/src/engine/qwen-agent.ts - MCP services
local-backend/mcp.mjs
Local services
- Backend API
local-backend/server.mjs - Prompt writer
local-backend/prompt-ai.mjs - Generation provider
local-backend/higgsfield.mjs - Media storage
local-backend/storage.mjs
Projects and profiles
- Project services
local-backend/projects.mjs - Reference profiles
local-backend/profiles.mjs - Profile showcase
local-backend/profiles-vitrina.mjs - Supabase auth
local-backend/supabase-auth.mjs
Other components
- Editor user
Connections 25
- Editor user → Editor page: opens
README.md - Editor page → Timeline engine: edits clips
- Editor page → Editor engine: drives
- Editor engine → Scene renderer: renders scenes
apps/web/src/engine/create-engine.ts - Timeline engine → Clip regeneration: starts regeneration
- Clip regeneration → Generation controls: prepares prompt
- Clip regeneration → Backend API: requests generation
README.md - Backend API → Prompt writer: writes prompts
local-backend/server.mjs - Backend API → Generation provider: runs jobs
local-backend/server.mjs - Backend API → Media storage: stores media
local-backend/server.mjs - Backend API → Project services: reads project files
local-backend/server.mjs - Editor user → AI edit planning: requests shot edits
README.md - AI edit planning → Generation controls: configures takes
- Generation controls → Backend API: starts generation
- Editor user → Agent chat: opens chat
README.md - Agent chat → Editor tool loop: sends instructions
- Editor tool loop → Editor engine: issues editor commands
README.md - Editor tool loop → Backend API: requests model turns
README.md - Editor tool loop → MCP services: uses connected tools
- Editor user → Project services: manages projects
README.md - Editor user → Reference profiles: manages references
README.md - Reference profiles → Media storage: stores profile media
- Editor user → Profile showcase: shares profiles
README.md - Backend API → Supabase auth: authenticates requests
local-backend/server.mjs - Editor page → Media encoder: exports media
README.md