hydra-experiment-config

Manage Hydra and OmegaConf experiment configurations and resolve override errors.

10|1|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/dongzhuoyao/tao-research-skills --skill hydra-experiment-config
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hydra-experiment-config
Source: https://github.com/dongzhuoyao/tao-research-skills/tree/main/hydra-experiment-config
Command: npx skills add https://github.com/dongzhuoyao/tao-research-skills --skill hydra-experiment-config

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Centralizes and clarifies Hydra-based experiment configuration so runtime constants are not hardcoded, overrides compose predictably, and experiments are reproducible across runs and environments.

Core Features & Use Cases

  • Config-as-source-of-truth: Ensure all runtime constants live in YAML and avoid duplicated module-level constants.
  • Hierarchical groups with flat aliases: Organize by semantic groups while providing flat aliases for ergonomic CLI overrides.
  • Defaults list, derived values, and CLI patterns: Provide patterns for defaults, computed configuration values, multirun sweeps, and safe override behavior.
  • Use Cases: Bootstrapping a new project's conf layout, adding model/training/data variants, debugging override resolution, and preparing configs for experiment tracking.

Quick Start

Convert this project's hardcoded training hyperparameters into a Hydra conf/ layout with hierarchical groups, flat aliases, and a defaults list so overrides resolve predictably.

Frequently Asked Questions about hydra-experiment-config

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure reproducible ML experiment configurations with Hydra?

To structure reproducible ML experiment configurations with Hydra, you centralize runtime constants in YAML files using hierarchical defaults and flat aliases. This ensures overrides compose predictably and experiments remain reproducible across runs and environments.

What is the best way to resolve Hydra config composition and CLI override errors?

The best way to resolve Hydra config composition and CLI override errors is to organize configurations into semantic groups with flat aliases. This ergonomic mapping ensures CLI overrides resolve predictably without breaking hierarchical defaults.

How do I convert hardcoded Python training hyperparameters into a Hydra YAML layout?

Converting hardcoded Python training hyperparameters into a Hydra YAML layout involves moving runtime constants into a conf/ directory. You define hierarchical groups and a defaults list to establish config-as-source-of-truth workflows.

Can I use OmegaConf to compute derived values for multirun sweeps?

Yes, you can use OmegaConf to compute derived values for multirun sweeps. By defining patterns in your defaults list, you ensure safe override behavior and predictable configuration resolution across sweep runs.

Why do my Hydra overrides fail when adding new model and training variants?

Hydra overrides fail when adding new model and training variants if semantic groups lack proper flat aliases. Without ergonomic CLI override patterns and a structured defaults list, configuration composition breaks down unpredictably.