colab-workshop-integrator

Google Colab Workshop Integrator Skill

Purpose

Bridges workshop-harness generated workshops with Google Colab and the Google Colab CLI (https://github.com/googlecolab/google-colab-cli). It transforms static workshop markdown docs, lab instructions, and starter/final code into interactive Jupyter Notebooks (.ipynb), injects cloud GPU verification and Secret management cells, inserts "Open in Colab" badges, and enables facilitators to run automated remote headless smoke tests via colab CLI.

🌐 Mandatory Pre-Flight Web Research Protocol: Before generating Colab notebooks, perform live web search (search_web / workshop-web-researcher) to verify current Colab CUDA driver versions, newest PyTorch / HuggingFace Transformers / Google GenAI SDK syntax, and latest pip package names.

🚀 Key Integration Features

1. Lab to .ipynb Auto-Generation:

   • Converts workshop/03_labs/README.md and code files (workshop/01_starter, workshop/02_final) into clean, structured Jupyter Notebooks.
   • Generates two flavors:
     • workshop_starter.ipynb: Step-by-step guides with starter code cells and attendee TODO prompts.
     • workshop_solution.ipynb: Complete reference solution notebook ready for live demo or fallback.

2. Zero-Setup Runtime Preparation Cells:

   • Environment & Dependency Injection: Automatically adds top %pip install -q ... cells based on pyproject.toml or workshop tech stack.
   • Hardware Accelerator Verification: Injects GPU runtime verification (!nvidia-smi / torch CUDA check) for local LLM (Ollama, vLLM, transformers) labs.
   • Colab Secrets & Credential Protocol: Injects secure google.colab.userdata API key handling instead of hardcoded keys:

     # Secure API Key Setup in Colab
     try:
         from google.colab import userdata
         gemini_api_key = userdata.get('GEMINI_API_KEY')
     except ImportError:
         import os
         gemini_api_key = os.environ.get('GEMINI_API_KEY', '')