| Description | |
|---|---|
| Project |   |
| Code quality |   |
| Docs, support, and ecosystem |     |
| Backlog |  |
OmegaConf is a hierarchical configuration system, with support for merging configurations from multiple sources (YAML config files, dataclasses/objects and CLI arguments) providing a consistent API regardless of how the configuration was created.
Legacy documentation is retained on Read the Docs,
with its sources under legacy/rtd/.
omegaconf-pydevd: optionalpydevddebugger plugin for inspecting OmegaConf objects in supported debuggers.
OmegaConf 2.4.0 is the current stable version and requires Python 3.10 or newer. Released on October 9, 2026, it adds richer structured config typing, experimental tuples, and improvements to interpolation, resolvers, merging, and validation. Read the release announcement and review the upgrade guide before upgrading from 2.3.
Install with pip install --upgrade omegaconf
OmegaConf 2.3 is retained for projects that require the earlier release.
Install with pip install 'omegaconf<2.4'