omegaconf

A flexible configuration library

omegaconf Permissive license Active ★ 2,419 v2.3.1 released 2026-06-11

Install

omegaconf on PyPI

pip

pip install omegaconf

uv

uv add omegaconf

poetry

poetry add omegaconf

Package facts

License	not declared (permissive)
Python support	supports the current Python release (>=3.6)
Install friction	low — pure-Python wheel
Runtime dependencies	3 — antlr4-python3-runtime, PyYAML, dataclasses
Maintenance	actively maintained — 63 days since the last release
Last repo commit	2026-08-13
First released	2018-09-03
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: omegaconf-2.3.1-py3-none-any.whl

Keywords: yaml, configuration, config

License :: OSI Approved :: BSD LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9

About omegaconf

from the package's own PyPI description — quoted content, verbatim

OmegaConf

	Description
Project	PyPI version (image)Downloads (image)PyPI - Python Version (image)
Code quality	CircleCI (image)Coverage Status (image)Total alerts (image)Language grade: Python (image)
Docs and support	[![Documentation...

Read as markdown · JSON record · Source repository · Homepage

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

OmegaConf is a hierarchical configuration system that merges configurations from YAML files, dataclasses, and CLI arguments into a unified API.

Low friction: pure Python wheel with three stable runtime dependencies (antlr4-python3-runtime, PyYAML, dataclasses). Active maintenance—last release 63 days ago, 2419 GitHub stars, continuous CI/CD.

Permissive license with no notable restrictions on commercial or private use.

Usage

pip install omegaconf

from omegaconf import OmegaConf
cfg = OmegaConf.create({"key": "value"})
print(cfg.key)

Requires Python 3.6 or later.

Verdict: OmegaConf is a mature, actively maintained configuration framework in the top 1000 PyPI packages with zero known vulnerabilities. Its permissive license, low install friction, and broad Python version support (3.6–3.11) make it a low-risk choice for configuration management.

Needs verification

Whether BSD license is explicitly stated in package metadata or inferred from classifiers.
Performance characteristics and memory footprint for large hierarchical configurations.
Type-safety guarantees and validation capabilities beyond what the description excerpt states.

yaml configuration managementhierarchical config systemmerge multiple config sourcesdataclass configurationstructured config librarycli argument parsingconfiguration validation