Skip to main content

Upload library for use in the OMERO CLI.

Project description

OMERO CLI upload

Plugin for uploading files using the OMERO Command Line Interface (CLI).


  • OMERO 5.6.0 or newer

  • Python 3.6 or newer

Installing from PyPI

This section assumes that an is already installed.

Install the command-line tool using pip:

$ pip install -U omero-upload


The plugin is called from the command-line using the omero command.

To upload a single file:

$ omero upload <file>

This command will create an OriginalFile on the server and return an output of type OriginalFile:<id>.

To upload multiple files:

$ omero upload <file1> <file2>

This command will create two OriginalFile and return an output of type OriginalFile:<id1>,<id2>

By default, the mimetype will be guessed from the filename but it can be specified by using the –mimetype argument:

$ omero upload <file1> --mimetype 'test/csv'

Files can be in-place uploaded into the OMERO.server via symlinked rather than being copied. This requires the command to be run on the OMERO.server itself from a user having write permissions to the OMERO data repository, similarly to the [in-place import]( To run an in-place upload, the –data-dir argument must be passed to specify the binary OMERO directory:

$ omero upload <file1> --data-dir /OMERO

Instead of creating and returning a simple OriginalFile object, it is also possible to wrap the file within a FileAnnotation which can then be linked to other objects in the database. It is possible to specify the namespace of this FileAnnotation using the –namespace argument:

$ omero upload <file1> --wrap --namespace ''

This command will create an OriginalFile and a FileAnnotation and return an output of type FileAnnotation:<id>.

Release process

This repository uses bump2version to manage version numbers. To tag a release run:

$ bumpversion release

This will remove the .dev0 suffix from the current version, commit, and tag the release.

To switch back to a development version run:

$ bumpversion --no-tag [major|minor|patch]

specifying major, minor or patch depending on whether the development branch will be a major, minor or patch release. This will also add the .dev0 suffix.

Remember to git push all commits and tags.


This project, similar to many Open Microscopy Environment (OME) projects, is licensed under the terms of the GNU General Public License (GPL) v2 or later.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

omero-upload-0.4.0.tar.gz (14.6 kB view hashes)

Uploaded Source

Built Distribution

omero_upload-0.4.0-py3-none-any.whl (14.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page