{"library":"omegaconf","title":"OmegaConf","description":"OmegaConf is a flexible configuration library (version 2.3.0) that provides hierarchical configuration, variable interpolation, and merging capabilities from multiple sources like YAML files, CLI arguments, and environment variables. It also offers runtime type safety through Structured Configs. The library is actively maintained with frequent releases, including pre-releases for the upcoming 2.4.0 version.","language":"python","status":"active","last_verified":"Tue May 12","install":{"commands":["pip install omegaconf"],"cli":null},"imports":["from omegaconf import OmegaConf","from omegaconf import II"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"from omegaconf import OmegaConf\nimport os\n\n# Create a config from a dictionary\nconf = OmegaConf.create({\n    \"database\": {\n        \"host\": \"localhost\",\n        \"port\": 5432,\n        \"user\": \"${oc.env:DB_USER, default_user}\"\n    },\n    \"server\": {\n        \"port\": \"${database.port}\"\n    }\n})\n\n# Access config values\nprint(f\"Database host: {conf.database.host}\")\nprint(f\"Database user: {conf.database.user}\") # Resolves from env var or default\nprint(f\"Server port: {conf.server.port}\")\n\n# You can also load from YAML strings or files\nyaml_string = \"\"\"\napp:\n  name: my_app\n  version: 1.0\n\"\"\"\napp_conf = OmegaConf.create(yaml_string)\nprint(f\"App name: {app_conf.app.name}\")\n\n# Overriding values\nconf.database.host = \"remote_db\"\nprint(f\"Updated database host: {conf.database.host}\")\n\n# Example of structured config with dataclasses (requires Python 3.7+ or dataclasses backport for 3.6)\nfrom dataclasses import dataclass\n\n@dataclass\nclass DatabaseConfig:\n    host: str = \"127.0.0.1\"\n    port: int = 5432\n\n@dataclass\nclass Config:\n    db: DatabaseConfig = DatabaseConfig()\n    debug: bool = False\n\nstructured_conf = OmegaConf.structured(Config)\nprint(f\"Structured config DB host: {structured_conf.db.host}\")\n\n# Set an environment variable for testing\nos.environ['DB_USER'] = 'my_secret_user'\nresolved_user_conf = OmegaConf.create({\"db_user\": \"${oc.env:DB_USER}\"})\nprint(f\"Resolved DB user from env: {resolved_user_conf.db_user}\")\ndel os.environ['DB_USER'] # Clean up","lang":"python","description":"This quickstart demonstrates how to create configurations from Python dictionaries and YAML strings, access values using dot notation and dictionary-style access, utilize variable interpolation (including environment variables), and create structured configurations using dataclasses for type safety.","tag":null,"tag_description":null,"last_tested":"2026-04-24","results":[{"runtime":"python:3.10-alpine","exit_code":0},{"runtime":"python:3.10-slim","exit_code":0},{"runtime":"python:3.11-alpine","exit_code":1},{"runtime":"python:3.11-slim","exit_code":1},{"runtime":"python:3.12-alpine","exit_code":1},{"runtime":"python:3.12-slim","exit_code":1},{"runtime":"python:3.13-alpine","exit_code":1},{"runtime":"python:3.13-slim","exit_code":1},{"runtime":"python:3.9-alpine","exit_code":0},{"runtime":"python:3.9-slim","exit_code":0}]},"compatibility":{"tag":"verified","tag_description":"installs cleanly on critical runtimes, fast import, recently tested","last_tested":"2026-05-12","installed_version":"2.3.0","pypi_latest":"2.3.0","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":2.8,"avg_import_s":0.29,"wheel_type":"sdist"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"omegaconf","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.22,"mem_mb":5.4,"disk_size":"23.1M"},{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"omegaconf","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.24,"mem_mb":5.4,"disk_size":"23.1M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"omegaconf","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":2.3,"import_time_s":0.15,"mem_mb":5.4,"disk_size":"24M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"omegaconf","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.17,"mem_mb":5.4,"disk_size":"24M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"omegaconf","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.41,"mem_mb":6.2,"disk_size":"26.1M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"omegaconf","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.49,"mem_mb":6.2,"disk_size":"26.1M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"omegaconf","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":2.4,"import_time_s":0.38,"mem_mb":6.2,"disk_size":"27M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"omegaconf","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.36,"mem_mb":6.2,"disk_size":"27M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"omegaconf","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.3,"mem_mb":5.8,"disk_size":"16.0M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"omegaconf","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.33,"mem_mb":5.8,"disk_size":"16.0M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"omegaconf","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":3.4,"import_time_s":0.33,"mem_mb":5.8,"disk_size":"17M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"omegaconf","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.36,"mem_mb":5.8,"disk_size":"17M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"omegaconf","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.28,"mem_mb":5.9,"disk_size":"15.7M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"omegaconf","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.31,"mem_mb":5.9,"disk_size":"15.6M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"omegaconf","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":3,"import_time_s":0.3,"mem_mb":5.9,"disk_size":"17M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"omegaconf","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.32,"mem_mb":5.9,"disk_size":"17M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"omegaconf","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.21,"mem_mb":5.4,"disk_size":"22.7M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"omegaconf","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.24,"mem_mb":5.4,"disk_size":"22.7M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"omegaconf","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":2.8,"import_time_s":0.2,"mem_mb":5.4,"disk_size":"24M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"omegaconf","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.2,"mem_mb":5.4,"disk_size":"24M"}]}}