Version 35 (modified by Robert Coup, 8 years ago) (diff)

Remove dead links, add direct link to django-extensions version, update command.

Converting Django models into Graphviz DOT files

Inspired by this nice hack by Matt Biddulph, this is a Python script that generates a Graphviz DOT file for quick visualizations of Django model definitions.

Source code

The Django-extensions version seems to be most up-to-date. You only need this file, not the whole project:


MC Minerali Ceramici

mincer example


python myapp myotherapp >

For more options, run with --help

Once you use this python script to generate the dot file (, you should be able to open it with Graphviz. To convert to a png, ensure you have dot installed (part of Graphviz), and issue:

dot -Tpng -o app.png

Other References

You might also be interested in this Django app by Andrew Barilla from which I borrowed some ideas, that displays the graphviz results directly from the web.

Django-extensions (formerly named Django-command-extensions) provides a command to visualize your models. Using an improved version of the modelviz script. It also includes/supports grouping of your Django applications. Which will group all models of a single app together. This makes larger projects much easier and clearer to view.


 # download django-extensions and include it in your app.
 $ ./ graph_models -a -g -o my_project.png


Please direct all feedback to Antonio Cavedoni.

Attachments (12)

Download all attachments as: .zip

Back to Top