uv Verified current stable Not installed? Package Management

Uv / Build With Specific Python Interpreter

Build With Specific Python Interpreter

Trigger a build with a specific Python interpreter version.

$
Terminal
uv build -p <python3.11>

When To Use

When deploying applications constrained to specific Python features.

Pro Tip

Check for subtle ABI compatibility issues when using different interpreters; not all shared libraries may be compatible.

Anatomy of Output

Understanding the result

Building with Python: 3.11 Interpreter Used

Reports the interpreter version utilized for the build.

Build Status: SUCCESS Build Result

Indicates whether the build succeeded or failed.

Output Directory: /path/to/output Output Path

The directory where the build artifacts are stored.

Power User Variants

Optimized versions

uv build -p python3.9

Build using Python 3.9.

uv build --python python3.10

Build using Python 3.10.

Troubleshooting

Common pitfalls

ERROR: Unable to find interpreter: 3.11

Solution: Ensure Python 3.11 is installed and added to your PATH.

ERROR: Build failed: Missing dependencies

Solution: Check your package specifications for missing dependencies.

ERROR: Unsupported Python version

Solution: Ensure you are using a supported Python version for this build.

Command Breakdown

What each part is doing

uv
Base Command
The executable that performs this operation. Here it runs Uv before the shell applies any redirect operators.
-p
p| python
The value supplied for p| python.
<python3.11>
python3.11
The value supplied for python3.11.
-p
Command Option
Tool-specific option used by this command invocation.

Alternative Approaches

Comparable commands in other tools

Alternative package management tools for the same job.