omero-integration
Open-source bio-image data management. Use the omero-py client to connect to an OMERO server, retrieve images as numpy arrays, annotate with tags and key-value pairs, manage ROIs, and feed image data into Python analysis pipelines β programmatically, no GUI.
Install / Use
npx skills add jaechang-hits/SciAgent-Skills --skill omero-integrationInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Our assessment of omero-integration
omero-integration scores 91/100 on our quality scale, 1071st of 2,771 Automation skills we index (top 39%).
Its SKILL.md is 16 KB long, well organised into 43 sections with 18 code examples: a thorough specification that gives an agent plenty to work with.
It has 367 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 3 months ago, so omero-integration is actively maintained.
- Our last check on 2026-11-19 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit β read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-05. Automated pattern scan on 2026-10-05. It catches known dangerous patterns, not every risk β read a skill before letting an agent act on it.
omero-integration compared with similar skills
All 4 of these similar skills score higher than omero-integration; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| omero-integration (this skill)by jaechang-hits | 91 | 367 | 3mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 118.9k | 11d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 113.3k | 12d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 82.1k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 80.2k | today | CLAUDE.md |
Frequently asked questions
- How do I install omero-integration?
- Run
npx skills add jaechang-hits/SciAgent-Skills --skill omero-integration. The install tabs above show the steps for each supported agent. - Which AI agents does omero-integration work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is omero-integration safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is omero-integration still maintained?
- The repository was last updated about 3 months ago, so omero-integration is actively maintained.
Skill content
View source on GitHubname: "omero-integration" description: "Open-source bio-image data management. Use the omero-py client to connect to an OMERO server, retrieve images as numpy arrays, annotate with tags and key-value pairs, manage ROIs, and feed image data into Python analysis pipelines β programmatically, no GUI." license: "GPL-2.0"
omero-integration
Overview
OMERO is an open-source image data management system widely used in microscopy facilities and core labs. The omero-py library provides a Python client (BlitzGateway) that connects to an OMERO server, allowing programmatic access to images, datasets, projects, tags, annotations, and ROIs. Use it to build automated analysis workflows that pull images from OMERO, process them in Python, and write results back as annotations.
When to Use
- Programmatic image retrieval from OMERO: Downloading microscopy images as numpy arrays for downstream analysis without using the OMERO Insight GUI.
- Bulk annotation and tagging: Applying tags, key-value pair annotations, or comments to large numbers of images/datasets based on analysis results.
- ROI access and management: Reading segmentation ROIs (shapes) stored in OMERO for downstream quantification or export.
- Integrating OMERO into Python analysis pipelines: Connecting OMERO image data to scikit-image, OpenCV, CellPose, or other image analysis tools.
- Automated QC workflows: Querying images by metadata (channel, acquisition date, experimenter) and flagging those that fail quality criteria.
- Data provenance tracking: Attaching analysis provenance (parameters, tool versions) as structured key-value annotations to images.
- For local image analysis without an OMERO server, use
tifffile,aicsimageio, orimageiodirectly.
Prerequisites
- Python packages:
omero-py,numpy,Pillow - System: Java 8+ (required by
omero-pyinternals), Ice 3.6 (installed automatically via conda) - Data requirements: Access credentials to a running OMERO server (host, port, username, password)
- Environment: Conda is strongly recommended;
omero-pyhas complex dependencies
conda create -n omero python=3.9
conda activate omero
conda install -c ome -c conda-forge omero-py
pip install numpy Pillow
Quick Start
import omero
from omero.gateway import BlitzGateway
# Connect to OMERO server
conn = BlitzGateway("username", "password", host="omero.example.org", port=4064)
conn.connect()
print(f"Connected: {conn.isConnected()}, user: {conn.getUser().getName()}")
# Get an image by ID and download as numpy array
image = conn.getObject("Image", 12345)
pixels = image.getPrimaryPixels()
plane = pixels.getPlane(0, 0, 0) # z=0, c=0, t=0
print(f"Image shape: {plane.shape}, dtype: {plane.dtype}")
conn.close()
Core API
Module 1: BlitzGateway β Connection Management
BlitzGateway is the main entry point for all server interactions.
from omero.gateway import BlitzGateway
# Establish connection
conn = BlitzGateway(
username="user",
passwd="password",
host="omero.example.org",
port=4064,
secure=True,
)
success = conn.connect()
print(f"Connected: {success}")
print(f"Server version: {conn.getServerVersion()}")
print(f"Current group: {conn.getGroupFromContext().getName()}")
# Always close when done
conn.close()
# Context manager pattern for automatic cleanup
class OmeroConnection:
def __init__(self, **kwargs):
self.conn = BlitzGateway(**kwargs)
def __enter__(self):
self.conn.connect()
return self.conn
def __exit__(self, *args):
self.conn.close()
with OmeroConnection(username="user", passwd="pass",
host="omero.example.org", port=4064) as conn:
print(f"Connected as: {conn.getUser().getFullName()}")
Module 2: Project, Dataset, and Image Queries
Traverse the OMERO data hierarchy (Project β Dataset β Image).
# List all projects for the current user
for project in conn.listProjects():
print(f"Project {project.getId()}: {project.getName()}")
for dataset in project.listChildren():
print(f" Dataset {dataset.getId()}: {dataset.getName()}")
for image in dataset.listChildren():
print(f" Image {image.getId()}: {image.getName()}")
# Search for images by name
results = conn.searchObjects(["Image"], "GFP_control")
for img in results:
print(f" Found: {img.getId()} - {img.getName()}")
# Get a specific object by ID
image = conn.getObject("Image", 12345)
dataset = conn.getObject("Dataset", 678)
project = conn.getObject("Project", 90)
print(f"Image: {image.getName()}, size: {image.getSizeX()}x{image.getSizeY()}")
print(f"Channels: {image.getSizeC()}, Z-slices: {image.getSizeZ()}, timepoints: {image.getSizeT()}")
Module 3: Image Download as NumPy Arrays
Retrieve pixel data as numpy arrays for processing.
import numpy as np
image = conn.getObject("Image", 12345)
pixels = image.getPrimaryPixels()
# Get a single 2D plane: getPlane(z_index, channel_index, time_index)
plane = pixels.getPlane(0, 0, 0)
print(f"Plane shape: {plane.shape}, dtype: {plane.dtype}")
# Get all channels at z=0, t=0
planes = [pixels.getPlane(0, c, 0) for c in range(image.getSizeC())]
stack = np.stack(planes, axis=0) # shape: (C, Y, X)
print(f"Multi-channel stack: {stack.shape}")
# Efficient bulk download using getTiles (for large images)
image = conn.getObject("Image", 12345)
pixels = image.getPrimaryPixels()
tile_coords = [(0, 0, 0, (0, 0, 512, 512))] # (z, c, t, (x, y, w, h))
for tile in pixels.getTiles(tile_coords):
print(f"Tile shape: {tile.shape}") # (512, 512) numpy array
Module 4: Tag and Annotation Management
Add, retrieve, and update tags and key-value pair annotations on OMERO objects.
import omero
# Add a tag to an image
tag_ann = omero.gateway.TagAnnotationWrapper(conn)
tag_ann.setValue("passed_QC")
tag_ann.setNs("my.analysis.namespace")
tag_ann.save()
image = conn.getObject("Image", 12345)
image.linkAnnotation(tag_ann)
print(f"Tag '{tag_ann.getValue()}' linked to image {image.getId()}")
# Add key-value pairs (MapAnnotation) to an image
map_ann = omero.gateway.MapAnnotationWrapper(conn)
map_ann.setNs("openmicroscopy.org/omero/client/mapAnnotation")
kv_pairs = [
["analysis_tool", "CellProfiler 4.2"],
["cell_count", "342"],
["mean_intensity", "1847.3"],
["analysis_date", "2026-02-18"],
]
map_ann.setValue(kv_pairs)
map_ann.save()
image.linkAnnotation(map_ann)
print(f"Key-value annotation attached to image {image.getId()}")
# Read existing annotations
for ann in image.listAnnotations():
print(f" {ann.OMERO_TYPE}: {ann.getValue()}")
Module 5: ROI Access
Read segmentation ROIs (shapes) stored in OMERO for downstream quantification.
from omero.model import RoiI
# Get all ROIs for an image
roi_service = conn.getRoiService()
result = roi_service.findByImage(12345, None)
for roi in result.rois:
for shape in roi.copyShapes():
shape_type = shape.__class__.__name__
print(f" ROI {roi.id.val}: {shape_type}")
if shape_type == "RectangleI":
print(f" x={shape.x.val:.1f}, y={shape.y.val:.1f}, "
f"w={shape.width.val:.1f}, h={shape.height.val:.1f}")
elif shape_type == "EllipseI":
print(f" cx={shape.x.val:.1f}, cy={shape.y.val:.1f}, "
f"rx={shape.radiusX.val:.1f}, ry={shape.radiusY.val:.1f}")
# Convert ROI masks to numpy boolean arrays
import numpy as np
from omero.gateway import BlitzGateway
def roi_to_mask(shape, height, width):
"""Convert a rectangle ROI to a boolean numpy mask."""
mask = np.zeros((height, width), dtype=bool)
x = int(shape.x.val)
y = int(shape.y.val)
w = int(shape.width.val)
h = int(shape.height.val)
mask[y:y+h, x:x+w] = True
return mask
image = conn.getObject("Image", 12345)
height = image.getSizeY()
width = image.getSizeX()
result = conn.getRoiService().findByImage(12345, None)
for roi in result.rois:
for shape in roi.copyShapes():
if shape.__class__.__name__ == "RectangleI":
mask = roi_to_mask(shape, height, width)
print(f"ROI mask: {mask.sum()} pixels selected")
Key Concepts
OMERO Data Hierarchy
OMERO organizes data as Project β Dataset β Image. Images contain pixel data plus metadata (channels, Z-slices, timepoints). Annotations (tags, key-value pairs, comments) can be attached to any level of the hierarchy.
# Hierarchy navigation
project = conn.getObject("Project", 90)
for dataset in project.listChildren():
imgs = list(dataset.listChildren())
print(f"Dataset '{dataset.getName()}': {len(imgs)} images")
Pixel Access Patterns
OMERO stores pixels as (Z, C, T) stacks. getPlane(z, c, t) returns a single 2D numpy array. For large images, use getTiles to download spatial subregions. Pixel type (uint8, uint16, float32) matches the original acquisition format.
image = conn.getObject("Image", 12345)
pixels = image.getPrimaryPixels()
ptype = pixels.getPixelsType().getValue()
print(f"Pixel type: {ptype}") # e.g., "uint16"
print(f"Dimensions: XY={image.getSizeX()}x{image.getSizeY()}, "
f"Z={image.getSizeZ()}, C={image.getSizeC()}, T={image.getSizeT()}")
Common Workflows
Workflow 1: Batch Download and Analysis
Goal: Download all images from a dataset, apply processing, and store results as key-value annotations.
import numpy as np
from omero.gateway import BlitzGateway, MapAnnotationWrapper
def mean_intensity(plane):
return float(plane.mean())
conn = BlitzGateway("user", "pass", host="omero.example.org", port=4064)
conn.connect()
dataset = conn.getObject("Dataset", 678)
results = []
for image in dataset.listChildren():
pixels = image.getPrimaryPixels()
plane = pixels.getPlane(0, 0, 0) # first z, channel 0, t=0
mi = mean_intensity(plane)
results.append((image, mi))
# Attach mean intensity as key-value annotation
ann = MapAnnotationWrapper(conn)
ann.setNs("my.pipeline.v1")
ann.setValue([["mean_intensity_ch0", f"{mi:.2f}"]])
ann.save()
image.linkAnnotation(ann)
print(f"Image {image.getId()} '{image.getName()}': mean={mi:.2f}")
print(f"\nProcessed {len(results)} images in dataset '{dataset.getName()}'")
conn.close()
Workflow 2: Retrieve Images by Tag and Export
Goal: Find all images tagged "screen_hits", download channel 1 as numpy arrays, and save as TIFF files.
import numpy as np
import tifffile
from omero.gateway import BlitzGateway
conn = BlitzGateway("user", "pass", host="omero.example.org", port=4064)
conn.connect()
# Find images with a specific tag
tag_value = "screen_hits"
tagged_images = []
for ann in conn.getObjects("TagAnnotation", attributes={"textValue": tag_value}):
for image in ann.listLinkedObjects(["Image"]):
tagged_images.append(image)
print(f"Found {len(tagged_images)} images tagged '{tag_value}'")
for image in tagged_images:
pixels = image.getPrimaryPixels()
# Download DAPI channel (index 0) at z=0, t=0
plane = pixels.getPlane(0, 0, 0)
fname = f"image_{image.getId()}_DAPI.tif"
tifffile.imwrite(fname, plane)
print(f"Saved {fname}: shape={plane.shape}, dtype={plane.dtype}")
conn.close()
print("Export complete")
Key Parameters
| Parameter | Module | Default | Range / Options | Effect |
|-----------|--------|---------|-----------------|--------|
| host | BlitzGateway | required | hostname or IP | OMERO server address |
| port | BlitzGateway | 4064 | 1024β65535 | OMERO server port (4064 = standard) |
| secure | BlitzGateway | False | True, False | Use SSL/TLS encrypted connection |
| z, c, t | getPlane | 0, 0, 0 | 0 β size-1 | Z-slice, channel, timepoint indices |
Truncated for display β read the full file on GitHub.
Related Skills
taste-skill
118.9kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
113.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu β one CLI, zero API fees.
ruflo
82.1kπ The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
80.2kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit β see the Safety scan above for what the skill file itself contains.
