Windows compatibility issues with installation and embedding pipeline
@NetZissou is already working on this.
Since Mar 25, 2026.
Assessment
This issue has not been assessed yet.
Description
Windows compatibility issues with installation and embedding pipeline
Summary
Several issues prevent a smooth experience on Windows. Tested on Windows 11 with Python 3.12, CUDA 12.8 (Quadro P2000).
Issues
1. DataLoader crash: unpicklable lambda in ImageFolderDataset
Windows uses spawn (not fork) for multiprocessing. ImageFolderDataset._init_uuid_generator() assigns lambdas to self.generate_uuid, which cannot be pickled when num_workers > 0.
AttributeError: Can't get local object 'ImageFolderDataset._init_uuid_generator.<locals>.<lambda>'
Fix: Set num_workers=0 on Windows in embedding_service.py, or replace the lambdas in hpc-inference with a regular method.
2. gpu-cu12 / gpu-cu13 extras fail on Windows
cuML (RAPIDS) only ships Linux wheels. uv pip install -e ".[gpu-cu12]" fails with RuntimeError: Didn't find wheel for cuml-cu12.
Fix: Document that GPU extras (cuML) are Linux-only. Embedding still uses CUDA via PyTorch on Windows.
3. PyTorch installs as CPU-only by default
uv pip install -e . pulls the CPU-only torch from PyPI on Windows. Users must manually reinstall from PyTorch's CUDA index:
uv pip install torch torchvision --index-url https://download.pytorch.org/whl/cu124
Fix: Add Windows-specific CUDA PyTorch install instructions to README.
4. Missing pynvml dependency
Embedding fails at runtime with No module named 'pynvml'.
Fix: Add pynvml or nvidia-ml-py to project dependencies.
5. README venv activation command is Linux-only
source .venv/bin/activate does not exist on Windows. The correct path is .venv\Scripts\activate.
Fix: Add Windows activation instructions to README.
- Dominant language
- Python
- Stars
- 8
- Forks
- 0
- PR merge metrics
- No merged PRs in 30d
Getting set up
This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from Imageomics/emb-explorer
-
Embed & Explore: image-folder handling and backend auto-selectionPossibly taken @NetZissou claimed this 57 days ago. Openbug enhancement
Imageomics/emb-explorer#50 · 1 assignee ·
-
Duplicate Script RunPossibly taken @NetZissou claimed this 57 days ago. Openbug
Imageomics/emb-explorer#49 · 1 assignee ·
-
Analysis Export with ProvenanceMay be free again @NetZissou claimed this 63 days ago, and no pull request is open. Opendesign enhancement
Imageomics/emb-explorer#48 · 1 comment · 1 assignee ·
-
Misclassification Analysis: Lasso Feature and AnnotationsMay be free again @NetZissou claimed this 65 days ago, and no pull request is open. Opendesign enhancement
Imageomics/emb-explorer#47 · 1 assignee ·
-
Add per-cluster representative images to the precalculated appPossibly taken @NetZissou claimed this 156 days ago. Openenhancement
Imageomics/emb-explorer#39 · 1 reaction · 1 assignee ·
All issues in Imageomics/emb-explorer
Similar issues
-
automated endpoint-dead needs-curation
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
almanac-data/climate-almanac#138 ·
Maintainers usually reply within 1 day
-
enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 67/100
OceanDataTools/openrvdas#760 ·
Maintainers usually reply within 1 day
-
level/subtask type/enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
wazuh/wazuh-virtual-machines#1091 ·
Maintainers usually reply within 1 day
-
Python: Bug: ChatMessageContent.from_element drops AudioContent and BinaryContent into raw TextContentPossibly taken @halcyon-past claimed this today. Open
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
microsoft/semantic-kernel#14824 · 1 comment ·
Maintainers usually reply within 3 days
-
help wanted
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
stack314/django-neolith#142 · 1 comment ·
Maintainers usually reply within 1 day