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.1

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.1
File Size Uploaded Provenance Actions
reaktiv_workbook-0.1.1.tar.gz 13.6 MB With provenance Details for reaktiv_workbook-0.1.1.tar.gz

Built distribution (wheel)

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

Total release size: 27.5 MB

Release files / reaktiv_workbook-0.1.1.tar.gz

Download URL reaktiv_workbook-0.1.1.tar.gz
Size 13.6 MB
Tags Source
SHA-256 checksum
How to use checksums
e528f3be28dc0a851f87447e00687340d462b15a392e8fad25af5f501dc304de
BLAKE2b-256 checksum
How to use checksums
199eb8ac244192f05033270e1360a113590836d2515420c0140fcc596b6d2dd4
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.1-py3-none-any.whl

Download URL reaktiv_workbook-0.1.1-py3-none-any.whl
Size 13.9 MB
Tags Python 3
SHA-256 checksum
How to use checksums
36223d70fbd0a68ad73242c8bfe19705de73237087a99f0def32dddf8aa3e029
BLAKE2b-256 checksum
How to use checksums
92824fe3d03b39d5efdf39b8ad126f3d92e02c8bc98be3dc8d0636367fbe0556
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.1

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.1.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.1 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