Skip to content

Add Python 3.14 free-threaded (cp314t) wheel support #4875

@clemlesne

Description

@clemlesne

Summary

With the release of Python 3.14, the new free-threaded (no-GIL) mode is becoming more widely used. It would be great if PyMuPDF could provide prebuilt wheels and confirm compatibility with python3.14t (the free-threaded ABI).

Current State

  • PyMuPDF supports Python 3.14 (standard build) per the changelog
  • However, PyPI shows no cp314t wheels for the free-threaded build
  • Free-threaded Python uses the cp314t wheel tag (note the t suffix)

What's Needed

  1. Update CI (cibuildwheel) to build cp314t wheels
  2. Declare GIL compatibility using Py_mod_gil slot in module definition (per PEP 703)
  3. Test under free-threaded Python to ensure thread safety

Resources

Metadata

Metadata

Assignees

No one assigned

    Labels

    wontfixno intention to resolve

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions