-
Notifications
You must be signed in to change notification settings - Fork 752
docs: add Google Colab setup and troubleshooting section #2025
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Conversation
3c77dcc
to
9477964
Compare
Add a Colab-specific setup (PyTorch 2.6.0 + CUDA 12.4, MONAI 1.5) and troubleshooting notes (torchaudio mismatch, filelock conflict, num_workers guidance). Include a quick smoke test to verify the environment. Signed-off-by: minsu <[email protected]>
27f5c27
to
0941eb7
Compare
for more information, see https://pre-commit.ci
Hi, this is my first contribution to MONAI. Thank you for reviewing 🙏 I added a Google Colab setup & troubleshooting section to the README. Verified installation with PyTorch 2.6.0 + CUDA 12.4 and MONAI 1.5 Tested using unet_training_array.py tutorial → training ran successfully and produced expected Dice score Documented known issues: torchaudio mismatch, filelock conflict, and num_workers guidance This section should improve first-time success and reproducibility for Colab users. |
Hi @minsuking thanks for the contribution! I think it's fine as it is with a minor addition to change code in notebooks. I think notebook running in Colab is still fine with the environment that's installed, I just checked the MONAI 101 tutorial and I got Pytorch 2.8 that worked fine, but these instructions are good for install MONAI with other dependencies. It may be worth noting that people will usually run notebooks in Colab directly rather than install and run things on the command line. |
Co-authored-by: Eric Kerfoot <[email protected]> Signed-off-by: Minsu Kim <[email protected]>
Signed-off-by: Minsu Kim <[email protected]>
for more information, see https://pre-commit.ci
@ericspod Thank you very much for your kind review and guidance. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks good to me!
Thanks again @minsuking If you're looking to contribute further we're putting together efforts on implementing work from MICCAI if that's of interest. Other than that we're always open to updates and fixes here in the tutorials. We do plan to reorganise and streamline things here soon as well. |
Summary
Add a Colab-specific setup and troubleshooting section to README to help users run MONAI tutorials reliably on Google Colab.
Changes
Motivation
Many users start with Colab and often hit dependency conflicts. This section improves first-time success and reproducibility.