You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: add Google Colab setup and troubleshooting section (#2025)
### Summary
Add a Colab-specific setup and troubleshooting section to README to help
users run MONAI tutorials reliably on Google Colab.
### Changes
- Document explicit installation of PyTorch 2.6.0 (CUDA 12.4) and MONAI
1.5 on Colab
- Add troubleshooting notes (torchaudio mismatch, filelock conflict,
num_workers warning)
- Include a quick smoke test command to verify the setup
### Motivation
Many users start with Colab and often hit dependency conflicts. This
section improves first-time success and reproducibility.
---------
Signed-off-by: minsu <minsu.kim08@gmail.com>
Signed-off-by: Minsu Kim <60283244+minsuking@users.noreply.github.com>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Eric Kerfoot <17726042+ericspod@users.noreply.github.com>
Colab may come with torchaudio 2.8.0, which is incompatible with torch 2.6.0.
61
+
Installing the versions above resolves this issue.
62
+
63
+
- filelock conflicts with nni
64
+
Some preinstalled packages (such as pytensor with newer filelock) may conflict.
65
+
Use the following commands to fix:
66
+
67
+
pip uninstall -y pytensor
68
+
pip install -U filelock
69
+
70
+
- Too many workers warning
71
+
Colab has limited CPU resources, and high num_workers settings may freeze execution.
72
+
It is recommended to use --num_workers=2 when running tutorials and adjust the `num_workers` parameters where it is used in notebooks (eg. for data loaders).
73
+
74
+
75
+
### Quick smoke test
76
+
77
+
After installation, verify the environment by running:
0 commit comments