Skip to main content

Unleashing Project Configuration and Organization

Project description

omni-fig is a lightweight package to help you organize your python projects to make everything clear and easy to understand to collaborators and prospective users, while also offering unparalleled features to accelerate development.

The proposed general-purpose project structure is well suited for both small and large projects, and is designed to be easily extensible to fit your needs. Most importantly, with the powerful configuration system, you never have to worry about any boilerplate code to parse command line arguments, read config files, or even import the top-level project components ever again!

For lots of examples in how the config system works check out the documentation or examples/.


Everything is tested with Python 3.8 on Ubuntu 20.04 and Windows 11, but in principle it should work on any system that can handle the dependencies.

The easiest way to install the stable release is with pip:

pip install omnifig

If you want to explore the examples or contribute to the project, you can install the latest version by cloning the repository and installing it with pip:

If you want to explore the examples or want to contribute to the project, you can clone the repository and install the package in development mode:

git clone

pip install -e ./omni-fig

Key Features

Check out an overview of some of the core features of omni-fig: highlights.


If you used omni-fig in your work, please cite it using:


  title = {Omni-fig: Unleashing Project Configuration and Organization in Python},

  author = {Leeb, Felix},

  publisher = {GitHub},

  year = {2022}



Feedback and contributions are very welcome! Please feel free to open an issue or pull request.

Thank you to Amanda Leeb for designing the logo!

Project details

Download files

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

Source Distribution

omnifig-1.0.5.tar.gz (64.4 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page