Skip to main content

A helper library for Clean Architectures in Python

Project description

Build Status Version

A helper library for Clean Architectures in Python

Full documentation available at

About Gaudi

Gaudi (pronounced /ˈɡaʊdi/) is a library that provides some helper structures to build projects based on a clean architecture in Python. The very nature of a clean architecture is the opposite of a framework, so Gaudi provides the minimum amount of classes and methods to avoid boring repetition in your code.

Gaudi is opinionated, as some of the structures provided enforce minimum conventions, like requests being dictionary-like objects and responses having a category and a content. It is also extensible, however, as you are free to change the behaviour of the components at any time.

As you are following the clean architecture model you are free to build the internal protocols and objects like you prefer. Using Gaudi saves you some typing and enforces a minimum of conventions in your project. You are free to use just some of the components of Gaudi without breaking the clean architecture model.


In 2016 I wrote Clean architectures in Python: a step-by-step example, a detailed analysis of a clean architecture written in Python from scratch following a pure TDD methodology. Since then I created many successful projects following this model, but I quickly realised that there was a core of code that I copied from project to project (the shared module in the original article). So I decided to try to clean it up and to publish it as a library.

The name is an homage to Antoni Gaudí a genius that gave the world some of the most beautiful architectural works ever conceived by men.


Gaudi is an helper library for clean architectures, so it provides the very minimum amount of code to avoid repetitions among projects. This means that the library shouldn’t grow too much in the future. There will be bug fixes and maybe some new helpers if there are good use cases (no pun intended) for them. I’m however ready to be surprised, so it might be that there are many other aspects of the clean architecture that can be automated while keeping the nature of the whole methodology: clean separation between layers.

Feel free to submit issues or pull requests or to get in touch if you have ideas about Gaudi. Maybe you can see what I can’t! And thanks for using Gaudi and the Clean Architecture model!


Gaudi is available for Python 3 through pip. Just create a virtual environment and run

pip install gaudi


See the CONTRIBUTING file for detailed information. Please remember that this project is actively developed in the develop branch, so be sure to work there if you try to implement new feature of fix bugs.


1.0.1 (2019-06-26)

  • Minor review of README and Python packaging

1.0.0 (2018-08-01)

  • First release on PyPI.

Project details

Download files

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

Files for gaudi, version 1.0.1
Filename, size File type Python version Upload date Hashes
Filename, size gaudi-1.0.1-py2.py3-none-any.whl (7.2 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size gaudi-1.0.1.tar.gz (8.0 kB) File type Source Python version None Upload date Hashes View

Supported by

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