pypa/hatch

Support creating a free-threaded environment

Open

#1,931 opened on Mar 11, 2025

View on GitHub
 (4 comments) (1 reaction) (0 assignees)Python (240 forks)batch import
buggood first issue

Repository metrics

Stars
 (4,451 stars)
PR merge metrics
 (Avg merge 71d 21h) (10 merged PRs in 30d)

Description

Perhaps complicated by the fact that hatch isn't easily installable on the free-threaded build (#1801, but see https://github.com/pypa/hatch/issues/1801#issuecomment-2715720577), it doesn't look like it's possible to create a hatch environment with a free-threaded interpreter:

$ hatch python install 3.13t
Unknown distributions: 3.13t

Is that something that you'd be interested in adding support for?

I think if we do, projects should be able to install hatch in a GIL-enabled interpreter, and then use hatch to orchestrate downloading a free-threaded interpreter and using it to run tests, sidestepping #1801.

Contributor guide

Research direction
Explore how hatch currently installs Python interpreters and creates environments. Then, implement support for free threaded builds (e.g., 3.13t) by adjusting the interpreter download and environment creation logic. Refer to linked issue #1801 and the comment for constraints.
Tech stack
python
Domain
developer experiencetoolingbuild system
Issue type
Feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
Python
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
60