Is --max-workers flag related to CPU core?

[TinyRick1489]

I have 6 core 12 thread CPU. If I want to use 4 cores, should I keep --max-workers 4 or --max-workers 8?

[meizhong986]

The --max-workers flag controls how many GPU worker processes run in parallel, not CPU cores. Each worker loads the model onto a GPU and processes files independently.

With a single GPU, --max-workers 1 is usually best (default). With 2 GPUs (like Kaggle dual T4), --max-workers 2 lets each GPU process a file simultaneously.

Setting it higher than your GPU count will not help — the workers would compete for the same GPU memory.