discover · compare · collections · requirements · contribute · feed · watching · stats · help with your tokens

hydra-ecosystem/hydra · source

Snapshot 0 · 2026-11-04T12:47:25Z · Python · MIT

GitHub description at capture

Hydra is a framework for elegantly configuring complex applications

README at capture

<p align="center"><img src="https://raw.githubusercontent.com/hydra-ecosystem/hydra/main/website/static/img/Hydra-Readme-logo2.svg" alt="logo" width="70%" /></p>

<p align="center">
  <a href="https://pypi.org/project/hydra-core/"><img src="https://img.shields.io/pypi/v/hydra-core" alt="PyPI" /></a>
  <a href="#"><img src="https://img.shields.io/pypi/pyversions/hydra-core" alt="PyPI - Python Version" /></a>
  <a href="https://github.com/hydra-ecosystem/hydra/actions/workflows/core_tests.yml"><img src="https://github.com/hydra-ecosystem/hydra/actions/workflows/core_tests.yml/badge.svg?branch=main" alt="GitHub Actions build" /></a>
  <a href="https://pepy.tech/projects/hydra-core?versions=1.4.*%2C1.3.*%2C1.2.*%2C1.1.*%2C1.0.*&timeRange=threeMonths&category=version&includeCIDownloads=true&granularity=weekly&viewType=line"><img src="https://api.pepy.tech/badge/hydra-core/month" alt="Downloads" /></a>
  <a href="https://hydra.cc"><img src="https://hydra.cc/img/hydra-config-badge.svg" alt="Config: Hydra" /></a>
  <a href="https://cli.dev"><img src="https://cli.dev/img/badges/cli-dev-ecosystem.svg" alt="ecosystem: cli.dev" /></a>
</p>

<p align="center">
  <a href="https://github.com/hydra-ecosystem/hydra/blob/main/LICENSE"><img src="https://img.shields.io/pypi/l/hydra-core" alt="PyPI - License" /></a>
  <a href="https://hydra-framework.zulipchat.com/"><img src="https://img.shields.io/badge/zulip-join_chat-brightgreen.svg" alt="Zulip chat" /></a>
  <a href="https://github.com/astral-sh/ruff"><img src="https://img.shields.io/badge/code%20style-ruff-261230.svg" alt="Code style: Ruff" /></a>
</p>

<p align="center">
  <i>A framework for elegantly configuring complex applications.</i>
</p>
<p align="center">
  <i>Check the <a href="https://hydra.cc/">website</a> for more information.</i>
</p>

----------------------

> [!IMPORTANT]
> **Hydra project transition:** Hydra moved from the `facebookresearch`
> GitHub organization to
> [`hydra-ecosystem`](https://github.com/hydra-ecosystem). The repository moved
> with its history, issues, and pull requests intact. Hydra remains MIT-licensed.
> No action is required from Hydra users at this time. Contributors should
> review the current guidance in [CONTRIBUTING.md](CONTRIBUTING.md). Read
> [Hydra's next chapter: independent stewardship](https://hydra.cc/blog/2026/08/13/independent-stewardship/)
> for more about the transition.

### Releases

#### Release candidate

**Hydra 1.4** is in the release candidate phase.
- [1.4.0rc3 release notes](https://github.com/hydra-ecosystem/hydra/releases/tag/v1.4.0rc3)
- [Documentation](https://hydra.cc/docs/intro/)
- Install the latest published prerelease: `pip install --pre --upgrade hydra-core`
- Supported Python versions: 3.10 through 3.14.

#### Legacy

**Hydra 1.3** is the legacy version of Hydra.
- [Documentation](https://hydra.cc/docs/1.3/intro/)
- Installation: `pip install --upgrade "hydra-core>=1.3,<1.4"`

See the [NEWS.md](NEWS.md) file for a summary of recent changes to Hydra.

### License
Hydra is licensed under [MIT License](LICENSE).

## Hydra Landscape

See the [Hydra Landscape](https://hydra.cc/docs/landscape/) for
third-party libraries, templates, plugins, and projects that use or extend
Hydra.

#### Ask questions in GitHub Discussions or StackOverflow (Use the tag #fb-hydra or #omegaconf):
* [GitHub Discussions](https://github.com/hydra-ecosystem/hydra/discussions)
* [StackOverflow](https://stackexchange.com/filters/391828/hydra-questions)
* [X](https://twitter.com/Hydra_Framework)

Check out the Meta AI [blog post](https://ai.facebook.com/blog/reengineering-facebook-ais-deep-learning-platforms-for-interoperability/) to learn about how Hydra fits into Meta's efforts to reengineer deep learning platforms for interoperability.

### Citing Hydra
If you use Hydra in your research please use the following BibTeX entry:
```BibTeX
@Misc{Yadan2019Hydra,
  author =       {Omry Yadan},
  title =        {Hydra - A framework for elegantly configuring complex applications},
  howpublished = {Github},
  year =         {2019},
  url =          {https://github.com/hydra-ecosystem/hydra}
}
```