K-Dense-AI/scientific-agent-skills / skills/omero-integration
omero-integration
VerifiedInspects and automates microscopy data workflows against OMERO.server with omero-py, BlitzGateway, OMERO CLI, tables, annotations, ROIs, rendering, and documented OMERO.web APIs. Use this skill for scoped OMERO inventory, metadata export, import/export planning, or reviewed write workflows.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 10.9 KB |
| references/advanced.md | markdown | 10.4 KB |
| references/connection.md | markdown | 10.7 KB |
| references/data_access.md | markdown | 9.9 KB |
| references/image_processing.md | markdown | 7.7 KB |
| references/metadata.md | markdown | 9.1 KB |
| references/rois.md | markdown | 8.9 KB |
| references/scripts.md | markdown | 8.7 KB |
| references/sources.md | markdown | 10.9 KB |
| references/tables.md | markdown | 8.6 KB |
| scripts/export_image_metadata.py | script | 17.1 KB |
| scripts/inventory.py | script | 8.2 KB |
| scripts/omero_common.py | script | 14.2 KB |
| scripts/plan_transfer.py | script | 12.0 KB |
| scripts/validate_config.py | script | 4.0 KB |
references/sources.md
View on GitHub# Official Sources and Version Snapshot
Research date: **2026-09-30**
This file records the authoritative basis for skill version 1.6. The snapshot
must not replace checking the target server's own version and discovery
endpoints.
## Versions and Tested Pairing
- **OMERO.server 5.6.18** — May 2026 bug-fix release.
- **OMERO.py / `omero-py` 5.23.0** — latest PyPI release, 2026-07-30.
The server history still records testing with **5.22.1** (2026-03-25).
- **OMERO.web 5.33.2** — latest PyPI release. **5.31.0** remains the version
recorded as tested with OMERO.server 5.6.18.
- **Bio-Formats 8.5.0** — bundled by OMERO.server 5.6.18.
- **ZeroC IcePy 3.6.5** — exact client binding version in current official
installation examples and OMERO-linked wheel matrix.
The OMERO.server history explicitly says 5.6.18 was tested with OMERO.py
5.22.1 and OMERO.web 5.31.0. That tested pairing is stronger evidence than
assuming compatibility from package version numbers.
## Release and Package Metadata
- OMERO version history
https://omero.readthedocs.io/en/stable/users/history.html
Basis for server 5.6.18, tested client/web pairing, and Bio-Formats 8.5.0.
- `omero-py` on PyPI
https://pypi.org/project/omero-py/
Basis for latest 5.23.0, its 2026-07-30 release, Python `>=3.10`, IcePy 3.6,
NumPy/Pillow requirements, OMERODIR notes, and GPL-2.0-or-later package
license.
- Official OME `omero-py` repository and changelog
https://github.com/ome/omero-py
https://github.com/ome/omero-py/releases/tag/v5.23.0
https://github.com/ome/omero-py/blob/v5.23.0/src/omero/gateway/__init__.py
Source check for gateway signatures, session lifecycle, context forwarding,
annotation materialization, channel inversion, and ROI/model handling.
The 5.23.0 release adds default-group CLI support and shape externalInfo
loading; it does not announce IRoi removal.
- Current OMERO.web package and API implementation
https://pypi.org/project/omero-web/
https://github.com/ome/omero-web/blob/v5.33.2/omeroweb/api/urls.py
https://github.com/ome/omero-web/blob/v5.33.2/omeroweb/api/views.py
https://github.com/ome/omero-web/blob/v5.33.2/omeroweb/webgateway/views.py
Cross-check for discovery, ROI routes, list defaults, login body/cookies,
version 0.2 and Project/Dataset/Screen save support.
- Official OME OMERO.server component releases
https://github.com/ome/omero-server/releases
Cross-check for current server component releases.
## Installation and Compatibility
- OMERO Python language bindings
https://omero.readthedocs.io/en/stable/developers/Python.html
Basis for the current `omero-py==5.22.1` examples, IcePy 3.6.5 ordering,
BlitzGateway patterns, objects, annotations, tables, ROIs, pixels, and
rendering.
- OMERO version requirements
https://omero.readthedocs.io/en/stable/sysadmins/version-requirements.html
Basis for Python 3.10/3.11 support, Python 3.12 recommendation,
Python 3.13/3.14 “upcoming” status, Ice 3.6 recommendation, Ice 3.7
unsupported status, and server platform/runtime matrix.
- OMERO-linked Glencoe Ice binary matrix
https://www.glencoesoftware.com/blog/2023/12/08/ice-binaries-for-omero.html
Basis for exact prebuilt IcePy 3.6.5 wheel coverage through Python 3.12.
Glencoe is identified in OME's Python installation page as its commercial
partner. Select the exact wheel from the linked release repositories.
- OMERO CLI installation
https://omero.readthedocs.io/en/stable/users/cli/installation.html
Basis for client installation and import/admin prerequisites.
## Connection and Security
- BlitzGateway documentation
https://omero.readthedocs.io/en/stable/developers/PythonBlitzGateway.html
Basis for context-manager closure, wrappers/lazy loading, stateless versus
stateful service reuse, and stale stateful proxies after reconnection.
- Server security and firewalls
https://omero.readthedocs.io/en/stable/sysadmins/server-security.html
Basis for login encryption, optional full transport encryption, session-ID
exposure on insecure post-login traffic, and default router ports 4063/4064.
- Client/server SSL verification
https://omero.readthedocs.io/en/stable/sysadmins/client-server-ssl.html
Basis for the warning that standard clients do not automatically verify the
host and for the documented IceSSL verification properties.
- CLI session management
https://omero.readthedocs.io/en/stable/users/cli/sessions.html
Basis for prompted login, session files, `omero sessions`, group switching,
`-k` session reuse, and logout.
## Data, Metadata, ROIs, and Tables
- OMERO Python examples
https://omero.readthedocs.io/en/stable/developers/Python.html
Primary current examples for bounded `getObjects`, annotations, pixels,
rendering, tables, and ROI model operations.
- OMERO.tables
https://omero.readthedocs.io/en/stable/developers/Tables.html
Basis for current column signatures, reads, queries, paging, global locking,
and HDF implementation details.
- Structured annotations
https://omero.readthedocs.io/en/stable/developers/Model/StructuredAnnotations.html
Basis for annotation type hierarchy, namespaces, and link semantics.
- OME ROI model 5.6.3
https://docs.openmicroscopy.org/ome-model/5.6.3/developers/roi.html
Basis for the eight shape types, optional TheZ/TheT/TheC, RGBA fields, and
union-of-2D-shapes representation. The page itself was last updated in 2018
but documents the June 2016 schema still used by OMERO 5.6.
- Current generated `IRoi` API
https://docs.openmicroscopy.org/omero-blitz/5.8.5/slice2html/omero/api/IRoi.html
Basis for the explicit `IRoi` deprecation warning.
- OMERO application services
https://omero.readthedocs.io/en/stable/developers/Modules/Api.html
Basis for service categories and current `IRoi`/`IShare` deprecation status.
## CLI Import, Export, and Download
- Import images
https://omero.readthedocs.io/en/stable/users/cli/import.html
Basis for `omero import`, `-f` serverless scanning, target syntax,
depth/output options, experimental parallelism warning, and diagnostic
upload disclosure.
- Import targets
https://omero.readthedocs.io/en/stable/users/cli/import-target.html
Basis for current-group target behavior and target syntax.
- Export images
https://omero.readthedocs.io/en/stable/users/cli/export.html
Basis for OME-TIFF/XML-only export and experimental Dataset iteration.
- Current `omero-py==5.23.0` CLI help (`omero download -h`)
Verified in an isolated environment on 2026-09-30. Basis for explicit
OriginalFile, FileAnnotation, Image, and Fileset download forms. This was
cross-checked against the official `ome/omero-py` package.
## OMERO.web and Public Data
- OMERO.web framework
https://omero.readthedocs.io/en/stable/developers/Web.html
Basis for treating only `api` and `webgateway` as stable public APIs and
treating other app URLs as internal.
- OMERO JSON API
https://omero.readthedocs.io/en/stable/developers/json-api.html
Basis for version discovery, API version headers, CSRF/login behavior,
pagination/maxLimit, ROI endpoints, and limited create/update object types.
- Publishing data using OMERO.web
https://omero.readthedocs.io/en/stable/sysadmins/public.html
Basis for dedicated read-only public groups/users, GET-only default, URL
filters, and publication URL examples.
- OMERO configuration properties
https://omero.readthedocs.io/en/stable/sysadmins/config.html
Basis for public-user defaults (`enabled=false`, `get_only=true`, and a
URL filter that allows nothing until configured).
## Review Evidence and Endpoint Coverage
The 2026-09-30 review read all bundled scripts and references, the stable OME
release/JSON API pages, current PyPI metadata, and official source at
`ome/omero-py` v5.23.0 and `ome/omero-web` v5.33.2. Direct extraction of
Read the Docs pages returned HTTP 403, so the corresponding source files in
[OME's documentation repository](https://github.com/ome/omero-documentation)
were used alongside browser-readable pages. The generated IRoi definition and
OME ROI model were fetched directly.
| Surface used by this skill | Verified contract |
| --- | --- |
| `GET /api/`, `GET /api/v0/` | `data` versions, `url:base` and discovered starting links; current API header is 0.2, independent of server release. |
| `GET /api/v0/servers/`, `GET /api/v0/token/` | Server IDs and CSRF value in `data`; the latter is not a bearer credential endpoint. |
| `POST /api/v0/login/` | Form parameters `server`, `username`, `password`; session cookies and CSRF; current 5.33.2 source also accepts JSON. Response includes sensitive `eventContext` and `success`. |
| `GET /api/v0/m/rois/` | `image`, `group`, `owner`, `limit`, `offset`, `normalize`; `data` includes shapes, `meta` reports pagination. Also `/api/v0/m/images/{image_id}/rois/`. |
| JSON object writes (capability description only) | `POST`/`PUT` through discovered `url:save`; model support remains Project/Dataset/Screen, with explicit group and schema `@type`. No generic Image write endpoint implied. |
| BlitzGateway / Ice services | Not HTTP endpoints. Checked gateway, IQuery/IUpdate, IRoi, RawFileStore, pixel/rendering, SharedResources/Table and model signatures against source/generated API. Direct proxy calls need the selected group context. |
| CLI | Session, group, download, import target/scan/depth, export and script upload/launch syntax checked against current source/help; import additionally needs the server Java distribution. |
| Public webclient links | Navigation examples, not a supported API contract or proof of public access. |
Local checks installed OMERO.py 5.22.1 and 5.23.0 with the OMERO-linked
macOS universal IcePy 3.6.5 wheel on Python 3.12. Real annotation/shape model regression tests
and CLI help ran without a server. All Python documentation blocks were
syntax-checked. Pure local planners and mocked group/session tests ran in the
repository suite. No login, remote read/write, import, export, rendering,
server script, table service, or deployed HTTP API was executed. These examples
remain illustrative until validated against the selected installation.
## Known Documentation Tensions
- PyPI declares Python `>=3.10` without an upper bound, while the OMERO support
matrix currently supports through 3.12 and marks 3.13/3.14 upcoming.
Installation is also constrained by matching IcePy wheels. This skill uses
Python 3.12 as the reproducible recommendation.
- Current Python docs still demonstrate `IRoi` while the generated API marks
the interface deprecated. The skill documents and isolates this dependency
rather than pretending a replacement is official.
- OMERO.web documents webclient publication links, while separately stating
that webclient is not a stable public API. Durable publication links should
use administrator-managed redirects/DOIs.
- `secure=True` encrypts traffic but standard clients do not automatically
provide full hostname verification. High-assurance deployments need the
administrator-provided IceSSL trust/name configuration.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |