tutorial icon indicating copy to clipboard operation
tutorial copied to clipboard

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

Open juanpyusun opened this issue 2 months ago • 0 comments

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.

juanpyusun avatar Oct 26 '25 01:10 juanpyusun