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: optional pydevd debugger 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.

• What's new
• Documentation
• Upgrade guide
• Source code

Install with pip install --upgrade omegaconf

OmegaConf 2.3 is retained for projects that require the earlier release.

• What's new
• Documentation
• Source code

Install with pip install 'omegaconf<2.4'