Generate UML class diagrams from django models

  • Published: March 24, 2018


To visualize and better understand a project structure we can create UML class diagrams from Django models.

a class diagram in the Unified Modeling Language (UML) is a type of static structure diagram that describes the structure of a system by showing the system's classes, their attributes, operations (or methods), and the relationships among objects.

*[UML]: Unified Modeling Language

We will use a special command for this task included in the django-extensions package called: graph_models

Creates a GraphViz dot file for the specified app names based on their You can pass multiple app names and they will all be combined into a single model. Output is usually directed to a dot file.


Install django extensions

Considering you already have Django installed (for this example I will use the Wagtail project), then we install django extensions with pip install django-extensions.

$ pip install django-extensions
Collecting django-extensions
  Using cached django_extensions-2.0.6-py2.py3-none-any.whl
Collecting six>=1.2 (from django-extensions)
  Using cached six-1.11.0-py2.py3-none-any.whl
Installing collected packages: six, django-extensions
Successfully installed django-extensions-2.0.6 six-1.11.0

Add to installed apps

To make your Django project aware of the new package, we add it to INSTALLED_APPS in your configuration file <project>/, in a Wagtail project called mysite this is at mysite/settings/


Install diagrams generators

You have to choose between two diagram generators:

  • Graphviz or
  • Dotplus

before using the command or you will get:

$ python graph_models -a -o myapp_models.png
CommandError: Neither pygraphviz nor pydotplus could be found to generate the image

I prefer to use pydotplus as it easier to install than Graphviz and its dependencies so we use pip install pydotplus.

$ pip install pydotplus
Collecting pydotplus
Collecting pyparsing>=2.0.1 (from pydotplus)
  Using cached pyparsing-2.2.0-py2.py3-none-any.whl
Installing collected packages: pyparsing, pydotplus
Successfully installed pydotplus-2.0.2 pyparsing-2.2.0

Generate diagrams

Now we have everything installed and ready to generate diagrams using the command python graph_models

$ python graph_models -a -o myapp_models.png

This will give use the entire Wagtail class diagram:

wagtail models

Or grouped by application (-o):

$ ./ graph_models -a -g -o my_project_visualized.png

wagtail models application by group

Lastly, let’s generate a class diagram for Django (v2.0.3) models:

django models


Besides you probable have done the class diagram before starting the project, it can easily get outdated after a while. This is a useful technique to keep your diagrams in sync with the current status of the project.

Have a look at for a full description of graph-models options.


Marcelo Canina
I'm Marcelo Canina, a developer from Uruguay. I build websites and web-based applications from the ground up and share what I learn here.
comments powered by Disqus
Except as otherwise noted, the content of this page is licensed under CC BY-NC-ND 4.0 ·