Skip to main content


Project description


OMERO.web provides a web based client and plugin infrastructure.


Direct dependencies of OMERO.web are:


See: OMERO documentation


See: OMERO documentation


See: OMERO documentation

Developer installation

OMERO.web depends on If you want a developer installation of, replace pip install omero-py with instructions at

For a development installation we recommend creating a virtualenv with the following setup (example assumes python3.6 but you can create and activate the virtualenv using any compatible Python):

python3.6 -mvenv venv
. venv/bin/activate
pip install zeroc-ice==3.6.5
pip install omero-py          # OR dev install (see above)
git clone
cd omero-web
pip install -e .

This will install OMERO.web into your virtualenv as an editable package, so any edits to source files should be reflected in your installation.

Note some omero-web tests may not run when this module and/or omero-py are installed in editable mode.

Running tests

Unit tests are located under the test directory and can be run with pytest.

Integration tests

Integration tests are stored in the main repository (ome/openmicroscopy) and depend on the OMERO integration testing framework. Reading about Running and writing tests in the OMERO documentation is essential.

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 patch

NB: this assumes next release will be a patch (see below). To complete the release, push the master branch and the release tag to origin:

$ git push origin master v5.8.0

If any PRs are merged that would require the next release to be a major or minor version (see then that PR can include a version bump created via:

$ bumpversion --no-tag minor|major

If this hasn’t been performed prior to release and you wish to specify the next version number directly when creating the release, this can be achieved with:

$ bumpversion --new-version 5.9.0 release


Following omero-web release, need to update and release omero-web-docker.


OMERO.web is released under the AGPL.

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-web-5.8.1.tar.gz (2.2 MB view hashes)

Uploaded source

Built Distribution

omero_web-5.8.1-py3-none-any.whl (2.8 MB view hashes)

Uploaded py3

Supported by

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