gitwtfhub

wtf is hydra?

facebookresearch/hydra — explained in plain English

Analysis updated 2026-06-24

★ 10,360PythonAudience · researcherComplexity · 2/5LicenseSetup · easy

TL;DR

A Python framework from Meta that manages complex application configuration through composable YAML files with command-line overrides, especially popular for running machine learning experiments with different settings.

Mindmap

mindmap
  root((Hydra))
    What it does
      YAML config loading
      Config composition
      Command-line overrides
    Key features
      Config groups
      Multirun sweeps
      Structured configs
    Use cases
      ML experiments
      Large app settings
      Replace argparse
    Ecosystem
      Third-party plugins
      Training framework templates
      Python 3.10 to 3.14

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Run ML experiments with different hyperparameters by overriding YAML config values from the command line without editing files.

REASON 2

Split a large application's settings across multiple YAML files that Hydra automatically merges at startup.

REASON 3

Replace boilerplate argparse argument-parsing code with structured, composable configuration files.

REASON 4

Use Hydra's multirun feature to sweep over a grid of hyperparameters in a single command.

What's in the stack?

PythonYAMLpip

How it stacks up

facebookresearch/hydraharelba/qvega/altair
Stars10,36010,34710,375
LanguagePythonPythonPython
Setup difficultyeasyeasyeasy
Complexity2/52/52/5
Audienceresearcherdatadata

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 30min

Requires Python 3.10+ and familiarity with YAML syntax to get the most out of config composition.

Licensed under the MIT license, use freely for any purpose, including commercial projects, as long as you keep the copyright notice.

Wtf does this do

Hydra is a Python framework from Meta's research team that makes it easier to manage configuration in complex applications. Configuration refers to all the settings and options your program needs to run: things like which model to use, where to find data, what learning rate to apply, or which server to connect to. As applications grow, managing all these settings in a clean and flexible way becomes a real challenge. Hydra is built to solve that. The core idea is that you define your configuration in structured files (using a format called YAML), and Hydra loads and composes those files when your program starts. You can override any setting from the command line without changing the files, which makes it easy to run experiments with different parameters. You can also combine multiple configuration files together, so a large application can split its settings across many files that get merged at runtime. Hydra is especially popular in machine learning research, where people frequently run the same program many times with slightly different settings to compare results. It reduces the boilerplate involved in parsing command-line arguments and managing configuration across runs. A number of third-party libraries build on top of it, including templates that combine Hydra with popular training frameworks for convenience. Installation is a single pip command. The stable version is 1.3, and a development version (1.4) is available from source. It supports Python 3.10 through 3.14 and is licensed under the MIT open-source license. Documentation lives on the project's own website, and the community uses GitHub Discussions and StackOverflow for questions.

Yoink these prompts

Prompt 1
I'm training a PyTorch model with Hydra. Write a Python training script with a Hydra config that lets me override learning_rate, batch_size, and model_name from the command line, and logs the final config to a file.
Prompt 2
Set up Hydra config groups so I can switch between a 'small' and a 'large' model by running `python train.py model=small` or `python train.py model=large`, each with different layer counts and hidden sizes.
Prompt 3
Show me how to use Hydra's multirun feature to grid-search over learning_rate=[0.001,0.01] and batch_size=[32,64], running all 4 combinations in sequence from a single command.

Frequently asked questions

wtf is hydra?

A Python framework from Meta that manages complex application configuration through composable YAML files with command-line overrides, especially popular for running machine learning experiments with different settings.

What language is hydra written in?

Mainly Python. The stack also includes Python, YAML, pip.

What license does hydra use?

Licensed under the MIT license, use freely for any purpose, including commercial projects, as long as you keep the copyright notice.

How hard is hydra to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is hydra for?

Mainly researcher.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.

Other repos in this lane