labnotes
Browse experiment designs, notes, and run data from a folder.
uvx labnotes server
labnotes reads two folders, named in a .labnotes.toml at the project root:
experiments = "experiments"
data = "data"
Both keys are optional and default to the values above. Paths are relative to
.labnotes.toml, or absolute, or start with ~. labnotes reads the file from
the working folder, or from the path given with -c.
experimentsholds one subfolder per experiment, each with adesign.yaml(with astudykey) and any number of markdown notes.dataholds the run data and a.dirsql.tomlthat declares arunstable with astudycolumn. An experiment's runs are the rows whosestudymatches 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.
-h/--host and -p/--port change where it listens; -h 0.0.0.0 (or a
Tailscale IP) serves beyond localhost. Every other uvicorn option passes
through: --reload, --workers, --proxy-headers, --root-path, the
--ssl-* set, and the rest. labnotes server --help lists them. --experiments-folder
and --data-folder, or LABNOTES_EXPERIMENTS_FOLDER and
LABNOTES_DATA_FOLDER, override .labnotes.toml.
Agent skill
npx skills add thekevinscott/labnotes
The skill tells a coding agent to run labnotes context, which prints a usage
guide for the installed version.
1 maintainer
Metadata
1 maintainer
Release files for labnotes 0.0.13
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| labnotes-0.0.13.tar.gz | 88.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| labnotes-0.0.13-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 119.9 kB
Release files / labnotes-0.0.13.tar.gz
| Download URL | labnotes-0.0.13.tar.gz |
|---|---|
| Size | 88.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f5ebafad523f1eeafe81e7a9a26af3cfb6457b22a35a66ce24a80e702d15920e
|
|
BLAKE2b-256 checksum How to use checksums |
2b441bbd773ba3ff2e0a8027c3c3b876fc1a8058fb3a40c73b951c4018f92018
|
| Upload date | |
|
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.
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 Oct 17, 2026.
Transparency logRelease files / labnotes-0.0.13-py3-none-any.whl
| Download URL | labnotes-0.0.13-py3-none-any.whl |
|---|---|
| Size | 31.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d8d64b5acdceed8f75e470238f584ad90f3e9bc709f8bffb50e3d79ef720be61
|
|
BLAKE2b-256 checksum How to use checksums |
5958067cb35d0f6069187414e723ab99fc94bcffaba27d7bdb9d210eeb7449a7
|
| Upload date | |
|
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.
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 Oct 17, 2026.
Transparency log
