hydra

<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 chang