# qinxuedong/gods-workbench architecture

> Architecture diagram of the GitHub repository qinxuedong/gods-workbench, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/qinxuedong/gods-workbench
- Repository: https://github.com/qinxuedong/gods-workbench

## Overview

Gods-Workbench is a local-first creative production and digital-asset workbench for AI creators and multimedia teams. Its principal workflow is to organize work in projects, build canvas or episode workflows, execute and collect generated media, then register, search, review, reuse, and export the results. The graph includes major documented capabilities and supporting runtime layers. Relationships are limited to README statements and the supplied source-index references; several domain implementations were not sampled, so their internal call paths are not asserted.

Main entry points: [`gw/api/app.py`](https://github.com/qinxuedong/gods-workbench/blob/master/gw/api/app.py) (FastAPI Service), [`gw/asset_registry/repository.py`](https://github.com/qinxuedong/gods-workbench/blob/master/gw/asset_registry/repository.py) (Asset Registry), [`gw/projects_hub/service.py`](https://github.com/qinxuedong/gods-workbench/blob/master/gw/projects_hub/service.py) (Projects Hub), [`gw/god_workflow/routes.py`](https://github.com/qinxuedong/gods-workbench/blob/master/gw/god_workflow/routes.py) (Workflow Engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_creation["Creative Planning"]
  node_projects["Projects Hub<br/>[service.py]"]
  node_canvas["God Canvas<br/>[service.py]"]
  node_episodes["Episode Pipeline<br/>[service.py]"]
  node_prompts["Prompt Library<br/>[service.py]"]
end

subgraph group_execution["Workflow Execution"]
  node_workflow["Workflow Engine<br/>[routes.py]"]
  node_video["Video Tasks<br/>[service.py]"]
  node_media["Media Engine<br/>[service.py]"]
end

subgraph group_assets["Asset Lifecycle"]
  node_collection["Asset Collection<br/>[collector.py]"]
  node_registry[("Asset Registry<br/>[repository.py]")]
  node_library["Asset Library<br/>[service.py]"]
  node_review["Asset Review<br/>[service.py]"]
  node_transfer["Asset Transfer<br/>[service.py]"]
end

subgraph group_platform["Platform Services"]
  node_api["FastAPI Service<br/>[app.py]"]
  node_auth["Authentication<br/>[auth.py]"]
  node_workspace["Workspace Context<br/>[service.py]"]
  node_settings["Settings<br/>[service.py]"]
  node_storage[("Local Storage<br/>[storage.py]")]
end

subgraph group_clients["User Interfaces"]
  node_web["Web Workbench<br/>[workbench-shell.js]"]
  node_browser["Browser Extension<br/>[collect-client.js]"]
  node_desktop["Desktop Client<br/>[main.rs]"]
end

node_creator(("Creator"))

node_creator -->|"uses"| node_web
node_creator -->|"uses"| node_desktop
node_web -->|"requests"| node_api
node_browser -.->|"collects via"| node_api
node_desktop -->|"connects to"| node_api
node_api -->|"authenticates"| node_auth
node_api -.->|"serves projects"| node_projects
node_api -->|"serves canvases"| node_canvas
node_api -->|"serves episodes"| node_episodes
node_api -->|"routes workflow"| node_workflow
node_api -->|"routes review"| node_review
node_api -->|"routes transfers"| node_transfer
node_api -->|"builds context"| node_workspace
node_projects -->|"uses context"| node_workspace
node_canvas -->|"uses projects"| node_projects
node_episodes -->|"advances pipeline"| node_workflow
node_workflow -->|"registers outputs"| node_registry
node_workflow -->|"reads configuration"| node_settings
node_video -->|"uses canvas"| node_canvas
node_video -->|"records assets"| node_registry
node_media -->|"uses asset data"| node_registry
node_collection -.->|"indexes assets"| node_registry
node_library -->|"uses registry"| node_registry
node_review -->|"reads asset records"| node_registry
node_transfer -->|"resolves assets"| node_registry
node_registry -->|"persists state"| node_storage
node_projects -->|"persists state"| node_storage
node_settings -->|"persists settings"| node_storage
node_workspace -->|"persists workspace"| node_storage
node_prompts -.->|"supports authoring"| node_canvas

click node_web "https://github.com/qinxuedong/gods-workbench/blob/master/web/js/core/workbench-shell.js"
click node_browser "https://github.com/qinxuedong/gods-workbench/blob/master/clients/browser-extension/src/collect-client.js"
click node_desktop "https://github.com/qinxuedong/gods-workbench/blob/master/clients/desktop/src/main.rs"
click node_api "https://github.com/qinxuedong/gods-workbench/blob/master/gw/api/app.py"
click node_auth "https://github.com/qinxuedong/gods-workbench/blob/master/gw/core/auth.py"
click node_workspace "https://github.com/qinxuedong/gods-workbench/blob/master/gw/workspaces/service.py"
click node_settings "https://github.com/qinxuedong/gods-workbench/blob/master/gw/settings/service.py"
click node_projects "https://github.com/qinxuedong/gods-workbench/blob/master/gw/projects_hub/service.py"
click node_canvas "https://github.com/qinxuedong/gods-workbench/blob/master/gw/god_canvas/service.py"
click node_episodes "https://github.com/qinxuedong/gods-workbench/blob/master/gw/episode_pipeline/service.py"
click node_prompts "https://github.com/qinxuedong/gods-workbench/blob/master/gw/prompt_library/service.py"
click node_workflow "https://github.com/qinxuedong/gods-workbench/blob/master/gw/god_workflow/routes.py"
click node_video "https://github.com/qinxuedong/gods-workbench/blob/master/gw/video_tasks/service.py"
click node_media "https://github.com/qinxuedong/gods-workbench/blob/master/gw/media/service.py"
click node_collection "https://github.com/qinxuedong/gods-workbench/blob/master/gw/asset_registry/collector.py"
click node_registry "https://github.com/qinxuedong/gods-workbench/blob/master/gw/asset_registry/repository.py"
click node_library "https://github.com/qinxuedong/gods-workbench/blob/master/gw/asset_library/service.py"
click node_review "https://github.com/qinxuedong/gods-workbench/blob/master/gw/asset_review/service.py"
click node_transfer "https://github.com/qinxuedong/gods-workbench/blob/master/gw/transfer/service.py"
click node_storage "https://github.com/qinxuedong/gods-workbench/blob/master/gw/core/storage.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_projects,node_canvas,node_episodes,node_prompts toneBlue
class node_workflow,node_video,node_media toneAmber
class node_collection,node_registry,node_library,node_review,node_transfer toneMint
class node_api,node_auth,node_workspace,node_settings,node_storage toneRose
class node_web,node_browser,node_desktop,node_creator toneIndigo
```

## Components

### Creative Planning

- [Projects Hub](https://github.com/qinxuedong/gods-workbench/blob/master/gw/projects_hub/service.py): `gw/projects_hub/service.py`
- [God Canvas](https://github.com/qinxuedong/gods-workbench/blob/master/gw/god_canvas/service.py): `gw/god_canvas/service.py`
- [Episode Pipeline](https://github.com/qinxuedong/gods-workbench/blob/master/gw/episode_pipeline/service.py): `gw/episode_pipeline/service.py`
- [Prompt Library](https://github.com/qinxuedong/gods-workbench/blob/master/gw/prompt_library/service.py): `gw/prompt_library/service.py`

### Workflow Execution

- [Workflow Engine](https://github.com/qinxuedong/gods-workbench/blob/master/gw/god_workflow/routes.py): `gw/god_workflow/routes.py`
- [Video Tasks](https://github.com/qinxuedong/gods-workbench/blob/master/gw/video_tasks/service.py): `gw/video_tasks/service.py`
- [Media Engine](https://github.com/qinxuedong/gods-workbench/blob/master/gw/media/service.py): `gw/media/service.py`

### Asset Lifecycle

- [Asset Collection](https://github.com/qinxuedong/gods-workbench/blob/master/gw/asset_registry/collector.py): `gw/asset_registry/collector.py`
- [Asset Registry](https://github.com/qinxuedong/gods-workbench/blob/master/gw/asset_registry/repository.py): `gw/asset_registry/repository.py`
- [Asset Library](https://github.com/qinxuedong/gods-workbench/blob/master/gw/asset_library/service.py): `gw/asset_library/service.py`
- [Asset Review](https://github.com/qinxuedong/gods-workbench/blob/master/gw/asset_review/service.py): `gw/asset_review/service.py`
- [Asset Transfer](https://github.com/qinxuedong/gods-workbench/blob/master/gw/transfer/service.py): `gw/transfer/service.py`

### Platform Services

- [FastAPI Service](https://github.com/qinxuedong/gods-workbench/blob/master/gw/api/app.py): `gw/api/app.py`
- [Authentication](https://github.com/qinxuedong/gods-workbench/blob/master/gw/core/auth.py): `gw/core/auth.py`
- [Workspace Context](https://github.com/qinxuedong/gods-workbench/blob/master/gw/workspaces/service.py): `gw/workspaces/service.py`
- [Settings](https://github.com/qinxuedong/gods-workbench/blob/master/gw/settings/service.py): `gw/settings/service.py`
- [Local Storage](https://github.com/qinxuedong/gods-workbench/blob/master/gw/core/storage.py): `gw/core/storage.py`

### User Interfaces

- [Web Workbench](https://github.com/qinxuedong/gods-workbench/blob/master/web/js/core/workbench-shell.js): `web/js/core/workbench-shell.js`
- [Browser Extension](https://github.com/qinxuedong/gods-workbench/blob/master/clients/browser-extension/src/collect-client.js): `clients/browser-extension/src/collect-client.js`
- [Desktop Client](https://github.com/qinxuedong/gods-workbench/blob/master/clients/desktop/src/main.rs): `clients/desktop/src/main.rs`

### Other components

- **Creator**

## Connections

- Creator → Web Workbench: uses (evidence: `README.md`)
- Creator → Desktop Client: uses (evidence: `README.md`)
- Web Workbench → FastAPI Service: requests (evidence: `README.md`)
- Browser Extension → FastAPI Service: collects via
- Desktop Client → FastAPI Service: connects to (evidence: `README.md`)
- FastAPI Service → Authentication: authenticates (evidence: `gw/core/auth.py`)
- FastAPI Service → Projects Hub: serves projects
- FastAPI Service → God Canvas: serves canvases (evidence: `gw/god_canvas/service.py`)
- FastAPI Service → Episode Pipeline: serves episodes
- FastAPI Service → Workflow Engine: routes workflow
- FastAPI Service → Asset Review: routes review
- FastAPI Service → Asset Transfer: routes transfers
- FastAPI Service → Workspace Context: builds context
- Projects Hub → Workspace Context: uses context (evidence: `gw/projects_hub/service.py`)
- God Canvas → Projects Hub: uses projects (evidence: `gw/god_canvas/service.py`)
- Episode Pipeline → Workflow Engine: advances pipeline
- Workflow Engine → Asset Registry: registers outputs (evidence: `gw/god_workflow/routes.py`)
- Workflow Engine → Settings: reads configuration (evidence: `gw/god_workflow/routes.py`)
- Video Tasks → God Canvas: uses canvas (evidence: `gw/video_tasks/service.py`)
- Video Tasks → Asset Registry: records assets (evidence: `gw/video_tasks/service.py`)
- Media Engine → Asset Registry: uses asset data
- Asset Collection → Asset Registry: indexes assets
- Asset Library → Asset Registry: uses registry (evidence: `gw/asset_library/service.py`)
- Asset Review → Asset Registry: reads asset records (evidence: `gw/asset_review/repository.py`)
- Asset Transfer → Asset Registry: resolves assets (evidence: `gw/transfer/routes.py`)
- Asset Registry → Local Storage: persists state (evidence: `gw/asset_registry/repository.py`)
- Projects Hub → Local Storage: persists state (evidence: `gw/projects_hub/service.py`)
- Settings → Local Storage: persists settings (evidence: `gw/settings/service.py`)
- Workspace Context → Local Storage: persists workspace (evidence: `gw/workspaces/service.py`)
- Prompt Library → God Canvas: supports authoring
