hydra

A framework for elegantly configuring complex applications.

Check the website for more information.

[!IMPORTANT] Hydra project transition: Hydra moved from the facebookresearch GitHub organization to 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. Read Hydra's next chapter: independent stewardship for more about the transition.

Releases

Release candidate

Hydra 1.4 is in the release candidate phase.

• 1.4.0rc1 release notes
• Documentation
• 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
• Installation: pip install --upgrade "hydra-core>=1.3,<1.4"

See the NEWS.md file for a summary of recent changes to Hydra.

License

Hydra is licensed under MIT License.

Hydra Landscape

See the Hydra 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
• StackOverflow
• X

Check out the Meta AI blog post 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:

@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}
}