Inspect, author, validate, and run high-content microscopy workflows.
Copy the AI prompt to install this server into Claude Code, Cursor, or another agent β or use 1-click editor setup below.
π‘ Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
Turn high-content microscopy images into reproducible measurements
One reviewable workflow across the GUI, Python, CellProfiler, and local agents
OpenHCS is designed for imaging scientists and research software teams running high-content studies where many wells, sites, channels, Z planes, or time points must be analysed consistently. Source selection, processing steps, and result definitions stay together in one validated pipeline instead of being split across interface-only state, scripts, and automation.
It is a good fit when a workflow must remain reviewable across visual editing,
code, and automation. The same pipeline can be edited in the desktop GUI or as
Python, imported from supported CellProfiler .cppipe files, and built or
reviewed through the local MCP surface.
Windows installer Β· macOS installer Β· Installation options
The graphical installers set up an isolated CPU-safe desktop environment with the OpenHCS GUI, CellProfiler compatibility, local MCP server, Napari, Fiji/ImageJ, and Bio-Formats. GPU libraries remain optional.
Browse the UI and viewer gallery Β· Watch an agent build, debug, run, and inspect a workflow
OpenHCS processes large microscopy datasets with a compile-then-execute architecture. Pipelines are validated across the selected execution axes before processing starts, preventing late failures after expensive work. Design pipelines in the GUI, export to Python, edit as code, and re-import β switching between visual and programmatic workflows. The local MCP exposes that same workflow model to supported agents, so agent-authored pipelines remain visible, editable, and reviewable in the GUI and generated Python.
π‘οΈ Compile-Time ValidationConfiguration is resolved once into step snapshots and a compilation session. Typed plans then validate sources, artifacts, materialization, memory contracts, and worker requirements before execution begins. Errors surface immediately, not after hours of processing. |
π Bidirectional GUI β CodeDesign pipelines visually, export as executable Python, edit in your IDE, re-import to the GUI. Code generation works at any scope level β function patterns, individual steps, pipeline configs, full orchestrator scripts β any window holding objects can generate and re-import code. |
π§ Agent-Assisted WorkflowsGive a supported MCP client a microscopy folder or plate and an analysis goal. It can inspect the connected execution server's functions, build and validate a typed pipeline, run it, inspect results in OpenHCS or a viewer, and revise the generated Python. A built-in code assistant can also use local Ollama or configured remote LLM endpoints. |
β‘ Full Multiprocessing & Multi-GPUBounded worker lanes use |
π Any Python FunctionRegister any Python function by decorating it with |
π Results MaterializationCallable and module artifact contracts declare semantic outputs independently of Python argument names. The artifact graph and materialization plans route images, measurements, object labels, relationships, tables, and files to their configured stores and exporters. |
π¬ Process-Isolated Napari & FijiStream images to Napari and Fiji/ImageJ in real time during pipeline execution. OpenHCS |
πͺ Live Cross-Window UpdatesEdit a value in |
𧬠CellProfiler Pipeline ImportOpen |
π€ MCP Agent AutomationUse the local stdio MCP server with ChatGPT desktop, Codex, Claude Desktop, and other supported clients, or deploy the separately secured HTTP surface. The graphical installers register detected local clients automatically. Capability profiles, schemas, knowledge, UI attachment, authoring, execution, runtime inspection, viewer review, and governed custom-function registration are projected from typed authorities rather than duplicated tool lists. |
OpenHCS is built on 8 purpose-extracted, separately published libraries β each solving a general problem and all composed into one platform:
| Library | Role in OpenHCS | What It Does |
|---|---|---|
| ObjectState | Configuration framework | Lazy dataclasses with dual-axis inheritance (context hierarchy Γ class MRO) and contextvars-based resolution |
| ArrayBridge | Memory type conversion | Unified API across NumPy, CuPy, PyTorch, JAX, TensorFlow, pyclesperanto with DLPack zero-copy transfers |
| PolyStore | Unified I/O & stream payloads | Generic storage and streaming payload primitives, backend lifecycle, virtual workspaces, atomic writes, format detection, and ROI extraction |
| ZMQRuntime | Process & transport runtime | Generic request, status, progress, cancellation, process-lifecycle, and viewer-control transport protocols |
| PyQT-reactive | UI form generation | React-style reactive forms from dataclasses with cross-window sync and flash animations |
| pycodify | Code β object conversion | Python source as serialization format β type-preserving, diffable, editable, with collision handling |
| python-introspect | Signature analysis | Pure-Python function/dataclass introspection for automatic UI generation and contract analysis |
| metaclass-registry | Plugin discovery | Zero-boilerplate registry system powering microscope handler and storage backend auto-discovery |
|
Image Sources
Source handlers are auto-detected and extensible through |
Functions β Automatic Discovery
The connected execution server owns the available catalog, so remote GPU and
custom-function availability is reflected without a manually maintained list.
|
Processing domains: image preprocessing Β· segmentation Β· cell counting Β· stitching (MIST + Ashlar GPU) Β· neurite tracing Β· morphology Β· measurements
For most desktop users, download the Windows installer or macOS installer. Neither download requires ZIP extraction or an existing Python installation.
For a manual installation, create a virtual environment and install the same CPU-safe desktop surface as the graphical installers:
Smaller environments can select only the required features:
The GUI and execution services consume the same list[FunctionStep],
PipelineConfig, and typed execution bundle. See the
API orientation for the explicit
low-level execution call and progress lifecycle.
The gpu extra requires a compatible CUDA 12 environment on a supported
NVIDIA platform. For a CPU-only
desktop installation, install openhcs[gui] without the gpu extra.
OMERO requires zeroc-ice, whose compatible wheels are not published through
the normal project metadata. Install the helper requirements before the extra:
Equivalent requirements-file installation:
Supported on Python 3.11 and 3.12. See Glencoe Software for manual installation.
| π Read the Docs | Full API docs, tutorials, guides |
| ποΈ Architecture | Typed compiler Β· sources Β· artifacts Β· runtime values Β· package boundaries |
| π Getting Started | Installation Β· First pipeline |
The authoring surface remains an ordered linear step list. ObjectState inheritance keeps defaulted configuration sparse, while compilation derives and exposes the exact source and artifact dependencies required for execution; the derived dependency graph is not a second workflow the user must author.
Pipelines are compiled for every selected execution axis before processing begins. Runtime workers consume the compiled bundle rather than reinterpreting mutable declaration objects. Read more β
Resolution walks two axes simultaneously: the context stack (Global β Pipeline β Step) and the class MRO (inheritance chain). Built on contextvars for thread-safe, scope-isolated resolution. Preserves None vs concrete value distinction for proper field-level inheritance. Powered by ObjectState. Read more β
Any window holding ObjectState objects can generate and re-import executable Python:
Each scope encapsulates all lower-scope imports. Generated code is fully executable without additional setup. Edit in your IDE or external editor, save, and the GUI re-imports via AST parsing. Powered by pycodify + python-introspect. Read more β
A class-level registry tracks all active form managers. When a value changes in any config window, Qt signals propagate the change to every affected window with debounced, scope-isolated refreshes. Global β Pipeline β Step cascading with per-orchestrator isolation. Powered by PyQT-reactive. Read more β
StreamingConfig declarations plus the Napari/Fiji adapters own viewer identity, display, and application policy.python-introspect + metaclass-registryArrayBridge@numpy, @cupy, @pyclesperanto, etc. is auto-integrated with contracts, UI forms, and the function registryContribution areas: microscope formats Β· processing functions Β· GPU backends Β· documentation
MIT β see LICENSE.
OpenHCS evolved from EZStitcher and builds on Ashlar (stitching), MIST (phase correlation), pyclesperanto (GPU image processing), and scikit-image (image analysis).
OpenHCS's CellProfiler interoperability and parity validation build on the CellProfiler project's open-source software, documentation, and public example, tutorial, and benchmark materials. We thank the CellProfiler authors and contributors and the authors of the biological datasets they distribute. Please cite CellProfiler following its official citation guidance, including Stirling et al., CellProfiler 4: improvements in speed, utility and usability (2021).
Third-party project names and logos identify supported integrations, compatible clients, or software used by OpenHCS. They remain the property of their respective projects or owners; their appearance does not imply affiliation or endorsement.
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
[](https://allmcps.com/mcp/openhcs)<a href="https://allmcps.com/mcp/openhcs"><img src="https://allmcps.com/api/badge/openhcs?style=directory" alt="OpenHCS on AllMCPs" /></a>