omero-integration
Securely inspect and automate microscopy data workflows against OMERO.server with omero-py, BlitzGateway, OMERO CLI, tables, annotations, ROIs, rendering, and documented OMERO.web APIs. Use for scoped OMERO inventory, metadata export, import/export planning, or reviewed write workflows.
- License 许可
- MIT
- 最近更新
- 2026-10-22
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- omero-integration
- license
- MIT
- metadata
- { "version": "1.3", "openclaw": { "envVars": [ { "name": "OMERO_HOST", "required": true, "description": "OMERO.server hostname." }, { "name": "OMERO_PORT", "required": false, "description": "OMERO SSL router port; default 4064." }, { "name": "OMERO_USER", "required": false, "description": "Username when not reusing a session." }, { "name": "OMERO_PASSWORD", "required": false, "description": "Password when not reusing a session." }, { "name": "OMERO_SESSION_KEY", "required": false, "description": "Existing session key as an alternative credential." }, { "name": "OMERO_SECURE", "required": false, "description": "Secure transport toggle; default true." } ] }, "skill-author": "K-Dense Inc." }
- description
- Securely inspect and automate microscopy data workflows against OMERO.server with omero-py, BlitzGateway, OMERO CLI, tables, annotations, ROIs, rendering, and documented OMERO.web APIs. Use for scoped OMERO inventory, metadata export, import/export planning, or reviewed write workflows.
- compatibility
- Requires network access to a user-selected OMERO.server for remote operations. The 2026-07-23 snapshot uses OMERO.py 5.22.1 with ZeroC IcePy 3.6.5; OMERO supports Python 3.10-3.12 (3.12 recommended) while 3.13-3.14 remain upcoming in its support matrix. Bundled local planners require Python 3.10+ and read only named OMERO_* variables; they never load .env files.
02 资源文件 14
- 参考文档references/advanced.md9.4 KB
- 参考文档references/connection.md9.7 KB
- 参考文档references/data_access.md9.3 KB
- 参考文档references/image_processing.md7.7 KB
- 参考文档references/metadata.md8.8 KB
- 参考文档references/rois.md8.2 KB
- 参考文档references/scripts.md8.2 KB
- 参考文档references/sources.md8.1 KB
- 参考文档references/tables.md8.3 KB
- 脚本scripts/export_image_metadata.py16.3 KB
- 脚本scripts/inventory.py8.2 KB
- 脚本scripts/omero_common.py13.9 KB
- 脚本scripts/plan_transfer.py11.6 KB
- 脚本scripts/validate_config.py4.0 KB
03 SKILL.md 正文
OMERO Integration
Use current OME documentation and the smallest explicit data scope. OMERO data may contain unpublished images, identifiers, annotations, original files, and derived measurements.
Verified Baseline
This skill was refreshed on 2026-07-23:
- OMERO.server 5.6.18 (May 2026) is the current documented stable server.
- It was tested by OME with OMERO.py/omero-py 5.22.1 and OMERO.web 5.31.0.
omero-py==5.22.1requires Python 3.10 or newer. The OMERO support matrix supports 3.10 and 3.11, recommends 3.12, and still labels 3.13/3.14 “upcoming.”- OMERO 5.6 uses IcePy 3.6, with 3.6.5 prebuilt client wheels documented for Python versions through 3.12.
The pin above is a reproducible skill snapshot, not a promise that every
OMERO.server release accepts that client. For another server version, consult
its release entry and use the OMERO.py version tested with it. See
references/sources.md.
Operating Contract
- Start with local validation or a dry run. Do not connect until the user has selected the host, group, object type, IDs, and result limit.
- Read credentials only from the named
OMERO_*variables in the frontmatter. Never search parent directories or load.envfiles. - Never place a password or session key in command arguments, source code, output JSON, logs, tracebacks, or chat. A session key is a bearer credential.
- Default to
secure=True. OMERO encrypts login by default, but post-login data and the session ID may otherwise travel unencrypted.secure=Truedoes not by itself guarantee certificate hostname verification. - Bound every list, page, ROI, shape, annotation, table row, pixel plane, and local file scan. Do not turn an object request into a group-wide or cross-group export without explicit approval.
- Treat all writes separately: annotation/link creation, rendering-default saves, image creation, imports, script uploads, table writes, ownership or group changes, and deletion require an exact reviewed target.
- Close
BlitzGateway, table handles, raw stores, thumbnail stores, rendering engines, script clients, and other stateful services infinallyblocks or documented context-manager patterns. - Never connect to a real server merely to “test” examples.
Choose the Interface
- BlitzGateway (
omero-py): primary Python client for object traversal, pixels, annotations, ROIs, rendering, and services. - OMERO CLI: sessions, import scanning/import, OME-TIFF or XML export,
scripts, and administrative plugins. Most client commands are remote; import
also needs the matching server-side Java libraries through
OMERODIR. - OMERO.web
apiandwebgateway: the only OMERO.web apps that official documentation calls stable public APIs. The documented JSON API is version-discovered and has limited object coverage; it is not evidence that every webclient URL is a supported REST endpoint. - OMERO.server scripts: uploaded plugins executed by server infrastructure.
They are different from the bundled local client helpers in
scripts/.
Install a Reproducible Client
Create a Python 3.12 environment:
uv venv --python 3.12 .venv
source .venv/bin/activate
Install the exact IcePy 3.6.5 wheel matching the interpreter, OS, architecture, and wheel tags, then OMERO.py:
# Download the matching 3.6.5 wheel from the official OMERO-linked matrix.
uv pip install "/absolute/path/to/zeroc_ice-3.6.5-<matching-tags>.whl"
uv pip install "omero-py==5.22.1"
Do not substitute Ice 3.7: the OMERO 5.6 support matrix marks Ice 3.6 as recommended and 3.7 as unsupported. A plain install may attempt to compile IcePy from source; prefer a reviewed matching wheel. The upstream package is GPL-2.0-or-later; this skill’s own files are MIT.
For import/admin commands only, OMERODIR must point to a compatible extracted
OMERO.server directory. A normal remote BlitzGateway client does not require
that server tree. Read references/connection.md
before installation or authentication work.
Credentials and Connection
Set named variables in the calling environment or secret manager. Do not put
the password on an omero CLI command:
export OMERO_HOST="omero.example.org"
export OMERO_PORT="4064"
export OMERO_USER="researcher"
export OMERO_SECURE="true"
# Supply OMERO_PASSWORD through the environment/secret manager, or use
# OMERO_SESSION_KEY as an alternative. Do not echo either value.
A password-authenticated, exception-safe read pattern is:
import os
from omero.gateway import BlitzGateway
conn = None
try:
conn = BlitzGateway(
os.environ["OMERO_USER"],
os.environ["OMERO_PASSWORD"],
host=os.environ["OMERO_HOST"],
port=int(os.environ.get("OMERO_PORT", "4064")),
secure=True,
)
if not conn.connect():
raise RuntimeError("OMERO connection failed")
images = conn.getObjects(
"Image",
opts={"limit": 25, "offset": 0, "order_by": "obj.id"},
)
for image in images:
print(image.getId()) # Do not print names unless requested.
finally:
if conn is not None:
conn.close()
For existing-session and CLI prompt patterns, certificate verification,
group context, and cleanup details, read
references/connection.md.
Bundled Safe Helpers
All helpers use argparse; --help works without OMERO installed. Remote
helpers are dry-run by default and require --execute.
python -B scripts/validate_config.py --help
python -B scripts/inventory.py --help
python -B scripts/export_image_metadata.py --help
python -B scripts/plan_transfer.py --help
validate_config.py: validates only named endpoint/auth variables locally; optional DNS resolution still does not contact OMERO.inventory.py: bounded, read-only object inventory with paged JSON output.export_image_metadata.py: explicit-image annotation/ROI JSON export with redaction defaults and per-category limits; it never downloads file bytes or pixels.plan_transfer.py: local-only import scan or per-image export plan; it never invokes OMERO and never emits credential flags.
Read references/scripts.md before using them.
Capability Guide
- Connection, sessions, groups, TLS:
references/connection.md - Hierarchies, pagination, screening data, import/export:
references/data_access.md - Tags, map/file/comment annotations, namespaces:
references/metadata.md - Raw planes, tiles, thumbnails, rendering:
references/image_processing.md - ROI model, shape export, statistics caveat:
references/rois.md - Bounded table creation, paging, querying, closure:
references/tables.md - Local helpers and OMERO.server scripts:
references/scripts.md - Permissions, filesets, web/public links, destructive operations:
references/advanced.md
Final Review Before Remote Work
- Confirm server version and its tested OMERO.py pairing.
- Confirm target host, SSL router port, user/session, and one group.
- Confirm exact object IDs/types and hard limits.
- Confirm whether names, annotation values, file names, ROI labels, owner names, pixels, or original files may leave the server.
- Show the proposed output path and refuse overwrite unless explicitly allowed.
- For a write, show the mutation and target IDs separately from any read plan.
- Close every connection/service even after partial failure.
04 同仓库更多 Skills
zarr-python
Chunked N-D arrays for cloud storage (Zarr-Python 3). Compressed arrays, parallel I/O, S3/GCS via fsspec, NumPy/Dask/Xarray compatible, for large-scale scientific computing pipelines.
video-use
Edit any video by conversation. Transcribe, cut, color grade, generate overlay animations, burn subtitles — for talking heads, montages, tutorials, travel, interviews. No presets, no menus. Ask questions, confirm the plan, execute, iterate, persist. Production-correctness rules are hard; everything else is artistic freedom.
venue-templates
Prepare journal manuscripts, conference papers, research posters, and grant documents using venue-specific formatting guidance and bundled LaTeX scaffolds. Use when selecting an official template, checking current page or anonymity rules, adapting academic writing to a venue, or inspecting a submission PDF.
vaex
Use this skill for processing and analyzing large tabular datasets (billions of rows) that exceed available RAM. Vaex excels at out-of-core DataFrame operations, lazy evaluation, fast aggregations, efficient visualization of big data, and machine learning on large datasets. Apply when users need to work with large CSV/HDF5/Arrow/Parquet files, perform fast statistics on massive datasets, create visualizations of big data, or build ML pipelines that do not fit in memory.
usfiscaldata
Query the U.S. Treasury Fiscal Data REST API for federal financial data. No API key required. Use for national debt (Debt to the Penny), Daily Treasury Statements, Monthly Treasury Statements, Treasury securities auctions, interest rates, foreign exchange rates, savings bonds, or U.S. government revenue and spending statistics.
uncertainty-and-units
Track physical units and propagate measurement uncertainty in scientific calculations using pint and uncertainties. Use for unit conversion and dimensional checking, GUM uncertainty budgets, Type A and Type B evaluation, coverage factors and expanded uncertainty, Monte Carlo propagation, significant-figure and plus-minus reporting, error propagation through curve fits, CODATA constants, auditing Python code for stripped units or broken uncertainty propagation, and order-of-magnitude plausibility checks using dimensionless groups (Reynolds, Peclet, Damkohler, Knudsen, Biot, Womersley), characteristic scales such as diffusion time or Debye length, and observed magnitude ranges. Trigger on "is this number physically reasonable", "sanity check these units", "what regime is this flow in", or a result that looks off by orders of magnitude.