openinterp / start

First Result in 10 Minutes

Connect your favorite agent harness (Claude Code, Cursor, Cline) to a Colab session and run probe-causality experiments by conversation. No GPU on your laptop. No data leaves your compute.

  1. 1

    Open the Colab template

    A single notebook with three cells. Free-tier compatible for Qwen2.5-7B at 4-bit; Pro recommended for bf16.

    Open in Colab
  2. 2

    Add your ngrok token to Colab Secrets

    Colab → 🔑 Secrets in the left sidebar → add NGROK_AUTHTOKEN.

    Get a free token at dashboard.ngrok.com

    Secrets stay in your Colab account. We never see them.

  3. 3

    Run the three cells

    The third prints a line that starts with /colab-attach https://…ngrok-free.app. Keep the notebook tab open while you work.

  4. 4

    Install the MCP server on your laptop

    pip install "openinterp-mcp[server]"
  5. 5

    Wire into your agent

    For Claude Code, edit ~/.claude/mcp.json:

    {
  "mcpServers": {
    "openinterp": {
      "command": "openinterp-mcp",
      "args": ["serve"]
    }
  }
}

    Cursor: ~/.cursor/mcp.json · Cline: settings panel · same JSON.Full guides

  6. 6

    First experiment — paste in your agent

    /colab-attach https://abc123.ngrok-free.app
    # the agent connects, prints loaded model + probes

    Capture L20 at end_question for "Solve x^2 = 4".
    Then run causality_protocol on saturation-direction-L20 with labels [1].

    Total time from Colab attach to first verdict: ~30 seconds.

What you can do next

Your model, your compute, your keys. We just route the conversation.