colab-client 0.1.1

Python client for programmatically interacting with Google Colab

Colab Client

Note: This is an unofficial client and is not affiliated with Google. Use at your own risk.

Python client for Google Colab. Execute code on Colab runtimes from your terminal or Python scripts.

Installation

Install uv:

curl -LsSf https://astral.sh/uv/install.sh | sh

Clone and run:

git clone https://github.com/sachnun/colab-client.git
cd colab-client
uv sync
uv run colab-client

Usage

Command Line

$ uv run colab-client --help
usage: colab-client [-h] [-v] [-c CODE]
                    [--variant {DEFAULT,STANDARD_GPU,PREMIUM_GPU,TPU,CASCADE_LAKE,SKYLAKE}]
                    [--unassign] [--list]

options:
  -h, --help            show this help message and exit
  -v, --verbose         Enable verbose logging
  -c CODE, --code CODE  Execute code and exit
  --variant             Runtime variant (default: DEFAULT)
  --unassign            Unassign current server and exit
  --list                List current assignments and exit

As a Library

uv add colab-client

from colab_client import ColabClient

client = ColabClient()
client.login()
client.get_or_create_server()
client.get_or_create_session()

result = client.execute("print('Hello from Colab!')")
print(result.stdout)

client.close()

Configuration

Environment variables:

Variable	Description	Default
COLAB_TOKEN_PATH	Path to token cache	~/.colab_token.json

License

MIT License - see LICENSE for details.