# Omero Integration

> Inspecciona y automatiza de forma segura flujos de datos de microscopía en OMERO.server con omero-py, BlitzGateway, la CLI de OMERO, tablas, anotaciones, ROIs, renderizado y las APIs documentadas de OMERO.web.

Fuente: https://skillsagentes.com/skills/k-dense-ai/scientific-agent-skills/omero-integration
Markdown: https://skillsagentes.com/skills/k-dense-ai/scientific-agent-skills/omero-integration.md

Repositorio: https://github.com/K-Dense-AI/scientific-agent-skills
Autor: K-Dense-AI
Licencia: MIT
Actualizado: el mes pasado
Coste de contexto: 72 tok instalada, 2.3k tok al activarse, 36.1k tok con todos los archivos del bundle
Bundle: 15 archivos, 141 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add K-Dense-AI/scientific-agent-skills --skill omero-integration --agent claude-code
# Cursor
npx -y skills add K-Dense-AI/scientific-agent-skills --skill omero-integration --agent cursor
# Codex
npx -y skills add K-Dense-AI/scientific-agent-skills --skill omero-integration --agent codex
# Gemini CLI
npx -y skills add K-Dense-AI/scientific-agent-skills --skill omero-integration --agent gemini
# Windsurf
npx -y skills add K-Dense-AI/scientific-agent-skills --skill omero-integration --agent windsurf
# Cline
npx -y skills add K-Dense-AI/scientific-agent-skills --skill omero-integration --agent cline
```

## Qué hace

- Conecta con BlitzGateway usando credenciales leídas solo de variables OMERO_* y cierra siempre las conexiones y servicios
- Hace inventario de objetos OMERO acotado y paginado, solo lectura, con scripts/inventory.py
- Exporta metadatos de anotaciones y ROIs de imágenes concretas a JSON, sin descargar bytes de archivo ni píxeles
- Planifica escaneos de importación o exportación por imagen de forma local, sin conectarse a OMERO
- Trata cada escritura (anotaciones, renderizado, importaciones, borrados) como una operación separada que exige un objetivo exacto revisado

## Cuándo usarla

- Se necesita un inventario acotado de objetos OMERO o exportar metadatos de imágenes
- Se planifica una importación o exportación de datos de microscopía antes de ejecutarla
- Se van a revisar flujos de escritura en OMERO.server (anotaciones, ROIs, renderizado, borrados)

## Qué la activa

- "Haz un inventario de las imágenes de este proyecto en OMERO"
- "Exporta las anotaciones y ROIs de esta imagen de OMERO a JSON"
- "Planifica la exportación de estas imágenes antes de conectarme a OMERO"

## Antes de instalar

- Necesita acceso de red a un OMERO.server elegido y las variables OMERO_HOST, OMERO_USER/OMERO_PASSWORD u OMERO_SESSION_KEY; el cliente usa Python 3.10-3.12 con omero-py 5.22.1 e IcePy 3.6.5.
- Necesita en el PATH: python
- Variables de entorno: OMERO_HOST, OMERO_PASSWORD, OMERO_PORT, OMERO_USER
- needs API credentials

## Archivos

- SKILL.md — 9 KB
- references/advanced.md — 9 KB
- references/connection.md — 10 KB
- references/data_access.md — 9 KB
- references/image_processing.md — 8 KB
- references/metadata.md — 9 KB
- references/rois.md — 8 KB
- references/scripts.md — 8 KB
- references/sources.md — 8 KB
- references/tables.md — 8 KB
- scripts/export_image_metadata.py — 16 KB
- scripts/inventory.py — 8 KB
- scripts/omero_common.py — 14 KB
- scripts/plan_transfer.py — 12 KB
- scripts/validate_config.py — 4 KB

## SKILL.md

Reproducido tal cual desde K-Dense-AI/scientific-agent-skills bajo MIT. Esta sección es el documento original y está en inglés.

# 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.1` requires 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`](references/sources.md).

## Operating Contract

1. 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.
2. Read credentials only from the named `OMERO_*` variables in the frontmatter.
   Never search parent directories or load `.env` files.
3. 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.
4. Default to `secure=True`. OMERO encrypts login by default, but post-login
   data and the session ID may otherwise travel unencrypted. `secure=True` does
   not by itself guarantee certificate hostname verification.
5. 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.
6. 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.
7. Close `BlitzGateway`, table handles, raw stores, thumbnail stores, rendering
   engines, script clients, and other stateful services in `finally` blocks or
   documented context-manager patterns.
8. 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 `api` and `webgateway`**: 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:

```bash
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:

```bash
# 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`](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:

```bash
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:

```python
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`](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`.

```bash
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`](references/scripts.md) before using them.

## Capability Guide

- Connection, sessions, groups, TLS:
  [`references/connection.md`](references/connection.md)
- Hierarchies, pagination, screening data, import/export:
  [`references/data_access.md`](references/data_access.md)
- Tags, map/file/comment annotations, namespaces:
  [`references/metadata.md`](references/metadata.md)
- Raw planes, tiles, thumbnails, rendering:
  [`references/image_processing.md`](references/image_processing.md)
- ROI model, shape export, statistics caveat:
  [`references/rois.md`](references/rois.md)
- Bounded table creation, paging, querying, closure:
  [`references/tables.md`](references/tables.md)
- Local helpers and OMERO.server scripts:
  [`references/scripts.md`](references/scripts.md)
- Permissions, filesets, web/public links, destructive operations:
  [`references/advanced.md`](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.

## Dónde encaja

- Categoría: [Datos y analítica](https://skillsagentes.com/categorias/datos-analitica.md) — Consulta, limpia y visualiza datos sin salir del agente.
- Creador: [K-Dense-AI](https://skillsagentes.com/creators/k-dense-ai.md) — 163 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Citation Management](https://skillsagentes.com/skills/k-dense-ai/scientific-agent-skills/citation-management.md): Gestión integral de citas académicas: busca en OpenAlex, PubMed y Google Scholar, extrae metadatos precisos, valida citas y genera entradas BibTeX correctamente formateadas.
- [Scientific Slides](https://skillsagentes.com/skills/k-dense-ai/scientific-agent-skills/scientific-slides.md): Crea decks de diapositivas y presentaciones para charlas de investigación: PowerPoint, presentaciones de conferencia, seminarios, defensas de tesis. Da estructura, plantillas, guía de tiempos y validación visual.
- [Literature Review](https://skillsagentes.com/skills/k-dense-ai/scientific-agent-skills/literature-review.md): Realiza revisiones bibliográficas sistemáticas y completas usando varias bases académicas (PubMed, arXiv, bioRxiv, Semantic Scholar). Genera markdown y PDF con citas verificadas en varios estilos (APA, Nature, Vancouver).
- [Infographics](https://skillsagentes.com/skills/k-dense-ai/scientific-agent-skills/infographics.md): Crea infografías profesionales con Nano Banana Pro AI y refinamiento iterativo inteligente. Usa Gemini 3.6 Flash para revisar la calidad e integra investigación con Perplexity Sonar. Soporta 10 tipos, 8 estilos y paletas para daltonismo.
- [Latex Posters](https://skillsagentes.com/skills/k-dense-ai/scientific-agent-skills/latex-posters.md): Crea pósteres de investigación profesionales en LaTeX con beamerposter, tikzposter o baposter, para conferencias y comunicación científica: layout, colores, columnas múltiples e integración de figuras.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)