GitHub Codespaces

Click "Open in Codespaces" on the repo to get a ready-to-use Strata environment with the server running automatically.

What's included

The .devcontainer/ configuration provides:

• Python 3.13 (devcontainer feature, on an Ubuntu 24.04 base)
• VS Code extensions: Python, Ruff
• Strata installed from the published PyPI wheel - no Rust or Node build

Setup flow

1. postCreateCommand (setup.sh) runs once on container creation:

   • Installs uv
   • uv tool install 'strata-notebook[sql,sql-duckdb,sql-sqlite]' - the prebuilt wheel, so it finishes in under a minute (no Rust compilation), with the extras SQL cells on SQLite and DuckDB need

2. postStartCommand (start.sh) runs on every container start:

   • Starts the Strata server in the background and waits for the health check to pass

Port forwarding

Port 8765 is forwarded automatically with onAutoForward: "openBrowser", so your browser opens the notebook UI as soon as the server is ready. start.sh lists the forwarded name (<codespace>-8765.app.github.dev) in STRATA_ALLOWED_HOSTS: personal mode answers only to names it expects, which keeps DNS-rebinding pages out. If you start the server yourself, set it the same way.

Contributing to Strata

The Codespace installs the published wheel, which is all you need to use Strata. To develop Strata - building the Rust extension and frontend from source - set up a full dev environment instead:

curl --proto '=https' -sSf https://sh.rustup.rs | sh -s -- -y   # Rust toolchain
git clone https://github.com/bearing-research/strata.git
cd strata && uv sync --all-extras