Skip to main content

A Configuration management system for Python projects.

Project description


VR.Hercules is a configuration management system for Python projects. Assuming your configuration to use YAML configuration files, you can define their structure and type by Python schema files. That way, this project enables easy configuration with minimal syntax while providing software assistance for using configurations.


  • Python-based typed schema definition
  • Autocompletion within IDEs
  • Semi-automatic parsing of yaml files
  • Extensibility for custom types
  • Reconfiguration at runtime

Problem Statement

Oftentimes, we build systems from configurable parts. Ideally, the configuration would be structured like our system. Therefore, we need a structuring configuration system.


The de-facto standard configuration language is currently YAML. The structure with the least syntax in Python are classes. So, we choose YAML as configuration syntax and Python classes as parsing target.

Mental Model

Mental Model

As shown on the left, a composed systems without a configuration management system might end up with different means of configuration. As shown on the right, a composed system using this package can use a single means of configuration for all its components. This helps with increasing development velocity because all components benefit from the features of the configuration management system.


pipeline status   coverage report   PyPI Status   PyPI Version   PyPI License Badge   Wheel Badge   Python Versions


This package is not licensed. Therefore, it can only be used in the DFKI.


This package originates from and is being used in production at the VR.Backend project. However, the VR.Backend project is currently internal to the DFKI.


This package enables parsing configuration files according to a schema:

class Config:
    greeting: str
    greetee: str

Config: type = parse_config(


For more detailed instructions on using this project, see the tutorial.


For development and maintenance of this project, see the development documentation.


For more complete documentation, see our dedicated documentation pages.


Please refer to the issue tracker for any inquiry.


VR.Hercules is simpler than Facebook's Hydra and it slays.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

VR.Hercules-1.1.28.tar.gz (7.9 kB view hashes)

Uploaded source

Built Distribution

VR.Hercules-1.1.28-py3-none-any.whl (15.0 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page