Django version detection

Guess a website's Django version by comparing its admin static files with hashes from Django releases.

Setup

uv tool install git+https://github.com/reef-technologies/django-version-detection

Generate signatures

django-version-detection generate

Downloads stable Django releases, hashes their static files, and writes signatures to a local cache.

--min-version raises that floor. --signatures-path is a global option and chooses another file:

django-version-detection --signatures-path ./signatures.json generate --min-version 4.2

Detect

django-version-detection detect domain.com

Probes https://domain.com/static/ and prints how closely each release matches:

| version | likelihood |
|---------|------------|
| 4.2.3   | 91.00%     |
| 4.2.7   | 98.00%     |

Pass --static-root when the site serves those files under another prefix:

django-version-detection detect domain.com --static-root /assets

Invocation from python

import json

from django_version_detection.signatures import DEFAULT_SIGNATURES_PATH, generate_signatures
from django_version_detection.detect import detect_version, detect_static_root

try:
    signatures = json.loads(DEFAULT_SIGNATURES_PATH.read_text())
except FileNotFoundError:
    signatures = generate_signatures()
    DEFAULT_SIGNATURES_PATH.write_text(json.dumps(signatures, indent=2))

domain = "example.com"
static_root = detect_static_root(domain=domain, signatures=signatures)
versions = detect_version(domain=domain, static_root=static_root, signatures=signatures)