Skip to main content

Reaktiv Workbook

A reactive Python workbook with notes, spreadsheet cells, plots, widgets, and a browser IDE. Workbooks are ordinary .workbook.py files (older .sheet.py files open too). Python 3.12 or newer is required.

A note with sliders, live numbers and a chart next to the cells it is computed from

pip install reaktiv-workbook plotly
reaktiv-workbook new --from welcome        # a guided tour of the ideas
reaktiv-workbook edit analysis.workbook.py

new creates a workbook (blank, or a copy of a bundled example with --from) and opens it. edit opens an existing workbook, or creates a new one if the path does not exist. No Node installation or separately started server is needed.

reaktiv-workbook new                          # create untitled.workbook.py and open it
reaktiv-workbook new --from welcome           # start from a bundled example (the guided tour)
reaktiv-workbook edit                         # open/create untitled.workbook.py
reaktiv-workbook edit analysis.workbook.py --port 8765
reaktiv-workbook run analysis.workbook.py        # interactive views, without authoring
reaktiv-workbook run analysis.workbook.py --headless
reaktiv-workbook check analysis.workbook.py
reaktiv-workbook evaluate analysis.workbook.py --cell total
reaktiv-workbook export analysis.workbook.py ./exports

The CLI owns the local server. Stop it with Ctrl+C. Closing the browser does not stop it. Run mode accepts input/widget changes and exposed actions, but refuses authoring, console code, and saving through the server. It is a local presentation mode, not source-code protection or a sandbox; workbook definitions are sent to the browser.

Install workbook-specific packages into the same Python environment, for example:

pip install plotly pandas

Or let the CLI install the packages a workbook declares into an environment of its own (requires uv):

reaktiv-workbook edit analysis.workbook.py --sandbox

Without --sandbox, a workbook that declares packages missing here names them; in a terminal with uv installed, the command offers to run it in a sandbox instead (Enter accepts). The package itself installs no data libraries: numpy, pandas, plotly and the like are declared by the workbooks that use them.

Coding agents can work on the open workbook through MCP:

reaktiv-workbook edit analysis.workbook.py --mcp

The server listens only on loopback, uses a per-session bearer token, and prints its browser URL in the terminal. Open only workbooks you trust: workbook code runs as ordinary Python, including enabled effects on startup. Requirements written in a workbook are installed only with --sandbox.

python analysis.workbook.py continues to evaluate the workbook; it never launches the server or IDE through its generated entry point. reaktiv-workbook FILE --check and the other evaluator options work as well.

Built on reaktiv (0.25 or later), the signal library.

This is an early release (0.1). Keep important workbooks under version control.

Metadata

Release files for reaktiv-workbook 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for reaktiv-workbook 0.1.0
File Size Uploaded Provenance Actions
reaktiv_workbook-0.1.0.tar.gz 13.6 MB With provenance Details for reaktiv_workbook-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for reaktiv-workbook 0.1.0
File Interpreter ABI Platform Actions
reaktiv_workbook-0.1.0-py3-none-any.whl Python 3 none any Details for reaktiv_workbook-0.1.0-py3-none-any.whl

Total release size: 27.5 MB

Release files / reaktiv_workbook-0.1.0.tar.gz

Download URL reaktiv_workbook-0.1.0.tar.gz
Size 13.6 MB
Tags Source
SHA-256 checksum
How to use checksums
fed5ce9037ec83feae83437ae8f6a812c45eae2142cdfbed4cc244ff22dc9b13
BLAKE2b-256 checksum
How to use checksums
667b58afd191c900381701e74895948c8c2c0d00ed202bc3d1e577754b2c8b72
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Release files / reaktiv_workbook-0.1.0-py3-none-any.whl

Download URL reaktiv_workbook-0.1.0-py3-none-any.whl
Size 13.9 MB
Tags Python 3
SHA-256 checksum
How to use checksums
59871ab6c21effcb7dd8b75b0b396208623c5bfc500eba9631fab645dbc63beb
BLAKE2b-256 checksum
How to use checksums
b12143a6e5f2b86db3fbd9734324ef970996866e50d67c40e0ca4590c1de49d7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Security for reaktiv-workbook 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for reaktiv_workbook-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page