Skip to content

colab_tpu_runtime.rst

Latest commit

 

History

History
111 lines (65 loc) · 2.41 KB

colab_tpu_runtime.rst

File metadata and controls

111 lines (65 loc) · 2.41 KB

Google Colab Installation Guide

Prerequisites

Before installing the package, configure the runtime environment correctly:

  1. Open a new notebook in Google Colab.
  2. Navigate to Runtime → Change runtime type.
  3. Set the runtime configuration as follows:
    • Runtime type: Python 3
    • Hardware accelerator: TPU
    • TPU type: v2-8
  4. Click Save to apply the configuration.

Using the recommended TPU configuration ensures compatibility with workflows that may require TPU-based computation.

Installation Procedure

In a new notebook cell, install the package:

!pip install malariagen_data

After installation completes, verify that the package is available:

import malariagen_data

If the import executes without errors, the installation was successful.

If dependency-related warnings or conflicts occur, follow one of the resolution options described below.

Resolution Options

Resolution Option 1: Uninstall Panel

If your notebook does not require panel, uninstall it before installing malariagen_data.

!pip uninstall -y panel
!pip install malariagen_data

Verify installation:

import malariagen_data

Resolution Option 2: Install Compatible Panel Version

If your workflow depends on panel, install a compatible version:

!pip install panel==1.7.0
!pip install malariagen_data

Restart the runtime:

Runtime → Restart runtime

Then verify:

import malariagen_data

Resolution Option 3: Install Required Blinker Version

If a blinker version conflict occurs:

!pip install blinker==1.9.0 --ignore-installed
!pip install malariagen_data

Restart the runtime and verify:

import malariagen_data

Final Verification

After completing any of the procedures above:

  • Ensure that malariagen_data installs without dependency errors.
  • Confirm that import malariagen_data runs successfully.
  • Restart the runtime whenever core dependencies are modified.
  • Avoid mixing incompatible package versions within the same Colab session.