---
id: python-json-config
version: "1.2.3"
license: MIT
license_treatment: permissive
maintenance: active
---

# python-json-config — This library allows to load json configs and access the values like members (i.e., via dots), validate config field types and values and transform config fields.

License: permissive · Maintenance: active · Downloads: 760.5K/mo

## What it is and what it does

python-json-config wraps JSON configuration files in a Python object that lets you access nested values using dot notation (config.server.port) instead of dictionary subscripts. It depends on jsonschema for validation and msgpack for binary serialization. The library provides a ConfigBuilder that parses JSON into a Config object, which supports field-level type and value validation, field transformation (e.g., string to datetime), optional/required field enforcement, and environment variable merging. You can also serialize configs back to dict, JSON, or msgpack format.

The package is aimed at applications that need structured configuration management with validation. It handles nested field access, allows you to define which fields must exist or can be missing, chains custom validators, and can override config values from environment variables by prefix. The library maintains an active repository but has not released a new version since November 2019, so it may lack recent Python or dependency updates.

Use it for:

- Load and validate application configuration from JSON files with type checking on critical fields like server port and IP address.
- Override configuration values via environment variables without modifying the JSON file, useful for containerized deployments.
- Transform string config values into Python objects (e.g., timedelta, datetime) during config parsing.
- Enforce required vs. optional fields and raise errors when accessing missing required configuration.
- Serialize and deserialize config objects to different formats (JSON, msgpack, pickle) for caching or transmission.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Loads JSON configuration files and provides dot-notation access to nested values, with built-in validation and transformation of field types and values.

Yes, if you need straightforward JSON config management with validation. The low install friction, permissive MIT license, and active repository make it a safe choice. However, the lack of a release since November 2019 means you should verify that the package works with your current Python and dependency versions before committing to it in new projects.

## Install

pip install python-json-config
uv add python-json-config
poetry add python-json-config

## Installing python-json-config

Before you install: Low install friction with only two runtime dependencies (jsonschema and msgpack). Maintenance status is active with a recent commit in June 2026, though the latest release was in November 2019.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart:

pip install python-json-config

from python_json_config import ConfigBuilder

builder = ConfigBuilder()
config = builder.parse_config('config.json')
port = config.server.port

Requires Python 3.6 or later.

Verify before relying:

- Whether the package is actively maintained for new features or only receives critical fixes (last release was November 2019).
- Performance characteristics when handling large or deeply nested configuration files.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 760.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

json config loader, configuration management python, nested config access, config validation, environment variable config override, configuration-management, json-parsing

[View on SkillFed](https://skillfed.io/packages/python-json-config) · [View on PyPI](https://pypi.org/project/python-json-config/)