How weewrr/meshforge works
MeshForge is a local-first Electron desktop application for building node workflows that turn images and prompts into 3D meshes. Users edit and run graphs, watch generation progress, preview results, then export meshes or add them to the scene. The renderer’s workflow engine calls the authenticated FastAPI backend, which schedules jobs and dispatches generator implementations. Separate product branches support workflow persistence, model and extension management, mesh processing, settings, diagnostics, and agent-assisted workflows. The README documents the main process boundaries; some backend and UI links are documented rather than verified from sampled implementation.
Main entry points: main.py FastAPI App · App.tsx Renderer App · engine.ts Run Engine · GeneratePage.tsx Generate Page
Components 24
Desktop Shell
- Renderer App
src/App.tsx - Electron Main
electron/main/index.ts - Preload Bridge
electron/preload/index.ts
Workflow Authoring
- Workflow Canvas
src/pages/workflows/canvas/index.tsx - Workflow Library
src/stores/workflows/storage.ts - Run Engine
src/stores/workflowRun/engine.ts - Engine Context
src/stores/workflowRun/engine-context.ts - Workflow API
src/api/workflows.ts
Generation Runtime
- Generate Page
src/pages/GeneratePage.tsx - 3D Viewer
src/components/Viewer3D.tsx - API Client
src/api/http.ts
Models And Settings
- Models Page
src/pages/ModelsPage.tsx - Extension Routes
server/routers/extensions.py - Model Routes
server/routers/model.py - Settings Page
src/pages/settings/index.tsx - Agent Routes
server/routers/agent.py - MCP Server
server/mcp_server.py
Backend Services
- FastAPI App
server/main.py - Generation Routes
server/routers/generate.py - Job Persistence
server/jobstore.py - Generator Registry
server/generators/registry.py - Built-in Generators
server/generators - Mesh Processing
server/routers/process.py
Other components
- Desktop User
Connections 28
- Desktop User → Renderer App: uses
- Renderer App → Workflow Canvas: routes to
src/App.tsx - Renderer App → Generate Page: routes to
src/App.tsx - Renderer App → Models Page: routes to
src/App.tsx - Renderer App → Settings Page: routes to
src/App.tsx - Workflow Canvas → Workflow Library: edits
- Workflow Canvas → Run Engine: starts run
- Run Engine → Engine Context: shares context
src/stores/workflowRun/engine.ts - Run Engine → API Client: polls jobs
src/stores/workflowRun/engine.ts - Run Engine → Workflow API: runs workflows
- Run Engine → Generate Page: returns progress
- Generate Page → 3D Viewer: previews mesh
- Generate Page → API Client: requests services
- Electron Main → Preload Bridge: exposes IPC
electron/main/index.ts - Electron Main → FastAPI App: spawns backend
- API Client → FastAPI App: sends requests
- FastAPI App → Generation Routes: registers routes
server/main.py - FastAPI App → Extension Routes: registers routes
server/main.py - FastAPI App → Model Routes: registers routes
server/main.py - FastAPI App → Agent Routes: registers routes
server/main.py - Generation Routes → Job Persistence: queues jobs
- Generation Routes → Generator Registry: dispatches generation
- Generator Registry → Built-in Generators: registers generators
server/generators/registry.py - Models Page → Extension Routes: manages extensions
- Models Page → Model Routes: manages models
- Generate Page → Mesh Processing: processes meshes
- Settings Page → API Client: reads runtime info
- MCP Server → FastAPI App: uses local API