labnotes

Browse experiment designs, notes, and run data from a folder.

uvx labnotes --experiments-folder experiments --data-folder data

--experiments-folder holds one subfolder per experiment, each with a design.yaml (with a study key) and any number of markdown notes.
--data-folder holds the run data and a .dirsql.toml that declares a runs table with a study column. An experiment's runs are the rows whose study matches its design's.

That serves a local site at http://127.0.0.1:8000: a table of experiments, and a page per experiment with its parameters, its notes, progress per cell of the design grid, and every run so far. Both folders are watched, so a reload shows new runs and edited notes.

design.yaml keys the site reads: study, fixed, varies (each key a list of values), runs_per_cell, and completed_run, a SQL condition over the runs table that marks a run as complete. Anything else shows up as-is.

--host and --port change where it listens. --json prints the experiments as JSON and exits.

Metadata

Release files for labnotes 0.0.3

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

Source distribution (sdist)

Source distribution for labnotes 0.0.3
File	Size	Uploaded
labnotes-0.0.3.tar.gz	54.8 kB	Oct 16, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for labnotes 0.0.3
File	Interpreter	ABI	Platform	Reset
labnotes-0.0.3-py3-none-any.whl 18.4 kB Oct 16, 2026	Python 3	none	any	Details

Total release size: 73.2 kB

Release files / labnotes-0.0.3.tar.gz

Download URL	labnotes-0.0.3.tar.gz
Size	54.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`a2d6fbb75de6db1394f83e55e62f0371cef7c814e5900dd1f2d0823e1bb13457`
BLAKE2b-256 checksum How to use checksums	`67259b9363f80f3dd05ed9bc0a2df830f5184ee18193325325fddb65135312cb`
Upload date	Oct 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/thekevinscott/labnotes
Publishing commit: github.com/thekevinscott/labnotes/tree/6f76287e2ada668be00c3ff7473efdc9bef82361

Workflow

Publishing configuration: github.com/thekevinscott/labnotes/blob/6f76287e2ada668be00c3ff7473efdc9bef82361/.github/workflows/release.yml
Publishing logs: github.com/thekevinscott/labnotes/actions/runs/38901588588/attempts/1

Artifact

Subject: labnotes-0.0.3.tar.gz
SHA-256 checksum: a2d6fbb75de6db1394f83e55e62f0371cef7c814e5900dd1f2d0823e1bb13457 Verifying attestations

Release files / labnotes-0.0.3-py3-none-any.whl

Download URL	labnotes-0.0.3-py3-none-any.whl
Size	18.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`49e67c733eb4de34c7f0745da86908cf63e8c7dad2889550baaeee8f11730765`
BLAKE2b-256 checksum How to use checksums	`94121c7c870a3368760b69bcf48f5ba6e2bf77786c67f1d28b7f1ef3cb4f9963`
Upload date	Oct 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/thekevinscott/labnotes
Publishing commit: github.com/thekevinscott/labnotes/tree/6f76287e2ada668be00c3ff7473efdc9bef82361

Workflow

Publishing configuration: github.com/thekevinscott/labnotes/blob/6f76287e2ada668be00c3ff7473efdc9bef82361/.github/workflows/release.yml
Publishing logs: github.com/thekevinscott/labnotes/actions/runs/38901588588/attempts/1

Artifact

Subject: labnotes-0.0.3-py3-none-any.whl
SHA-256 checksum: 49e67c733eb4de34c7f0745da86908cf63e8c7dad2889550baaeee8f11730765 Verifying attestations