MCPcopy Index your code
hub / github.com/facebookresearch/hydra

github.com/facebookresearch/hydra @v1.3.3

repository ↗ · DeepWiki ↗ · release v1.3.3 ↗ · Ask this repo → · + Follow
2,067 symbols 9,033 edges 444 files 185 documented · 9% updated todayv1.3.4 · 2026-07-04★ 10,493212 open issues
README

logo

PyPI CircleCI PyPI - License PyPI - Python Version Downloads Code style: black Total alerts Language grade: Python

<i>A framework for elegantly configuring complex applications.</i>






<i>Check the <a href="https://hydra.cc/">website</a> for more information,


or click the thumbnail below for a one-minute video introduction to Hydra.</i>

1 minute overview


Releases

Stable

Hydra 1.3 is the stable version of Hydra. - Documentation - Installation : pip install hydra-core --upgrade

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

License

Hydra is licensed under MIT License.

Hydra Ecosystem

Check out these third-party libraries that build on Hydra's functionality:

  • hydra-zen: Pythonic utilities for working with Hydra. Dynamic config generation capabilities, enhanced config store features, a Python API for launching Hydra jobs, and more.
  • lightning-hydra-template: user-friendly template combining Hydra with Pytorch-Lightning for ML experimentation.
  • hydra-torch: configen-generated configuration classes enabling type-safe PyTorch configuration for Hydra apps.
  • NVIDIA's DeepLearningExamples repository contains a Hydra Launcher plugin, the distributed_launcher, which makes use of the pytorch distributed.launch API.

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/facebookresearch/hydra}
}

Core symbols most depended-on inside this repo

instance
called by 112
hydra/version.py
store
called by 100
hydra/core/config_store.py
create
called by 97
hydra/core/override_parser/overrides_parser.py
append
called by 80
hydra/core/config_search_path.py
compose
called by 58
hydra/compose.py
get
called by 51
hydra/core/utils.py
append
called by 49
hydra/_internal/config_search_path_impl.py
_test_defaults_tree_impl
called by 44
tests/defaults_list/__init__.py

Shape

Function 824
Method 755
Class 414
Route 74

Languages

Python100%
TypeScript1%

Modules by API surface

hydra/core/default_element.py84 symbols
tests/instantiate/__init__.py77 symbols
tests/test_hydra.py70 symbols
tests/instantiate/test_instantiate.py70 symbols
tests/defaults_list/test_defaults_tree.py57 symbols
tests/test_compose.py54 symbols
tests/test_overrides_parser.py48 symbols
tools/configen/tests/test_modules/__init__.py45 symbols
hydra/core/override_parser/types.py44 symbols
tests/defaults_list/test_defaults_list.py43 symbols
tests/test_config_loader.py40 symbols
noxfile.py36 symbols

Dependencies from manifests, versioned

@docusaurus/core2.0.0-beta.14 · 1×
@docusaurus/preset-classic2.0.0-beta.14 · 1×
classnames2.2.6 · 1×
docusaurus-plugin-internaldocs-fb0.10.4 · 1×
is-svg4.3.1 · 1×
node-fetch2.6.7 · 1×
react17.0.2 · 1×
react-dom17.0.2 · 1×
antlr4-python3-runtime4.9. · 1×
omegaconf2.2 · 1×

For agents

$ claude mcp add hydra \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact