Skip to content

Docs: Add Google Colab TPU runtime installation guide and troubleshooting#923

Open
RishiP2006 wants to merge 4 commits intomalariagen:masterfrom
RishiP2006:docs/colab-tpu-runtime
Open

Docs: Add Google Colab TPU runtime installation guide and troubleshooting#923
RishiP2006 wants to merge 4 commits intomalariagen:masterfrom
RishiP2006:docs/colab-tpu-runtime

Conversation

@RishiP2006
Copy link
Copy Markdown

This PR adds a dedicated documentation section for using malariagen_data
on Google Colab with a TPU runtime.

  • Reproduced installation failure on fresh v2-8 TPU runtime.
  • Documented root cause (distutils-installed blinker==1.4 conflict).
  • Added structured workaround steps.
  • Separated installation issues from GCS authentication troubleshooting.

This should help reduce repeated install-related issue reports for TPU users.

@RishiP2006
Copy link
Copy Markdown
Author

Could a maintainer please approve the workflows to run?

@blankirigaya
Copy link
Copy Markdown
Contributor

@RishiP2006 I am not a maintainer but from my understanding this is all documentation correct? so...

just wanted to add some context here — since this is a pure documentation change with no modifications to any Python files or logic, workflow tests wouldn't have anything to validate. The workaround described has been manually verified by steps on a Colab TPU runtime.

@RishiP2006
Copy link
Copy Markdown
Author

Thanks for the clarification. Yes, this is a docs-only change, and the installation steps were manually verified on a Colab TPU runtime.
Happy to make any adjustments if needed.

Copilot AI review requested due to automatic review settings April 20, 2026 08:03
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review is ineligible. To be eligible to request a review, you need a paid Copilot license, or your organization must enable Copilot code review.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants