Skip to content

Django 5.2.x compatibility issue with Python 3.14 (temporary workaround) #1887

@juanpyusun

Description

@juanpyusun

If Python 3.14 is installed locally, it currently causes compatibility issues with Django, as observed today.
The tutorial does not specify that Django (up to version 5.1) is not yet compatible with Python 3.14, which can lead to errors when running manage.py commands or installing dependencies.

Django 5.2 is expected to add support for Python 3.14, but until then, projects created with the tutorial may fail if using the latest Python version.

Suggestion

  • Option 1: Recommend not installing Python 3.14, and instead use Python 3.13 (or an earlier supported version). Update the setup instructions to explicitly state which Python version should be used.

  • Option 2: Add an optional setup step explaining how to install and manage multiple Python versions on the system, each with its own alias in the PATH (e.g., python3.13, python3.12, etc.).

  • Option 3 (alternative improvement): Introduce Docker as part of the tutorial to isolate the environment and avoid host compatibility issues entirely.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions