arbok-inspector 🐍🔎
arbok_inspector is an browser based inspection and visualization utility for QCoDeS measurement databases. It provides a lightweight GUI and CLI to browse runs and visualize data.
Features 🛠️
The most commonly used used tool to visualize QCoDeS databases is plottr. Plottr is a great tool to get started, but struggles with increasing abounts of data.
This is how arbok_inspector streamlines your data inspection:
- Fast browsing of measurement runs and their metadata
- Written with nicegui acting as a tailwind wrapper
- Browser based approach ensures cross system compatibily
- Selected runs are opened in a new tab and run on a separate thread
- this avoids blocking the entire application when loading big datasets
- plotting backend is plotly which natively returns html
- plotly plot customization is declarative and can therefore be tweaked in a simple json editor without implementing each customization by hand
- runs are only loaded on demand
- startup time in plottr can be several minutes for large databases
- SQL queries load only the given days upon database selection, only loads respective runs once day is selected
Installation 📲
From pypi install using pip in your environment:
pip install arbok-inspector
Even better if you are using uv, a uv.lock file is included!
Launch from CLI:
arbok-inspector
Project layout
main.py— app entrypoint and startup logicstate.py— application state & database handlingpages/— NiceGUI pages (database browser, run view, greeter, ...)widgets/— reusable UI widgets (grid builders, selectors, dialogs)analysis/— analysis and data-prep utilitiesclasses/— small domain objects used across the apphelpers/— formatting and utility helpers
Development & testing 🛠️
Clone this git repository and navigate into it. Use an editable install for local development to pick up changes immediately
pip install -e .
To launch the app in editable mode launch from dev.py file:
arbok-inspector-dev
Note, this will likely not work on Windows! Try python -m dev while being in the arbok_inspector directory.
Contributing & help 🙌
Contributions, bug reports, and small feature requests are welcome. If you want to add a visualization or a new page, use pages/ and widgets/ for examples of how UI components are composed. When opening a PR, please keep changes focused and include a short description of how to exercise the change locally.
License
See the LICENSE file in the project root for license details.
1 maintainer
Metadata
1 maintainer
Release files for arbok-inspector 1.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| arbok_inspector-1.4.0.tar.gz | 213.1 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| arbok_inspector-1.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 261.8 kB
Release files / arbok_inspector-1.4.0.tar.gz
| Download URL | arbok_inspector-1.4.0.tar.gz |
|---|---|
| Size | 213.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fba62ea9c631d5484a6d5b10a0ae446b7d7bd2a1f7e24bb8e4f39e86da7b613a
|
|
BLAKE2b-256 checksum How to use checksums |
db75b91eca8c3361e2239cfadbd8319dde504308436f8a79786cd373d9738561
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 May 19, 2026.
Transparency logRelease files / arbok_inspector-1.4.0-py3-none-any.whl
| Download URL | arbok_inspector-1.4.0-py3-none-any.whl |
|---|---|
| Size | 48.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
dfdb99e2705107f15892e4e314479f0029081d48046852aa9e62763fe54b14f3
|
|
BLAKE2b-256 checksum How to use checksums |
86cd0ddb64a1bccd66ee3a336b7bf660e8b6356e7c4cd155ef604fec77adeb82
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 May 19, 2026.
Transparency logSecurity for arbok-inspector 1.4.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
All 2 files in this release have been uploaded with provenance metadata.
Attestation for arbok_inspector-1.4.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 May 19, 2026.
Transparency logA 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.
