Tích hợp OMERO (dữ liệu hiển vi)
Truy vấn, xuất metadata và lập kế hoạch chuyển dữ liệu hiển vi trên OMERO.server một cách an toàn bằng omero-py và BlitzGateway.
Kỹ năng này làm gì
Kết nối tới OMERO.server – nền tảng quản lý ảnh sinh học – để duyệt cấu trúc Project/Dataset/Image, xuất metadata (tag, map annotation, ROI, bảng dữ liệu) ra JSON có giới hạn rõ ràng. Tài liệu chỉ rõ khi nào dùng BlitzGateway (Python), OMERO CLI hay API công khai của OMERO.web, kèm quy trình dựng môi trường client tái lập được (OMERO.py 5.22.1 + IcePy 3.6.5, khuyến nghị Python 3.12).
Điểm mạnh nhất là bộ quy tắc an toàn: chỉ đọc thông tin đăng nhập từ biến OMERO_* được khai báo, không bao giờ đưa mật khẩu/session key vào tham số lệnh, log hay output; các script từ xa mặc định chạy dry-run và cần cờ --execute. Mọi thao tác ghi (tạo annotation, import, xóa) đều phải xác nhận ID mục tiêu cụ thể.
Phù hợp với ai
- Nhà nghiên cứu lưu trữ ảnh hiển vi trên OMERO và cần trích xuất danh mục/metadata định kỳ
- Quản trị viên dữ liệu tại core imaging facility, người lập kế hoạch import/export
- Nhóm cần kiểm soát chặt phạm vi truy cập để tránh rò rỉ ảnh chưa công bố
Ví dụ sử dụng
- "Liệt kê 25 ảnh đầu tiên trong Project 42" →
inventory.pytạo bản kiểm kê chỉ-đọc theo trang, xuất JSON - "Xuất tag và ROI của ảnh 1011, 1012, không tải pixel" →
export_image_metadata.pyvới giới hạn theo từng loại và mặc định che dữ liệu nhạy cảm - "Xem trước kế hoạch import từ thư mục cục bộ" →
plan_transfer.pychạy hoàn toàn offline, không gọi tới server
· · · Hướng dẫn cài đặt · · ·
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục skills/omero-integration từ repo GitHub K-Dense-AI/scientific-agent-skills vào ~/.claude/skills/omero-integration/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git /tmp/scientific-agent-skills && mkdir -p ~/.claude/skills && cp -r /tmp/scientific-agent-skills/skills/omero-integration ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal và tải mã nguồn:
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git - Chép thư mục kỹ năng:
mkdir -p ~/.claude/skills && cp -r scientific-agent-skills/skills/omero-integration ~/.claude/skills/ - Tạo môi trường Python 3.12:
uv venv --python 3.12 .venv && source .venv/bin/activate - Tải đúng wheel
zeroc_ice-3.6.5khớp hệ điều hành và phiên bản Python từ tài liệu chính thức của OMERO rồi cài đặt (không dùng Ice 3.7). - Cài client:
uv pip install "omero-py==5.22.1" - Khai báo biến môi trường:
export OMERO_HOST=...,OMERO_PORT=4064,OMERO_USER=...; mật khẩu nên nạp qua secret manager, tránh lưu vào lịch sử shell. - Khởi động lại Claude Code, thử
python -B ~/.claude/skills/omero-integration/scripts/validate_config.py --helpđể kiểm tra cấu hình trước khi kết nối thật.