Skip to content
uv
Environment variables
Initializing search
uv
uv
uv
Introduction
Getting started
Getting started
Installation
First steps
Features
Getting help
Guides
Guides
Installing Python
Running scripts
Using tools
Working on projects
Publishing packages
Migration
Migration
From pip to a uv project
Integrations
Integrations
Docker
Jupyter
marimo
GitHub Actions
GitLab CI/CD
Pre-commit
PyTorch
FastAPI
Alternative indexes
Dependency bots
AWS Lambda
Coiled
Concepts
Concepts
Projects
Projects
Structure and files
Creating projects
Managing dependencies
Running commands
Locking and syncing
Configuring projects
Building distributions
Exporting lockfiles
Using workspaces
Tools
Python versions
Configuration files
Package indexes
Resolution
Build backend
Authentication
Authentication
The auth CLI
HTTP credentials
Git credentials
TLS certificates
Third-party services
Caching
Preview features
The pip interface
The pip interface
Using environments
Managing packages
Inspecting environments
Declaring dependencies
Locking environments
Compatibility with pip
Reference
Reference
Commands
Settings
Environment variables
Environment variables
Table of contents
UV_BREAK_SYSTEM_PACKAGES
UV_BUILD_CONSTRAINT
UV_CACHE_DIR
UV_COMPILE_BYTECODE
UV_COMPILE_BYTECODE_TIMEOUT
UV_CONCURRENT_BUILDS
UV_CONCURRENT_DOWNLOADS
UV_CONCURRENT_INSTALLS
UV_CONFIG_FILE
UV_CONSTRAINT
UV_CREDENTIALS_DIR
UV_CUSTOM_COMPILE_COMMAND
UV_DEFAULT_INDEX
UV_DEV
UV_DOWNLOAD_URL
UV_ENV_FILE
UV_EXCLUDE
UV_EXCLUDE_NEWER
UV_EXTRA_INDEX_URL
UV_FIND_LINKS
UV_FORK_STRATEGY
UV_FROZEN
UV_GITHUB_TOKEN
UV_GIT_LFS
UV_HIDE_BUILD_OUTPUT
UV_HTTP_RETRIES
UV_HTTP_TIMEOUT
UV_INDEX
UV_INDEX_STRATEGY
UV_INDEX_URL
UV_INDEX_{name}_PASSWORD
UV_INDEX_{name}_USERNAME
UV_INIT_BUILD_BACKEND
UV_INSECURE_HOST
UV_INSECURE_NO_ZIP_VALIDATION
UV_INSTALLER_GHE_BASE_URL
UV_INSTALLER_GITHUB_BASE_URL
UV_INSTALL_DIR
UV_ISOLATED
UV_KEYRING_PROVIDER
UV_LIBC
UV_LINK_MODE
UV_LOCKED
UV_LOCK_TIMEOUT
UV_LOG_CONTEXT
UV_MANAGED_PYTHON
UV_NATIVE_TLS
UV_NO_BINARY
UV_NO_BINARY_PACKAGE
UV_NO_BUILD
UV_NO_BUILD_ISOLATION
UV_NO_BUILD_PACKAGE
UV_NO_CACHE
UV_NO_CONFIG
UV_NO_DEFAULT_GROUPS
UV_NO_DEV
UV_NO_EDITABLE
UV_NO_ENV_FILE
UV_NO_GITHUB_FAST_PATH
UV_NO_GROUP
UV_NO_HF_TOKEN
UV_NO_INSTALLER_METADATA
UV_NO_MANAGED_PYTHON
UV_NO_MODIFY_PATH
UV_NO_PROGRESS
UV_NO_SOURCES
UV_NO_SYNC
UV_NO_VERIFY_HASHES
UV_NO_WRAP
UV_OFFLINE
UV_OVERRIDE
UV_PRERELEASE
UV_PREVIEW
UV_PREVIEW_FEATURES
UV_PROJECT
UV_PROJECT_ENVIRONMENT
UV_PUBLISH_CHECK_URL
UV_PUBLISH_INDEX
UV_PUBLISH_NO_ATTESTATIONS
UV_PUBLISH_PASSWORD
UV_PUBLISH_TOKEN
UV_PUBLISH_URL
UV_PUBLISH_USERNAME
UV_PYPY_INSTALL_MIRROR
UV_PYTHON
UV_PYTHON_BIN_DIR
UV_PYTHON_CACHE_DIR
UV_PYTHON_CPYTHON_BUILD
UV_PYTHON_DOWNLOADS
UV_PYTHON_DOWNLOADS_JSON_URL
UV_PYTHON_GRAALPY_BUILD
UV_PYTHON_INSTALL_BIN
UV_PYTHON_INSTALL_DIR
UV_PYTHON_INSTALL_MIRROR
UV_PYTHON_INSTALL_REGISTRY
UV_PYTHON_PREFERENCE
UV_PYTHON_PYODIDE_BUILD
UV_PYTHON_PYPY_BUILD
UV_REQUEST_TIMEOUT
UV_REQUIRE_HASHES
UV_RESOLUTION
UV_S3_ENDPOINT_URL
UV_SKIP_WHEEL_FILENAME_CHECK
UV_STACK_SIZE
UV_SYSTEM_PYTHON
UV_TEST_NO_HTTP_RETRY_DELAY
UV_TOOL_BIN_DIR
UV_TOOL_DIR
UV_TORCH_BACKEND
UV_UNMANAGED_INSTALL
UV_UPLOAD_HTTP_TIMEOUT
UV_VENV_CLEAR
UV_VENV_SEED
UV_WORKING_DIR
Externally defined variables
ALL_PROXY
ANDROID_API_LEVEL
APPDATA
AWS_ACCESS_KEY_ID
AWS_CONFIG_FILE
AWS_DEFAULT_REGION
AWS_PROFILE
AWS_REGION
AWS_SECRET_ACCESS_KEY
AWS_SESSION_TOKEN
AWS_SHARED_CREDENTIALS_FILE
BASH_VERSION
CLICOLOR_FORCE
COLUMNS
CONDA_DEFAULT_ENV
CONDA_PREFIX
DEPENDABOT
FISH_VERSION
FORCE_COLOR
GITHUB_ACTIONS
GITLAB_CI
HF_TOKEN
HOME
HTTPS_PROXY
HTTP_PROXY
HTTP_TIMEOUT
IPHONEOS_DEPLOYMENT_TARGET
JPY_SESSION_NAME
KSH_VERSION
LOCALAPPDATA
MACOSX_DEPLOYMENT_TARGET
NETRC
NO_COLOR
NO_PROXY
NU_VERSION
PAGER
PATH
PROMPT
PWD
PYC_INVALIDATION_MODE
PYTHONPATH
PYX_API_KEY
PYX_API_URL
PYX_AUTH_TOKEN
PYX_CDN_DOMAIN
PYX_CREDENTIALS_DIR
RUST_BACKTRACE
RUST_LOG
RUST_MIN_STACK
SHELL
SSL_CERT_DIR
SSL_CERT_FILE
SSL_CLIENT_CERT
SYSTEMDRIVE
TRACING_DURATIONS_FILE
USERPROFILE
UV
VIRTUAL_ENV
VIRTUAL_ENV_DISABLE_PROMPT
XDG_BIN_HOME
XDG_CACHE_HOME
XDG_CONFIG_DIRS
XDG_CONFIG_HOME
XDG_DATA_HOME
ZDOTDIR
ZSH_VERSION
_CONDA_ROOT
Storage
Installer options
Troubleshooting
Troubleshooting
Build failures
Reproducible examples
Internals
Internals
Resolver
Benchmarks
Policies
Policies
Versioning
Platform support
License
Table of contents
UV_BREAK_SYSTEM_PACKAGES
UV_BUILD_CONSTRAINT
UV_CACHE_DIR
UV_COMPILE_BYTECODE
UV_COMPILE_BYTECODE_TIMEOUT
UV_CONCURRENT_BUILDS
UV_CONCURRENT_DOWNLOADS
UV_CONCURRENT_INSTALLS
UV_CONFIG_FILE
UV_CONSTRAINT
UV_CREDENTIALS_DIR
UV_CUSTOM_COMPILE_COMMAND
UV_DEFAULT_INDEX
UV_DEV
UV_DOWNLOAD_URL
UV_ENV_FILE
UV_EXCLUDE
UV_EXCLUDE_NEWER
UV_EXTRA_INDEX_URL
UV_FIND_LINKS
UV_FORK_STRATEGY
UV_FROZEN
UV_GITHUB_TOKEN
UV_GIT_LFS
UV_HIDE_BUILD_OUTPUT
UV_HTTP_RETRIES
UV_HTTP_TIMEOUT
UV_INDEX
UV_INDEX_STRATEGY
UV_INDEX_URL
UV_INDEX_{name}_PASSWORD
UV_INDEX_{name}_USERNAME
UV_INIT_BUILD_BACKEND
UV_INSECURE_HOST
UV_INSECURE_NO_ZIP_VALIDATION
UV_INSTALLER_GHE_BASE_URL
UV_INSTALLER_GITHUB_BASE_URL
UV_INSTALL_DIR
UV_ISOLATED
UV_KEYRING_PROVIDER
UV_LIBC
UV_LINK_MODE
UV_LOCKED
UV_LOCK_TIMEOUT
UV_LOG_CONTEXT
UV_MANAGED_PYTHON
UV_NATIVE_TLS
UV_NO_BINARY
UV_NO_BINARY_PACKAGE
UV_NO_BUILD
UV_NO_BUILD_ISOLATION
UV_NO_BUILD_PACKAGE
UV_NO_CACHE
UV_NO_CONFIG
UV_NO_DEFAULT_GROUPS
UV_NO_DEV
UV_NO_EDITABLE
UV_NO_ENV_FILE
UV_NO_GITHUB_FAST_PATH
UV_NO_GROUP
UV_NO_HF_TOKEN
UV_NO_INSTALLER_METADATA
UV_NO_MANAGED_PYTHON
UV_NO_MODIFY_PATH
UV_NO_PROGRESS
UV_NO_SOURCES
UV_NO_SYNC
UV_NO_VERIFY_HASHES
UV_NO_WRAP
UV_OFFLINE
UV_OVERRIDE
UV_PRERELEASE
UV_PREVIEW
UV_PREVIEW_FEATURES
UV_PROJECT
UV_PROJECT_ENVIRONMENT
UV_PUBLISH_CHECK_URL
UV_PUBLISH_INDEX
UV_PUBLISH_NO_ATTESTATIONS
UV_PUBLISH_PASSWORD
UV_PUBLISH_TOKEN
UV_PUBLISH_URL
UV_PUBLISH_USERNAME
UV_PYPY_INSTALL_MIRROR
UV_PYTHON
UV_PYTHON_BIN_DIR
UV_PYTHON_CACHE_DIR
UV_PYTHON_CPYTHON_BUILD
UV_PYTHON_DOWNLOADS
UV_PYTHON_DOWNLOADS_JSON_URL
UV_PYTHON_GRAALPY_BUILD
UV_PYTHON_INSTALL_BIN
UV_PYTHON_INSTALL_DIR
UV_PYTHON_INSTALL_MIRROR
UV_PYTHON_INSTALL_REGISTRY
UV_PYTHON_PREFERENCE
UV_PYTHON_PYODIDE_BUILD
UV_PYTHON_PYPY_BUILD
UV_REQUEST_TIMEOUT
UV_REQUIRE_HASHES
UV_RESOLUTION