# anubhabmondal496-coder/sketchforge architecture

> Architecture diagram of the GitHub repository anubhabmondal496-coder/sketchforge, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/anubhabmondal496-coder/sketchforge
- Repository: https://github.com/anubhabmondal496-coder/sketchforge

## Overview

SketchForge turns a user sketch or reference photo and description into an inspectable 3D model. The main workflow runs from the workbench UI through API submission and an asynchronous job: image preparation, Gemma scene understanding, optional asset search/import, and TripoSR reconstruction. Users can inspect and export the resulting GLB, or refine the scene and generate another version. The graph includes the documented asset-search and photo paths; unsampled route and UI internals are represented only where README or source-index evidence supports them.

Main entry points: [`frontend/src/pages/Home.tsx`](https://github.com/anubhabmondal496-coder/sketchforge/blob/main/frontend/src/pages/Home.tsx) (Workbench), [`backend/app/services/job_service.py`](https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/services/job_service.py) (Job orchestrator), [`frontend/src/services/api.ts`](https://github.com/anubhabmondal496-coder/sketchforge/blob/main/frontend/src/services/api.ts) (API client), [`backend/app/services/asset_search_service.py`](https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/services/asset_search_service.py) (Asset search and ranking)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Workbench client"]
  node_home["Workbench<br/>[Home.tsx]"]
  node_canvas["Sketch canvas<br/>[SketchCanvas.tsx]"]
  node_photo["Photo input<br/>[PhotoUpload.tsx]"]
  node_refineui["Refinement input"]
  node_clientapi["API client<br/>[api.ts]"]
  node_viewer["3D viewer<br/>[ModelViewer.tsx]"]
  node_sceneui["Scene and asset panels<br/>[SceneSpecPanel.tsx]"]
end

subgraph group_api["API and jobs"]
  node_server["FastAPI app<br/>[main.py]"]
  node_generateapi["Generation route<br/>[generate.py]"]
  node_refineapi["Refinement route<br/>[refine.py]"]
  node_analyzeapi["Analysis route<br/>[analyze.py]"]
  node_assetsapi["Asset routes<br/>[assets.py]"]
  node_jobs["Job orchestrator<br/>[job_service.py]"]
end

subgraph group_understanding["Image understanding"]
  node_image["Image preparation<br/>[image_service.py]"]
  node_imageutils["Image processing"]
  node_gemma["Gemma reasoning<br/>[gemma_service.py]"]
  node_scenespec["SceneSpec schema<br/>[scene_spec.py]"]
end

subgraph group_geometry["Geometry and assets"]
  node_tripo["TripoSR reconstruction<br/>[tripo_service.py]"]
  node_assetsearch["Asset search and ranking"]
  node_providers["Search providers<br/>[base_provider.py]"]
  node_assetdownload["Asset download and cache"]
  node_assetcatalog[("External asset catalogs")]
end

node_user(("User"))

node_user -->|"uses"| node_home
node_home -->|"captures sketch"| node_canvas
node_home -->|"accepts photo"| node_photo
node_home -->|"requests refinement"| node_refineui
node_home -->|"submits and polls"| node_clientapi
node_home -->|"presents model"| node_viewer
node_home -->|"shows scene details"| node_sceneui
node_clientapi -->|"submits generation"| node_generateapi
node_clientapi -->|"submits refinement"| node_refineapi
node_clientapi -.->|"requests analysis"| node_analyzeapi
node_server -->|"registers route"| node_generateapi
node_server -->|"registers route"| node_refineapi
node_server -->|"registers route"| node_analyzeapi
node_server -->|"registers route"| node_assetsapi
node_generateapi -->|"starts job"| node_jobs
node_refineapi -->|"starts job"| node_jobs
node_analyzeapi -->|"prepares input"| node_image
node_analyzeapi -->|"requests analysis"| node_gemma
node_assetsapi -->|"searches assets"| node_assetsearch
node_assetsapi -->|"imports asset"| node_assetdownload
node_jobs -->|"prepares input"| node_image
node_image -->|"preprocesses image"| node_imageutils
node_jobs -->|"analyzes input"| node_gemma
node_gemma -->|"produces scene spec"| node_scenespec
node_jobs -->|"searches candidates"| node_assetsearch
node_assetsearch -->|"queries providers"| node_providers
node_providers -.->|"searches catalogs"| node_assetcatalog
node_assetsearch -->|"ranks results"| node_assetsearch
node_jobs -->|"downloads match"| node_assetdownload
node_jobs -->|"generates mesh"| node_tripo
node_viewer -->|"loads model"| node_clientapi
node_viewer -->|"exports GLB"| node_user
node_refineui -->|"sends refinement"| node_clientapi

click node_home "https://github.com/anubhabmondal496-coder/sketchforge/blob/main/frontend/src/pages/Home.tsx"
click node_canvas "https://github.com/anubhabmondal496-coder/sketchforge/blob/main/frontend/src/components/SketchCanvas.tsx"
click node_photo "https://github.com/anubhabmondal496-coder/sketchforge/blob/main/frontend/src/components/PhotoUpload.tsx"
click node_refineui "https://github.com/anubhabmondal496-coder/sketchforge/blob/main/frontend/src/components/RefinementInput.tsx"
click node_clientapi "https://github.com/anubhabmondal496-coder/sketchforge/blob/main/frontend/src/services/api.ts"
click node_viewer "https://github.com/anubhabmondal496-coder/sketchforge/blob/main/frontend/src/components/ModelViewer.tsx"
click node_sceneui "https://github.com/anubhabmondal496-coder/sketchforge/blob/main/frontend/src/components/SceneSpecPanel.tsx"
click node_server "https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/main.py"
click node_generateapi "https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/api/generate.py"
click node_refineapi "https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/api/refine.py"
click node_analyzeapi "https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/api/analyze.py"
click node_assetsapi "https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/api/assets.py"
click node_jobs "https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/services/job_service.py"
click node_image "https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/services/image_service.py"
click node_imageutils "https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/utils/image_processing.py"
click node_gemma "https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/services/gemma_service.py"
click node_scenespec "https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/models/scene_spec.py"
click node_tripo "https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/services/tripo_service.py"
click node_assetsearch "https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/services/asset_search_service.py"
click node_providers "https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/services/providers/base_provider.py"
click node_assetdownload "https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/services/asset_download_service.py"

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_home,node_canvas,node_photo,node_refineui,node_clientapi,node_viewer,node_sceneui,node_user toneBlue
class node_server,node_generateapi,node_refineapi,node_analyzeapi,node_assetsapi,node_jobs toneAmber
class node_image,node_imageutils,node_gemma,node_scenespec toneMint
class node_tripo,node_assetsearch,node_providers,node_assetdownload,node_assetcatalog toneRose
```

## Components

### Workbench client

- [Workbench](https://github.com/anubhabmondal496-coder/sketchforge/blob/main/frontend/src/pages/Home.tsx): `frontend/src/pages/Home.tsx`
- [Sketch canvas](https://github.com/anubhabmondal496-coder/sketchforge/blob/main/frontend/src/components/SketchCanvas.tsx): `frontend/src/components/SketchCanvas.tsx`
- [Photo input](https://github.com/anubhabmondal496-coder/sketchforge/blob/main/frontend/src/components/PhotoUpload.tsx): `frontend/src/components/PhotoUpload.tsx`
- [Refinement input](https://github.com/anubhabmondal496-coder/sketchforge/blob/main/frontend/src/components/RefinementInput.tsx): `frontend/src/components/RefinementInput.tsx`
- [API client](https://github.com/anubhabmondal496-coder/sketchforge/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`
- [3D viewer](https://github.com/anubhabmondal496-coder/sketchforge/blob/main/frontend/src/components/ModelViewer.tsx): `frontend/src/components/ModelViewer.tsx`
- [Scene and asset panels](https://github.com/anubhabmondal496-coder/sketchforge/blob/main/frontend/src/components/SceneSpecPanel.tsx): `frontend/src/components/SceneSpecPanel.tsx`

### API and jobs

- [FastAPI app](https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/main.py): `backend/app/main.py`
- [Generation route](https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/api/generate.py): `backend/app/api/generate.py`
- [Refinement route](https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/api/refine.py): `backend/app/api/refine.py`
- [Analysis route](https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/api/analyze.py): `backend/app/api/analyze.py`
- [Asset routes](https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/api/assets.py): `backend/app/api/assets.py`
- [Job orchestrator](https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/services/job_service.py): `backend/app/services/job_service.py`

### Image understanding

- [Image preparation](https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/services/image_service.py): `backend/app/services/image_service.py`
- [Image processing](https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/utils/image_processing.py): `backend/app/utils/image_processing.py`
- [Gemma reasoning](https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/services/gemma_service.py): `backend/app/services/gemma_service.py`
- [SceneSpec schema](https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/models/scene_spec.py): `backend/app/models/scene_spec.py`

### Geometry and assets

- [TripoSR reconstruction](https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/services/tripo_service.py): `backend/app/services/tripo_service.py`
- [Asset search and ranking](https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/services/asset_search_service.py): `backend/app/services/asset_search_service.py`
- [Search providers](https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/services/providers/base_provider.py): `backend/app/services/providers/base_provider.py`
- [Asset download and cache](https://github.com/anubhabmondal496-coder/sketchforge/blob/main/backend/app/services/asset_download_service.py): `backend/app/services/asset_download_service.py`
- **External asset catalogs**

### Other components

- **User**

## Connections

- User → Workbench: uses
- Workbench → Sketch canvas: captures sketch (evidence: `frontend/src/pages/Home.tsx`)
- Workbench → Photo input: accepts photo (evidence: `frontend/src/pages/Home.tsx`)
- Workbench → Refinement input: requests refinement (evidence: `frontend/src/pages/Home.tsx`)
- Workbench → API client: submits and polls (evidence: `frontend/src/pages/Home.tsx`)
- Workbench → 3D viewer: presents model (evidence: `frontend/src/pages/Home.tsx`)
- Workbench → Scene and asset panels: shows scene details (evidence: `frontend/src/pages/Home.tsx`)
- API client → Generation route: submits generation
- API client → Refinement route: submits refinement
- API client → Analysis route: requests analysis
- FastAPI app → Generation route: registers route (evidence: `backend/app/main.py`)
- FastAPI app → Refinement route: registers route (evidence: `backend/app/main.py`)
- FastAPI app → Analysis route: registers route (evidence: `backend/app/main.py`)
- FastAPI app → Asset routes: registers route (evidence: `backend/app/main.py`)
- Generation route → Job orchestrator: starts job (evidence: `backend/app/api/generate.py`)
- Refinement route → Job orchestrator: starts job (evidence: `backend/app/api/refine.py`)
- Analysis route → Image preparation: prepares input (evidence: `backend/app/api/analyze.py`)
- Analysis route → Gemma reasoning: requests analysis (evidence: `backend/app/api/analyze.py`)
- Asset routes → Asset search and ranking: searches assets (evidence: `backend/app/api/assets.py`)
- Asset routes → Asset download and cache: imports asset (evidence: `backend/app/api/assets.py`)
- Job orchestrator → Image preparation: prepares input (evidence: `backend/app/services/job_service.py`)
- Image preparation → Image processing: preprocesses image (evidence: `backend/app/services/image_service.py`)
- Job orchestrator → Gemma reasoning: analyzes input (evidence: `backend/app/services/job_service.py`)
- Gemma reasoning → SceneSpec schema: produces scene spec (evidence: `backend/app/services/gemma_service.py`)
- Job orchestrator → Asset search and ranking: searches candidates (evidence: `backend/app/services/job_service.py`)
- Asset search and ranking → Search providers: queries providers (evidence: `backend/app/services/asset_search_service.py`)
- Search providers → External asset catalogs: searches catalogs
- Asset search and ranking → Asset search and ranking: ranks results (evidence: `backend/app/services/asset_search_service.py`)
- Job orchestrator → Asset download and cache: downloads match (evidence: `backend/app/services/job_service.py`)
- Job orchestrator → TripoSR reconstruction: generates mesh (evidence: `backend/app/services/job_service.py`)
- 3D viewer → API client: loads model
- 3D viewer → User: exports GLB
- Refinement input → API client: sends refinement
