colab-ask 0.1.6

An LLM assistant magic command for Google Colab notebooks.

colab-ask 🪄

Colab-Ask is a magic command that sends your code, outputs, and even generated images (matplotlib, etc.) directly to models like Claude or GPT-4 for context-aware help.

Why use this?

• Context Aware: It sees your text and code cells, and error traces.
• Vision Capable: It can see embedded images and graphs.
• Native Integration: Lives inside Colab. No alt-tabbing to ChatGPT.
• Privacy First: Your data goes straight to the API. No middleman servers.

Prerequisites (Before you start)

1. Google Colab: This extension is designed specifically for the Colab environment.
2. API Keys: You need an API key for your preferred provider (OpenAI, Anthropic, Gemini, etc.).
   • Click the Key Icon (Secrets) on the left sidebar in Colab.
   • Add a new secret (e.g., ANTHROPIC_API_KEY or OPENAI_API_KEY).
   • Toggle "Notebook access" ON.

---

Quick Start

Run this in a cell to install and load the extension:

!pip install colab-ask
%load_ext colab-ask

1. The Basic Ask

Use %%ask to chat about your current notebook state.

%%ask
My training loop is stalling at epoch 5. based on the logs above, why?

2. The Vision Ask

Since colab-ask sees images, you can ask about plots:

# (After generating a matplotlib chart)
%%ask
Look at the plot above. Is the model overfitting?

---

Configuration

Change Model: Uses LiteLLM under the hood. Any supported model string works. Check https://docs.litellm.ai/docs/providers

%set_model claude-3-5-sonnet-20241022

Set System Prompt: Want a specific teaching style?

%%set_sys
You are a senior Python engineer. Be concise. 
Focus on performance optimization and vectorized operations.

Default System Prompt

By default, colab-ask uses this system prompt:

You are an AI assistant inside a Google Colab notebook.
In your response, craft guidance on the next step, whether code related, or more strategy related.
Don't spew out all the steps at once, the user wants to go slow, they will ask for more if they need it.
The user is interested in improving their coding, and may choose to make code blocks in response to your input.

This prompt is inspired by SolveIt (the fast.ai dialog engineering environment), which emphasizes:

• Small steps: Breaking down problems incrementally
• Interactive learning: Waiting for user feedback before proceeding
• Code-focused: Encouraging hands-on implementation

Privacy & Data

• Direct Communication: Notebook data is sent directly from your browser/runtime to the LLM provider (OpenAI/Anthropic/Google).
• Zero Logs: We do not run a middleware server. We do not store your code.