skop-runner 0.1.3

Local execution client for Skop Labs — run Jupyter notebooks from the browser on your own machine

Skop Runner

Run Jupyter notebooks from Skop on your own machine. Skop Runner connects your local computer to the Skop workspace, letting you execute code, manage files, and use your local Python environments — all from the browser.

Installation

pip install skop-runner

Requires Python 3.10+.

Quick Start

1. Get your device token

Go to skoplabs.com, open a workspace, and click Add Device in the device dropdown. Copy the token.

2. Login

skop-runner login --token <your-device-token>

3. Start the runner

skop-runner start

That's it. Open your workspace in the browser and select your device — you can now browse folders, open notebooks, and execute code on your machine.

Commands

Command	Description
skop-runner login --token <token>	Authenticate with Skop
skop-runner start	Start the runner
skop-runner status	Check authentication status
skop-runner logout	Remove authentication

How It Works

Skop Runner runs a local process that:

• Connects to the Skop relay server via WebSocket
• Manages Jupyter kernels for notebook execution
• Serves your local files to the browser workspace
• Detects Python environments (venv, conda, Poetry, Pipenv, pyenv)

Your code runs entirely on your machine. Skop only relays messages between your browser and the runner.

Configuration

Config is stored in ~/.skop/config.json (created by skop-runner login).

Environment variable overrides:

• SKOP_API_URL — API URL (default: https://skoplabs.com)
• SKOP_WS_URL — WebSocket relay URL
• SKOP_LOG_LEVEL — Logging level (default: INFO)

Requirements

• Python 3.10+
• macOS or Linux (Windows support coming soon)

License

MIT