How blenderkit/blenderkit_asset_tasks works
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 Process assets · generate_gltf.py GLTF conversion · generate_resolutions.py Resolution variants · search.py Asset search
Components 30
Asset orchestration
- Process assets
process_asset.py
Blender processing
- GLTF conversion
generate_gltf.py - GLTF Blender task
blender_bg_scripts/gltf_bg_blender.py - Resolution variants
generate_resolutions.py - Resolution Blender task
blender_bg_scripts/resolutions_bg_blender.py - Proxy generation
generate_proxors.py - Proxy Blender task
blender_bg_scripts/bl_proxor/generate.py - Thumbnail rendering
render_thumbnail.py - Thumbnail Blender task
blender_bg_scripts/autothumb_model_bg.py
Metadata and review
- Asset validation
generate_validations.py - Validation rendering
blender_bg_scripts/model_validation_bg_render.py - Field validation
blenderkit_server_utils/asset_validation/field_validation/validate_fields.py - AI field checks
blenderkit_server_utils/asset_validation/field_validation/ai_validation.py - Manufacturer tags
clean_manufacturer_tags.py - GPT captions
generate_caption_alt_text_gpt.py - CLIP captions
generate_caption_clip_interrogator.py - Asset reindexing
reindex.py - TwinBru sync
sync_TwinBru_library.py
Shared runtime
- Asset search
blenderkit_server_utils/search.py - Asset download
blenderkit_server_utils/download.py - Blender dispatch
blenderkit_server_utils/send_to_bg.py - Result upload
blenderkit_server_utils/upload.py - Cloud storage
blenderkit_server_utils/cloudflare_storage.py - Concurrent workers
blenderkit_server_utils/concurrency.py - Runtime configuration
blenderkit_server_utils/config.py - Asset paths
blenderkit_server_utils/paths.py - Image processing
blenderkit_server_utils/image_utils.py - Node graph rendering
blenderkit_server_utils/render_nodes_graph.py
Other components
- Task operator
- BlenderKit server
Connections 48
- Task operator → Process assets: starts processing
README.md - Process assets → Asset search: searches assets
process_asset.py - Process assets → GLTF conversion: runs applicable jobs
process_asset.py - Process assets → Resolution variants: runs applicable jobs
process_asset.py - Process assets → Asset download: downloads assets
process_asset.py - Process assets → Blender dispatch: dispatches Blender
process_asset.py - Process assets → Result upload: reuploads marked blend
process_asset.py - GLTF conversion → Asset search: uses search
generate_gltf.py - GLTF conversion → Asset download: downloads assets
generate_gltf.py - GLTF conversion → Blender dispatch: launches Blender
generate_gltf.py - GLTF conversion → Result upload: uploads output
generate_gltf.py - GLTF conversion → GLTF Blender task: runs background task
README.md - Resolution variants → Asset search: uses search
generate_resolutions.py - Resolution variants → Asset download: downloads assets
generate_resolutions.py - Resolution variants → Blender dispatch: launches Blender
generate_resolutions.py - Resolution variants → Result upload: uploads output
generate_resolutions.py - Resolution variants → Resolution Blender task: runs background task
README.md - Proxy generation → Proxy Blender task: runs background task
README.md - Thumbnail rendering → Asset search: uses search
render_thumbnail.py - Thumbnail rendering → Asset download: downloads assets
render_thumbnail.py - Thumbnail rendering → Blender dispatch: launches Blender
render_thumbnail.py - Thumbnail rendering → Result upload: uploads output
render_thumbnail.py - Thumbnail rendering → Thumbnail Blender task: runs background task
README.md - Asset validation → Asset search: uses search
generate_validations.py - Asset validation → Asset download: downloads assets
generate_validations.py - Asset validation → Blender dispatch: launches Blender
generate_validations.py - Asset validation → Cloud storage: uses storage
generate_validations.py - Asset validation → Validation rendering: runs background task
README.md - Manufacturer tags → Field validation: uses field validation
clean_manufacturer_tags.py - Field validation → AI field checks: calls AI checks
blenderkit_server_utils/asset_validation/field_validation/validate_fields.py - Manufacturer tags → Asset search: uses search
clean_manufacturer_tags.py - Manufacturer tags → Result upload: updates metadata
clean_manufacturer_tags.py - TwinBru sync → Asset search: uses search
sync_TwinBru_library.py - TwinBru sync → Blender dispatch: launches Blender
sync_TwinBru_library.py - TwinBru sync → Result upload: uploads assets
sync_TwinBru_library.py - Asset search → BlenderKit server: queries
blenderkit_server_utils/search.py - Asset download → BlenderKit server: downloads from
blenderkit_server_utils/download.py - Result upload → BlenderKit server: uploads to
blenderkit_server_utils/upload.py - Blender dispatch → Runtime configuration: reads settings
blenderkit_server_utils/send_to_bg.py - Asset download → Asset paths: resolves paths
blenderkit_server_utils/download.py - Resolution Blender task → Image processing: uses image tools
blender_bg_scripts/resolutions_bg_blender.py - Validation rendering → Node graph rendering: renders node graphs
blender_bg_scripts/model_validation_bg_render.py - Validation rendering → Node graph rendering: renders node graphs
blender_bg_scripts/model_validation_bg_render.py - GLTF conversion → Concurrent workers: uses concurrency
generate_gltf.py - Resolution variants → Concurrent workers: uses concurrency
generate_resolutions.py - Thumbnail rendering → Concurrent workers: uses concurrency
render_thumbnail.py - Asset validation → Concurrent workers: uses concurrency
generate_validations.py - GPT captions → BlenderKit server: generates captions
README.md