# blenderkit/blenderkit_asset_tasks architecture

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

- Interactive diagram: https://gitdiagram.com/blenderkit/blenderkit_asset_tasks
- Repository: https://github.com/blenderkit/blenderkit_asset_tasks

## Overview

This repository automates BlenderKit asset processing: scripts select assets from the server, download them, run task-specific Blender background work, and in applicable jobs upload results or update metadata. The principal orchestrated route is `process_asset.py`, while standalone scripts cover additional conversions, rendering, validation, captions, reindexing, and library synchronization. Shared server utilities provide search, transfer, Blender dispatch, concurrency, and validation. Edges are limited to README statements and SOURCE INDEX references; unsampled task implementations are represented without inferred internal call chains.

Main entry points: [`process_asset.py`](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/process_asset.py) (Process assets), [`generate_gltf.py`](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/generate_gltf.py) (GLTF conversion), [`generate_resolutions.py`](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/generate_resolutions.py) (Resolution variants), [`blenderkit_server_utils/search.py`](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blenderkit_server_utils/search.py) (Asset search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Asset orchestration"]
  node_process["Process assets<br/>[process_asset.py]"]
end

subgraph group_blender_tasks["Blender processing"]
  node_gltf_job["GLTF conversion<br/>[generate_gltf.py]"]
  node_gltf_worker["GLTF Blender task<br/>[gltf_bg_blender.py]"]
  node_resolution_job["Resolution variants"]
  node_resolution_worker["Resolution Blender task"]
  node_proxy_job["Proxy generation"]
  node_proxy_worker["Proxy Blender task<br/>[generate.py]"]
  node_thumbnail_job["Thumbnail rendering"]
  node_thumbnail_worker["Thumbnail Blender task"]
end

subgraph group_metadata_tasks["Metadata and review"]
  node_validation_job["Asset validation"]
  node_validation_worker["Validation rendering"]
  node_field_validation["Field validation<br/>[validate_fields.py]"]
  node_ai_validation["AI field checks<br/>[ai_validation.py]"]
  node_manufacturer["Manufacturer tags"]
  node_caption_gpt["GPT captions"]
  node_caption_clip["CLIP captions"]
  node_reindex["Asset reindexing<br/>[reindex.py]"]
  node_twinbru["TwinBru sync"]
end

subgraph group_shared_runtime["Shared runtime"]
  node_search["Asset search<br/>[search.py]"]
  node_download["Asset download<br/>[download.py]"]
  node_dispatch["Blender dispatch<br/>[send_to_bg.py]"]
  node_upload["Result upload<br/>[upload.py]"]
  node_storage["Cloud storage"]
  node_concurrency["Concurrent workers<br/>[concurrency.py]"]
  node_config["Runtime configuration<br/>[config.py]"]
  node_paths["Asset paths<br/>[paths.py]"]
  node_image_utils["Image processing<br/>[image_utils.py]"]
  node_node_graph["Node graph rendering"]
end

node_operator(("Task operator"))
node_asset_server[("BlenderKit server")]

node_operator -->|"starts processing"| node_process
node_process -->|"searches assets"| node_search
node_process -->|"runs applicable jobs"| node_gltf_job
node_process -->|"runs applicable jobs"| node_resolution_job
node_process -->|"downloads assets"| node_download
node_process -->|"dispatches Blender"| node_dispatch
node_process -->|"reuploads marked blend"| node_upload
node_gltf_job -->|"uses search"| node_search
node_gltf_job -->|"downloads assets"| node_download
node_gltf_job -->|"launches Blender"| node_dispatch
node_gltf_job -->|"uploads output"| node_upload
node_gltf_job -->|"runs background task"| node_gltf_worker
node_resolution_job -->|"uses search"| node_search
node_resolution_job -->|"downloads assets"| node_download
node_resolution_job -->|"launches Blender"| node_dispatch
node_resolution_job -->|"uploads output"| node_upload
node_resolution_job -->|"runs background task"| node_resolution_worker
node_proxy_job -->|"runs background task"| node_proxy_worker
node_thumbnail_job -->|"uses search"| node_search
node_thumbnail_job -->|"downloads assets"| node_download
node_thumbnail_job -->|"launches Blender"| node_dispatch
node_thumbnail_job -->|"uploads output"| node_upload
node_thumbnail_job -->|"runs background task"| node_thumbnail_worker
node_validation_job -->|"uses search"| node_search
node_validation_job -->|"downloads assets"| node_download
node_validation_job -->|"launches Blender"| node_dispatch
node_validation_job -->|"uses storage"| node_storage
node_validation_job -->|"runs background task"| node_validation_worker
node_manufacturer -->|"uses field validation"| node_field_validation
node_field_validation -->|"calls AI checks"| node_ai_validation
node_manufacturer -->|"uses search"| node_search
node_manufacturer -->|"updates metadata"| node_upload
node_twinbru -->|"uses search"| node_search
node_twinbru -->|"launches Blender"| node_dispatch
node_twinbru -->|"uploads assets"| node_upload
node_search -->|"queries"| node_asset_server
node_download -->|"downloads from"| node_asset_server
node_upload -->|"uploads to"| node_asset_server
node_dispatch -->|"reads settings"| node_config
node_download -->|"resolves paths"| node_paths
node_resolution_worker -->|"uses image tools"| node_image_utils
node_validation_worker -->|"renders node graphs"| node_node_graph
node_validation_worker -->|"renders node graphs"| node_node_graph
node_gltf_job -->|"uses concurrency"| node_concurrency
node_resolution_job -->|"uses concurrency"| node_concurrency
node_thumbnail_job -->|"uses concurrency"| node_concurrency
node_validation_job -->|"uses concurrency"| node_concurrency
node_caption_gpt -.->|"generates captions"| node_asset_server

click node_process "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/process_asset.py"
click node_gltf_job "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/generate_gltf.py"
click node_gltf_worker "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blender_bg_scripts/gltf_bg_blender.py"
click node_resolution_job "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/generate_resolutions.py"
click node_resolution_worker "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blender_bg_scripts/resolutions_bg_blender.py"
click node_proxy_job "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/generate_proxors.py"
click node_proxy_worker "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blender_bg_scripts/bl_proxor/generate.py"
click node_thumbnail_job "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/render_thumbnail.py"
click node_thumbnail_worker "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blender_bg_scripts/autothumb_model_bg.py"
click node_validation_job "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/generate_validations.py"
click node_validation_worker "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blender_bg_scripts/model_validation_bg_render.py"
click node_field_validation "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blenderkit_server_utils/asset_validation/field_validation/validate_fields.py"
click node_ai_validation "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blenderkit_server_utils/asset_validation/field_validation/ai_validation.py"
click node_manufacturer "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/clean_manufacturer_tags.py"
click node_caption_gpt "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/generate_caption_alt_text_gpt.py"
click node_caption_clip "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/generate_caption_clip_interrogator.py"
click node_reindex "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/reindex.py"
click node_twinbru "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/sync_TwinBru_library.py"
click node_search "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blenderkit_server_utils/search.py"
click node_download "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blenderkit_server_utils/download.py"
click node_dispatch "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blenderkit_server_utils/send_to_bg.py"
click node_upload "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blenderkit_server_utils/upload.py"
click node_storage "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blenderkit_server_utils/cloudflare_storage.py"
click node_concurrency "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blenderkit_server_utils/concurrency.py"
click node_config "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blenderkit_server_utils/config.py"
click node_paths "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blenderkit_server_utils/paths.py"
click node_image_utils "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blenderkit_server_utils/image_utils.py"
click node_node_graph "https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blenderkit_server_utils/render_nodes_graph.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_process toneBlue
class node_gltf_job,node_gltf_worker,node_resolution_job,node_resolution_worker,node_proxy_job,node_proxy_worker,node_thumbnail_job,node_thumbnail_worker,node_asset_server toneAmber
class node_validation_job,node_validation_worker,node_field_validation,node_ai_validation,node_manufacturer,node_caption_gpt,node_caption_clip,node_reindex,node_twinbru toneMint
class node_search,node_download,node_dispatch,node_upload,node_storage,node_concurrency,node_config,node_paths,node_image_utils,node_node_graph,node_operator toneRose
```

## Components

### Asset orchestration

- [Process assets](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/process_asset.py): `process_asset.py`

### Blender processing

- [GLTF conversion](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/generate_gltf.py): `generate_gltf.py`
- [GLTF Blender task](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blender_bg_scripts/gltf_bg_blender.py): `blender_bg_scripts/gltf_bg_blender.py`
- [Resolution variants](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/generate_resolutions.py): `generate_resolutions.py`
- [Resolution Blender task](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blender_bg_scripts/resolutions_bg_blender.py): `blender_bg_scripts/resolutions_bg_blender.py`
- [Proxy generation](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/generate_proxors.py): `generate_proxors.py`
- [Proxy Blender task](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blender_bg_scripts/bl_proxor/generate.py): `blender_bg_scripts/bl_proxor/generate.py`
- [Thumbnail rendering](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/render_thumbnail.py): `render_thumbnail.py`
- [Thumbnail Blender task](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blender_bg_scripts/autothumb_model_bg.py): `blender_bg_scripts/autothumb_model_bg.py`

### Metadata and review

- [Asset validation](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/generate_validations.py): `generate_validations.py`
- [Validation rendering](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blender_bg_scripts/model_validation_bg_render.py): `blender_bg_scripts/model_validation_bg_render.py`
- [Field validation](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blenderkit_server_utils/asset_validation/field_validation/validate_fields.py): `blenderkit_server_utils/asset_validation/field_validation/validate_fields.py`
- [AI field checks](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blenderkit_server_utils/asset_validation/field_validation/ai_validation.py): `blenderkit_server_utils/asset_validation/field_validation/ai_validation.py`
- [Manufacturer tags](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/clean_manufacturer_tags.py): `clean_manufacturer_tags.py`
- [GPT captions](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/generate_caption_alt_text_gpt.py): `generate_caption_alt_text_gpt.py`
- [CLIP captions](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/generate_caption_clip_interrogator.py): `generate_caption_clip_interrogator.py`
- [Asset reindexing](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/reindex.py): `reindex.py`
- [TwinBru sync](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/sync_TwinBru_library.py): `sync_TwinBru_library.py`

### Shared runtime

- [Asset search](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blenderkit_server_utils/search.py): `blenderkit_server_utils/search.py`
- [Asset download](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blenderkit_server_utils/download.py): `blenderkit_server_utils/download.py`
- [Blender dispatch](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blenderkit_server_utils/send_to_bg.py): `blenderkit_server_utils/send_to_bg.py`
- [Result upload](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blenderkit_server_utils/upload.py): `blenderkit_server_utils/upload.py`
- [Cloud storage](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blenderkit_server_utils/cloudflare_storage.py): `blenderkit_server_utils/cloudflare_storage.py`
- [Concurrent workers](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blenderkit_server_utils/concurrency.py): `blenderkit_server_utils/concurrency.py`
- [Runtime configuration](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blenderkit_server_utils/config.py): `blenderkit_server_utils/config.py`
- [Asset paths](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blenderkit_server_utils/paths.py): `blenderkit_server_utils/paths.py`
- [Image processing](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blenderkit_server_utils/image_utils.py): `blenderkit_server_utils/image_utils.py`
- [Node graph rendering](https://github.com/blenderkit/blenderkit_asset_tasks/blob/main/blenderkit_server_utils/render_nodes_graph.py): `blenderkit_server_utils/render_nodes_graph.py`

### Other components

- **Task operator**
- **BlenderKit server**

## Connections

- Task operator → Process assets: starts processing (evidence: `README.md`)
- Process assets → Asset search: searches assets (evidence: `process_asset.py`)
- Process assets → GLTF conversion: runs applicable jobs (evidence: `process_asset.py`)
- Process assets → Resolution variants: runs applicable jobs (evidence: `process_asset.py`)
- Process assets → Asset download: downloads assets (evidence: `process_asset.py`)
- Process assets → Blender dispatch: dispatches Blender (evidence: `process_asset.py`)
- Process assets → Result upload: reuploads marked blend (evidence: `process_asset.py`)
- GLTF conversion → Asset search: uses search (evidence: `generate_gltf.py`)
- GLTF conversion → Asset download: downloads assets (evidence: `generate_gltf.py`)
- GLTF conversion → Blender dispatch: launches Blender (evidence: `generate_gltf.py`)
- GLTF conversion → Result upload: uploads output (evidence: `generate_gltf.py`)
- GLTF conversion → GLTF Blender task: runs background task (evidence: `README.md`)
- Resolution variants → Asset search: uses search (evidence: `generate_resolutions.py`)
- Resolution variants → Asset download: downloads assets (evidence: `generate_resolutions.py`)
- Resolution variants → Blender dispatch: launches Blender (evidence: `generate_resolutions.py`)
- Resolution variants → Result upload: uploads output (evidence: `generate_resolutions.py`)
- Resolution variants → Resolution Blender task: runs background task (evidence: `README.md`)
- Proxy generation → Proxy Blender task: runs background task (evidence: `README.md`)
- Thumbnail rendering → Asset search: uses search (evidence: `render_thumbnail.py`)
- Thumbnail rendering → Asset download: downloads assets (evidence: `render_thumbnail.py`)
- Thumbnail rendering → Blender dispatch: launches Blender (evidence: `render_thumbnail.py`)
- Thumbnail rendering → Result upload: uploads output (evidence: `render_thumbnail.py`)
- Thumbnail rendering → Thumbnail Blender task: runs background task (evidence: `README.md`)
- Asset validation → Asset search: uses search (evidence: `generate_validations.py`)
- Asset validation → Asset download: downloads assets (evidence: `generate_validations.py`)
- Asset validation → Blender dispatch: launches Blender (evidence: `generate_validations.py`)
- Asset validation → Cloud storage: uses storage (evidence: `generate_validations.py`)
- Asset validation → Validation rendering: runs background task (evidence: `README.md`)
- Manufacturer tags → Field validation: uses field validation (evidence: `clean_manufacturer_tags.py`)
- Field validation → AI field checks: calls AI checks (evidence: `blenderkit_server_utils/asset_validation/field_validation/validate_fields.py`)
- Manufacturer tags → Asset search: uses search (evidence: `clean_manufacturer_tags.py`)
- Manufacturer tags → Result upload: updates metadata (evidence: `clean_manufacturer_tags.py`)
- TwinBru sync → Asset search: uses search (evidence: `sync_TwinBru_library.py`)
- TwinBru sync → Blender dispatch: launches Blender (evidence: `sync_TwinBru_library.py`)
- TwinBru sync → Result upload: uploads assets (evidence: `sync_TwinBru_library.py`)
- Asset search → BlenderKit server: queries (evidence: `blenderkit_server_utils/search.py`)
- Asset download → BlenderKit server: downloads from (evidence: `blenderkit_server_utils/download.py`)
- Result upload → BlenderKit server: uploads to (evidence: `blenderkit_server_utils/upload.py`)
- Blender dispatch → Runtime configuration: reads settings (evidence: `blenderkit_server_utils/send_to_bg.py`)
- Asset download → Asset paths: resolves paths (evidence: `blenderkit_server_utils/download.py`)
- Resolution Blender task → Image processing: uses image tools (evidence: `blender_bg_scripts/resolutions_bg_blender.py`)
- Validation rendering → Node graph rendering: renders node graphs (evidence: `blender_bg_scripts/model_validation_bg_render.py`)
- Validation rendering → Node graph rendering: renders node graphs (evidence: `blender_bg_scripts/model_validation_bg_render.py`)
- GLTF conversion → Concurrent workers: uses concurrency (evidence: `generate_gltf.py`)
- Resolution variants → Concurrent workers: uses concurrency (evidence: `generate_resolutions.py`)
- Thumbnail rendering → Concurrent workers: uses concurrency (evidence: `render_thumbnail.py`)
- Asset validation → Concurrent workers: uses concurrency (evidence: `generate_validations.py`)
- GPT captions → BlenderKit server: generates captions (evidence: `README.md`)
