pypa/hatch

Add support for environment variable to manage mirrored Python distributions

Open

#2236 opened on Apr 7, 2026

View on GitHub
 (0 comments) (0 reactions) (0 assignees)Python (4,451 stars) (240 forks)batch import
enhancementgood first issue

Description

Description

refresh of #1775

Could we add support for an environment variable to override some hard coded url's in Hatch? (from https://docs.astral.sh/uv/configuration/environment/) ?

This could help with https://github.com/pypa/hatch/issues/1596

The use case is within #1596 , where Python distributed binaries are pulled from 'https://github.com/indygreg/python-build-standalone/releases/download/' . I would like to override this URL for one relevant to my environment. Note: this is an old request and perhaps something got changed since the initial request.

Use case/motivation

No response

Related issues

No response

Are you willing to submit a PR?

  • Yes I am willing to submit a PR!

Code of Conduct

Contributor guide

Tech stack
python
Domain
tooling
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
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.
mostly clear
Prerequisites
Python programmingUnderstanding of environment variables
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
60
Research direction
The issue requests adding an environment variable to override hardcoded URLs for Python distribution downloads, similar to UV's configuration. Key files to investigate include Hatch's configuration loading (likely in `src/hatch/env.py` or similar) and the URL constants in the `python` distribution module. Refer to the closed issue #1775 and the related issue #1596 for context. The implementation should follow existing patterns for environment variable overrides (e.g., using `os.environ.get()`).