Install and sign in

Scrambo is a thin Python SDK for the closed-alpha cloud editor. Installing it, signing in, and exporting all need a real machine with network access and a browser, so these steps run on your own machine.

Install the SDK

Scrambo is in closed-alpha prerelease, so only prerelease versions are published. A plain pip install scrambo fails with "no matching distribution" — pin the current alpha instead. An exact prerelease pin installs without needing --pre:

pip install scrambo==0.1.0a6

That is enough to get started. For a clean, reproducible setup, a managed environment via uv is recommended over a global install — but either works.

Recommended: a managed environment with uv

Install uv with your platform's package manager:

brew install uv               # macOS (Homebrew)
pipx install uv               # any OS, if pipx is available
winget install astral-sh.uv   # Windows (winget)

Or use Astral's official install scripts:

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

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

See Astral's installation guide for other options.

Then create a project for your edit and add Scrambo to it. Pin the alpha and pass --prerelease allow so uv accepts it:

uv init my-first-edit
cd my-first-edit
uv add "scrambo==0.1.0a6" --prerelease allow

uv add creates and manages the virtual environment automatically. Run every Scrambo program through uv run so it executes inside that environment:

uv run make_reel.py

Sign in

There is no API token to paste. On the first cloud call the SDK opens your browser to sign in with a one-time email PIN (the same Cloudflare Access identity the editor uses) and caches the credential in ~/.scrambo/credentials.json.

Because sign-in needs an interactive browser, it is easiest to sign in ahead of time and confirm it succeeded before running an editing program. Manage the credential with the bundled CLI:

uv run scrambo login    # sign in ahead of time
uv run scrambo whoami   # show the signed-in identity
uv run scrambo logout   # clear the saved credential

Outside a uv project, drop the uv run prefix and call scrambo directly.

With the SDK installed and signed in, continue to the quickstart to write and run your first edit.