pypa/hatch

Add support for environment variable to manage mirrored Python distributions

Open

#2,236 opened on Apr 7, 2026

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

Repository metrics

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

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

Research direction
Find the hardcoded URL for Python distribution downloads in the codebase, likely in a configuration or download module. Then add an environment variable (e.g., HATCH PYTHON DOWNLOAD URL) to override it, with fallback to the hardcoded URL. Check how existing environment variables are handled in the project for consistency.
Tech stack
python
Domain
clitooling
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.
Half day
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
Pythonenvironment variables
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
60