STAMP Workbench

Workbench is a notebook-style web UI for STAMP that lets users compose drag-and-drop pathology pipelines, edit task-specific parameters in an inspector, import/export YAML configs, run stages step by step or end to end, and monitor per-cell runtime logs — without touching the CLI directly.

---

Requirements

• STAMP installed (≥ v2.4.0)
• Python ≥ 3.11

---

Installation

1. Install STAMP (if not already done):

git clone https://github.com/KatherLab/STAMP.git
cd STAMP
uv sync --extra gpu          # or --extra cpu for CPU-only

2. Add the workbench to the same environment:

source .ven/bin/activate    # activate STAMP environment
uv pip install git+https://github.com/KatherLab/STAMP-Workbench

3. Launch:

stamp-workbench
# or with custom host/port:
stamp-workbench --host 0.0.0.0 --port 8010

Then open the printed URL in your browser.

Repository structure

STAMP-Workbench/
├── pyproject.toml               # standalone package definition
└── stamp_workbench/
    ├── __init__.py
    ├── catalog.py          # task/field definitions for all STAMP pipeline stages
    ├── __main__.py         # `python -m stamp_workbench`
    ├── server.py           # HTTP server + direct package entry point
    ├── service.py          # pipeline validation, execution, run monitoring
    └── static/
        ├── index.html
        ├── app.js
        └── styles.css

For direct debugging, the package also exposes:

stamp-workbench --host 127.0.0.1 --port 8010

The recommended user flow remains:

uv pip install git+https://github.com/KatherLab/STAMP-Workbench.git
stamp-workbench

---

License

Same as STAMP — MIT.