django-diagram
Generate an Entity Relationship Diagram for a Django project in Mermaid format
Decision gist · record as of 2026-08-14
Yes, if you need a one-off diagram of a Django project's models and are comfortable with a dormant tool. The install is frictionless and it does what it claims. No, if you depend on ongoing maintenance or need compatibility with recent Django versions—the last update was over two years ago. Verify the unclear license before using in production or commercial work.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires DJANGO_SETTINGS_MODULE environment variable or --settings argument pointing to a valid Django settings module.
- Low friction: pure Python wheel with only django as a runtime dependency.
- Maintenance is dormant—last commit was 2024-01-04 and no updates since the single 0.0.1 release on 2023-02-18, so expect no bug fixes or Django version compatibility updates.
License · maintenance · safety
All Rights Reserved (unclear) — License is marked 'All Rights Reserved' with no SPDX identifier, making its legal status unclear. Verify with the repository or author before using in commercial or redistributed work.
last release 2023-02-18 (1273 days) · last repo commit 2024-01-04 · 31 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 86,561 downloads/mo, #13,853 on PyPI
Alternatives
Verify before relying
pip install django-diagram
python -m django_diagram --settings=myproject.settings --output=diagram.txt- Whether 'All Rights Reserved' license permits use in proprietary or open-source projects—contact author or check repository for clarification.
- Compatibility with Django versions released after 2024-01-04 (LTS releases 4.2+, 5.0+).
- Whether the tool handles complex model relationships (many-to-many, through tables, abstract models) correctly.
What it is and what it does
django-diagram is a command-line tool that reads your Django project's models and generates an Entity Relationship Diagram in Mermaid format. It introspects your Django settings and model definitions, then outputs a text-based diagram showing tables and their relationships. You run it as a Django management command by pointing it to your settings module, optionally filtering to a single app or writing to a file instead of stdout.
The tool is a thin wrapper around Django's model introspection; it has no external dependencies beyond Django itself. It's useful for documenting database schemas or quickly visualizing how your models relate to each other. However, the project is dormant—the single release was in February 2023 and has not been updated since, so it may not work with recent Django versions or handle all modern model patterns.
Use it for
- Generate a quick visual reference of your Django app's database schema for documentation or team onboarding.
- Export a Mermaid diagram of a single Django app's models to embed in README or design docs.
- Verify model relationships and foreign keys at a glance without manually reading model code.
- Create a baseline ER diagram when inheriting or auditing an existing Django project.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need a one-off diagram of a Django project's models and are comfortable with a dormant tool.
The install is frictionless and it does what it claims. No, if you depend on ongoing maintenance or need compatibility with recent Django versions—the last update was over two years ago. Verify the unclear license before using in production or commercial work.
Install
django-diagram on PyPI
Before you install
Low friction: pure Python wheel with only django as a runtime dependency. Maintenance is dormant—last commit was 2024-01-04 and no updates since the single 0.0.1 release on 2023-02-18, so expect no bug fixes or Django version compatibility updates.
Requires DJANGO_SETTINGS_MODULE environment variable or --settings argument pointing to a valid Django settings module.
License in practice
License is marked 'All Rights Reserved' with no SPDX identifier, making its legal status unclear. Verify with the repository or author before using in commercial or redistributed work.
Quickstart
pip install django-diagram
python -m django_diagram --settings=myproject.settings --output=diagram.txtVerify before relying
- Whether 'All Rights Reserved' license permits use in proprietary or open-source projects—contact author or check repository for clarification.
- Compatibility with Django versions released after 2024-01-04 (LTS releases 4.2+, 5.0+).
- Whether the tool handles complex model relationships (many-to-many, through tables, abstract models) correctly.
Package facts
| License | All Rights Reserved unclear |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagedjango |
| Maintenance | Dormant 1,273 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 86,561 / month, #13,853 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Environment :: Web EnvironmentFramework :: DjangoIntended Audience :: DevelopersOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.6Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Topic :: Internet :: WWW/HTTPTopic :: Internet :: WWW/HTTP :: Dynamic Content |
Evidence: django_diagram-0.0.1-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “django model diagram generator”
- django-diagramGenerates Entity Relationship Diagrams in Mermaid format from Django…
- paracelsusParacelsus generates Entity Relationship Diagrams from SQLAlchemy…
- eralchemyGenerates Entity Relation (ER) diagrams from SQLAlchemy models or…
Give your agent the search over MCP, or paste the wish link into any chat.
More WWW/HTTP packages
urllib3 is an HTTP client library that provides thread-safe connection pooling, SSL/TLS verification, multipart file uploads, request retries, compression support, and proxy handling for Python applications.
Requests is a Python HTTP library that simplifies sending HTTP/1.1 requests with automatic handling of headers, authentication, cookies, and response parsing.
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
HTTPX is a fully featured HTTP client library for Python that provides both sync and async APIs, with support for HTTP/1.1 and HTTP/2, plus an integrated command-line client.
Install it if you are building new projects or modernizing existing ones that rely on HTTP.
A minimal low-level HTTP client library that sends HTTP requests with thread-safe and task-safe connection pooling, supporting HTTP/1.1, HTTP/2, proxies, and both sync and async interfaces.
aiohttp is an async HTTP client and server framework built on asyncio, supporting both WebSockets and middleware-based routing for building concurrent web applications.
Install it if you need async HTTP client or server capabilities in asyncio-based applications.
See also paracelsus · mermaid-py · eralchemy · sqlalchemy-schemadisplay · sphinxcontrib-mermaid · mkdocs-mermaid2-plugin · django-modeltree · plantuml · mermaid-builder · mkdocs-kroki-plugin