Skip to main content

The TOM Toolkit and base modules

Project description

TOM Toolkit

pypi run-tests Codacy Badge Coverage Status Documentation Status ASCL

Documentation logo

The TOM Toolkit is a web framework for building TOMs: Target and Observation Managers. TOMs are meant to facilitate collaborative astronomical observing projects. A typical TOM allows its users to curate target lists, request observations of those targets at various observatories as well as manage and organize their data. Read more about TOMs.

Getting started with the TOM Toolkit

The getting started guide will guide you through the process of setting up a TOM for the first time.

Reporting issues/feature requests

Please use the issue tracker to report any issues or support questions.

Contributing to the project

If you'd like to contribute to the TOM Toolkit, first of all, thanks! Secondly, we have a contribution guide that you might find helpful. We are particularly interested in the contribution of observation and alert modules.

Developer information

For development information targeted at the maintainers of the project, please see



The tom_alerts_dash plugin adds responsive ReactJS views to the tom_alerts module for supported brokers.


The tom-antares plugin adds support for querying the Antares broker for targets of interest.


The tom_nonsidereal_airmass plugin provides a templatetag that supports plotting for non-sidereal objects. The plugin is fully supported by the TOM Toolkit team; however, non-sidereal visibility calculations require the PyEphem library, which is minimally supported while its successor is in development. The library used for the TOM Toolkit sidereal visibility, astroplan, does not yet support non-sidereal visibility calculations.


This module provides the ability to submit observations to the Liverpool Telescope Phase 2 system. It is in a very alpha state, with little error handling and minimal instrument options, but can successfully submit well-formed observation requests.



The tom_registration plugin introduces support for two TOM registration flows--an open registration, and a registration that requires administrator approval.

Project details

Release history Release notifications | RSS feed

Download files

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

Source Distribution

tomtoolkit-2.14.4.tar.gz (4.7 MB view hashes)

Uploaded source

Built Distribution

tomtoolkit-2.14.4-py3-none-any.whl (573.0 kB view hashes)

Uploaded py3

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