hydra README

The project's README from github.com/hydra-ecosystem/hydra. As one markdown file: README.md.

logo

PyPI PyPI - Python Version GitHub Actions build Downloads Config: Hydra ecosystem: cli.dev

PyPI - License Zulip chat Code style: Ruff

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

Development

Hydra 1.4 is the current development version of Hydra.

Stable

Hydra 1.3 is the stable version of Hydra.

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):

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

hydra (hydra-ecosystem/hydra)

Searching Database…

10.7K ·GitHub
What is this?Hydra is a Python framework for elegantly configuring complex applications, letting you compose and override hierarchical configs dynamically from the command line.
Is it a standalone app or a library I add to my code?It's a Python library you install with pip and import into your own application to manage its configuration.
How do I install and start using it?Install the stable release with pip install hydra-core --upgrade, or the development 1.4 pre-release with pip install --pre --upgrade hydra-core.
Which Python versions does it support?Hydra 1.4 supports Python 3.10 through 3.14.
Is Hydra 1.4 stable to use right now?No, 1.4 is still a development version; the current stable release is Hydra 1.3, so production users should stick with 1.3 for now.
Who typically uses Hydra?It's aimed at researchers and engineers building complex applications (especially ML/deep learning projects) who need flexible, composable configuration management.
Where did Hydra move from and why does that matter?Hydra moved from the facebookresearch GitHub organization to hydra-ecosystem, keeping its full history, issues, and pull requests intact as part of a transition to independent stewardship.
Where can I find plugins and third-party projects built on Hydra?The Hydra Landscape page lists third-party libraries, templates, plugins, and projects that use or extend Hydra.
Where do I ask questions about Hydra?You can ask on GitHub Discussions or StackOverflow using the tag fb-hydra or omegaconf.
Size
371 MB
Stars
10.7K
Age
7y
Commits · 90 Days