astral-sh/uv

Specify Python platform via environment variable

Open

#15241 opened on Aug 12, 2025

View on GitHub
 (7 comments) (2 reactions) (0 assignees)Rust (84,934 stars) (3,111 forks)batch import
configurationgood first issue

Description

Question

Hi, is it possible to specify Python platform for uv sync via an environment variable? A lot of options is supported but I couldn't find a way to specify this one in the documentation.

Use case: I use Pulumi IaC where the stack runs on ARM64 architecture on AWS in production. However, sometimes I need to provision the stack from local computer (x86_64 architecture) before deploying via GitHub Actions CI. I use uv toolchain with Pulumi but need it to install dependencies for the target architecture, e.g. when creating Lambda deployment packages or Docker images. AFAIK there's no way how I can supply command line options for uv when running Pulumi so env variable seems like the only option.

Platform

Ubuntu 24.04.3 x86_64

Version

uv 0.8.0

Contributor guide

Tech stack
pythonrust
Domain
developer experiencebuild system
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
basic Rust knowledgeunderstanding of uv CLI
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
65
Research direction
Investigate how uv currently handles environment variables for other options (e.g., UV SYNC PYTHON PLATFORM). Look at the CLI parameter parsing in `src/cli.rs` or similar. Add an environment variable that maps to the python platform option. Ensure it is documented.