Cacaopod
Cacaopod is a local, browser-based data visualizer for experimental data analysis. It combines a Python-backed workspace, an interactive plotting board, file loaders, data tools, and an embedded Python console.
Features
- Load CSV, TSV, TXT/DAT/ASC, NPY, NPZ, JSON, MAT, image files, and custom file formats.
- View 1D traces and 2D heatmaps in a browser UI.
- Run Python code against the current board and loaded data.
- Save boards, waves, tool definitions, and UI state in the working directory.
- Create custom tools, file loaders, and naming rules in Python.
Installation
pip install cacaopod
Usage
Start Cacaopod in the directory you want to use as your workspace:
cacaopod --open
By default, Cacaopod serves the app on 127.0.0.1. If the browser does not open
automatically, open the URL printed in the terminal.
You can also choose a workspace explicitly:
cacaopod --workdir /path/to/data --open
Control a running Cacaopod backend from another Python process:
import numpy as np
from cacaopod.remote import Cacaopod
cp = Cacaopod(port=8123)
cp.board.show(np.arange(100), name="name_of_pod")
wave = cp.Wave(np.arange(100), delta=0.1, offset=2.0, name="wave_name")
cp.board.show(wave, name="another_pod")
wave_on_board = cp.Wave(np.arange(50), name="wave_on_board", board="Existing Board")
cp.board.show(wave_on_board, name="pod_on_existing_board")
cp.execute("print(board.name)")
print(cp.is_alive())
Security Note
Cacaopod is designed for trusted local use. The web API can execute Python code from the embedded console and from user-defined tools. Do not expose the backend to an untrusted network or run it with a public host unless you have added your own access controls.
License
Apache-2.0. See LICENSE.
Third-party notices for the bundled web UI are included in
THIRD_PARTY_NOTICES.md.
Metadata
Release files for cacaopod 0.11.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 | Actions |
|---|---|---|---|---|
| cacaopod-0.11.0.tar.gz | 2.2 MB | Without provenance | Details for cacaopod-0.11.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| cacaopod-0.11.0-py3-none-any.whl | Python 3 | none | any | Details for cacaopod-0.11.0-py3-none-any.whl |
Total release size: 4.5 MB
Release files / cacaopod-0.11.0.tar.gz
| Download URL | cacaopod-0.11.0.tar.gz |
|---|---|
| Size | 2.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2bb62fe1693f5231331968079643f8474c973aaa03787b5c4decc350d2d161a9
|
|
BLAKE2b-256 checksum How to use checksums |
5902e9d3fb5b5e16e6d1102584ef34dd5a1c34ede564cf4001192e45fd4ee822
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.9
|
Release files / cacaopod-0.11.0-py3-none-any.whl
| Download URL | cacaopod-0.11.0-py3-none-any.whl |
|---|---|
| Size | 2.3 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fd72154fe48a6a81918464ec206501ca9e3e3a687f84d86ce6151493d8294c38
|
|
BLAKE2b-256 checksum How to use checksums |
8eaaa8d1c5cb832b46ba721e2ecd9578aa007afbd7ec69dd2290e89e08e090b7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.9
|
Security for cacaopod 0.11.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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
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.