hierarchical-conf
A tool for loading settings from files hierarchically
Decision gist · record as of 2026-08-14
Yes, if you need environment-aware configuration management and are comfortable with the maintenance lag. The library is simple, has no known vulnerabilities, and low install friction. However, verify the license metadata before using in proprietary projects, and be aware that the last release was nearly a year ago—check whether the project's pace matches your support expectations.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires ENVIRONMENT environment variable to be set; package expects YAML files named with environment prefixes (e.g., dev_conf.yml, production_conf.yml).
- Low friction install with a single runtime dependency (PyYAML).
- Last release was 359 days ago and the repository is not archived, though maintenance appears to have slowed.
License · maintenance · safety
(unclear) — License treatment is unclear—the fact sheet does not specify a license identifier, though the description mentions Apache License 2.0 in the repository. Verify the actual license before use in proprietary or restricted contexts.
last release 2025-08-20 (359 days) · last repo commit 2025-08-20 · 4 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 301,728 downloads/mo, #7,832 on PyPI
Alternatives
Verify before relying
pip install hierarchical-conf
from hierarchical_conf.hierarchical_conf import HierarchicalConf
hconf = HierarchicalConf(searched_paths=['/path/to/configs'])
my_setting = hconf.get_config('my_key')- Whether license metadata is correctly registered on PyPI despite Apache 2.0 being stated in the repository.
- Current maintenance cadence and whether the 359-day gap since last release reflects active or dormant status.
What it is and what it does
Hierarchical Conf is a Python library that loads application settings from YAML files organized by deployment environment. It reads an ENVIRONMENT system variable to determine which configuration file to load, then merges settings from multiple files in precedence order, with later files overwriting earlier keys. This is useful when you need different settings for development, staging, and production without hardcoding them or managing multiple branches.
The library depends only on PyYAML and supports Python 3.7 and later. You pass it a list of paths to search for configuration files, and it automatically discovers and loads files matching the pattern `{environment}_conf.yml`. It's designed for teams that want configuration-as-code with environment-aware defaults, allowing you to keep all settings in version control while still varying behavior across deployment stages.
Use it for
- Load different database URLs, API keys, and feature flags for dev, staging, and production from a single codebase.
- Organize application settings in YAML files that override each other in a predictable order based on the current environment.
- Avoid hardcoding credentials or environment-specific values in Python code while keeping configuration files in the repository.
- Manage settings for multiple microservices that share common defaults but need environment-specific overrides.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need environment-aware configuration management and are comfortable with the maintenance lag.
The library is simple, has no known vulnerabilities, and low install friction. However, verify the license metadata before using in proprietary projects, and be aware that the last release was nearly a year ago—check whether the project's pace matches your support expectations.
Install
hierarchical-conf on PyPI
Before you install
Low friction install with a single runtime dependency (PyYAML). Last release was 359 days ago and the repository is not archived, though maintenance appears to have slowed.
Requires ENVIRONMENT environment variable to be set; package expects YAML files named with environment prefixes (e.g., dev_conf.yml, production_conf.yml).
License in practice
License treatment is unclear—the fact sheet does not specify a license identifier, though the description mentions Apache License 2.0 in the repository. Verify the actual license before use in proprietary or restricted contexts.
Quickstart
pip install hierarchical-conf
from hierarchical_conf.hierarchical_conf import HierarchicalConf
hconf = HierarchicalConf(searched_paths=['/path/to/configs'])
my_setting = hconf.get_config('my_key')Verify before relying
- Whether license metadata is correctly registered on PyPI despite Apache 2.0 being stated in the repository.
- Current maintenance cadence and whether the 359-day gap since last release reflects active or dormant status.
Package facts
| License | Not declared unclear |
| Python support | Supports the current Python release <4,>=3.7 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagePyYAML |
| Maintenance | Aging 359 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 301,728 / month, #7,832 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Natural Language :: EnglishProgramming Language :: Python :: 3Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8 |
Evidence: hierarchical_conf-1.0.4-py2.py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “environment-based configuration loading”
- hierarchical-confLoads configuration from YAML files organized by environment,…
- pydantic-settingsLoads and validates application settings from environment variables,…
- flagsmithFlagsmith is a Python SDK for managing feature flags and remote…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also HiYaPyCo · omegaconf · pyaml-env · config · pyhocon · application-properties · PyStaticConfiguration · config-parser · cabina · donfig