Skip to main content

Hyrax

A Low-Code Framework for Rapid Experimentation with ML & Unsupervised Discovery in Astronomy

Template GitHub Workflow Status codecov Read the Docs PyPI

Hyrax is an extensible platform that handles much of the boilerplate code that is often required for a machine learning project in astronomy. Hyrax users are able to focus on the science work of model development and results analysis instead of infrastructure.

Hyrax is not tied to a specific model or data modality but rather is intended to encourage an ecosystem of models and data for rapid experimentation. If the algorithm you want can be implemented in PyTorch, then Hyrax can likely reduce the boilerplate code required for a reproducible project.

Getting Started

Hyrax can be installed via pip:

>> pip install hyrax

Hyrax is officially supported and tested with Python versions 3.11, 3.12, and 3.13. Other versions may work but are not guaranteed to be compatible.

Check out Getting started and Common workflows in the documentation for usage examples.

Existing Hyrax Projects

Hyrax has been developed to support single and multimodal data for use with both supervised and unsupervised models. Some examples include:

  • Image-based unsupervised discovery in Rubin-LSST and HSC. (A. Ghosh, J. Chatchadanoraset, D. Miura)
  • Spectra-based supervised clustering to study supernova Ia spectral diversity. (L. Cunningham, M. Dai)
  • Image-based supervised small body classification. (M. West++)
  • Multimodal time-series classification for ZTF alert follow-up. (A. Sasli, F. Fontinele-Nunes++)
  • Image-based unsupervised discovery of cluster-scale gravitationally lensed arcs. (G. Khullar++)
  • Searches for semi-resolved galaxies in HSC and LSST (P. Ferguson ++)

Collaborations and Contributions

If you are an astronomer interested in using Hyrax, please get in touch with us! We are especially interested to hear about applications that Hyrax doesn't currently support.

Hyrax is open source and under active development. If you would like to contribute, please contact us. We would be happy to work with you.

Acknowledgements

This project started as a collaboration between different units within the LSST Discovery Alliance -- the LINCC Frameworks Team and LSST-DA Catalyst Fellow, Aritra Ghosh.

This project is supported by Schmidt Sciences and the John Templeton Foundation

Citing Hyrax

If you use Hyrax in your research, please cite the following paper:

Ghosh, Oldag & Tauraso et al. 2026, Hyrax: An Extensible Framework for Rapid ML Experimentation and Unsupervised Discovery in the Era of Rubin, Roman, and Euclid

@article{Ghosh_Oldag_Tauraso_2026,
author = {Aritra Ghosh and Drew Oldag and Michael Tauraso and Andrew J. Connolly and Peter Ferguson and Derek Jones and Gourav Khullar and Argyro Sasli and Samarth Venkatesh and Gracia Wang and Maxine West and Dylan Berry and Neven Caplar and Colin Orion Chandler and Tanawan Chatchadanoraset and Michael W. Coughlin and Melissa DeLucchi and Alexandra Junell and Diego Miura and Felipe Fontinele Nunes and Wilson Beebe and Doug Branton and Sandro Campos and Liam Cunningham and Mi Dai and Jeremy Kubica and Konstantin Malanchev and Rachel Mandelbaum and Sean McGuire and Imad Pasha and Dan S. Taranu and Tianqing Zhang},
journal = {arXiv e-prints},
title = {Hyrax: An Extensible Framework for Rapid ML Experimentation and Unsupervised Discovery in the Era of Rubin, Roman, and Euclid},
eprint = {2605.18959},
archivePrefix = {arXiv},
year = {2026},
}

Metadata

Release files for hyrax 0.12

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hyrax 0.12
File Size Uploaded
hyrax-0.12.tar.gz 15.7 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for hyrax 0.12
File Interpreter ABI Platform
hyrax-0.12-py3-none-any.whl Python 3 none any Details

Total release size: 16.0 MB

Release files / hyrax-0.12.tar.gz

Download URL hyrax-0.12.tar.gz
Size 15.7 MB
Tags Source
SHA-256 checksum
How to use checksums
9cf5f9e4f42cff1ba38f0a58c8a457da7e137185021d4dc9509bccf466014247
BLAKE2b-256 checksum
How to use checksums
7a80fbc49fb3ce0533774dd83b400b45d4bdeaca38065049b859738aa80a2e34
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 2, 2026.

Transparency log

Release files / hyrax-0.12-py3-none-any.whl

Download URL hyrax-0.12-py3-none-any.whl
Size 327.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6d87353306c08ad3c4707d087f137b6448ad1f095cbcd23f6ce61ad900d5fef7
BLAKE2b-256 checksum
How to use checksums
f74e999a386d8ac244c55188abe4c0b7fd79b9670b052fbd93c6f9f06d59d01b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 2, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.12 This release

2 release files

0.11

2 release files

0.10

2 release files

0.9.0

2 release files

0.8.3

2 release files

0.8.2

2 release files

0.8.1

2 release files

0.8.0

2 release files

0.7.0

2 release files

0.6.10

2 release files

0.6.9

2 release files

0.6.8

2 release files

0.6.7

2 release files

0.6.6

2 release files

0.6.5

2 release files

0.6.4

2 release files

0.6.3

2 release files

0.6.2

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.1

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page