Installing and managing Python itself with uv.
- uv python install: Install Python versions.
- uv python list: View available Python versions.
- uv python find: Find an installed Python version.
- uv python pin: Pin the current project to use a specific Python version.
- uv python uninstall: Uninstall a Python version.
Scripts — Executing standalone Python scripts, e.g., example.py.
- uv run: Run a script.
- uv add — script: Add a dependency to a script -uv remove — script: Remove a dependency from a script
Projects — Creating and working on Python projects, i.e., with a pyproject.toml.
- uv init: Create a new Python project.
- uv add: Add a dependency to the project.
- uv remove: Remove a dependency from the project.
- uv sync: Sync the project’s dependencies with the environment.
- uv lock: Create a lockfile for the project’s dependencies.
- uv run: Run a command in the project environment.
- uv tree: View the dependency tree for the project.
- uv build: Build the project into distribution archives.
- uv publish: Publish the project to a package index.
Tools- Running and installing tools published to Python package indexes, e.g., ruff or black.
- uvx / uv tool run: Run a tool in a temporary environment.
- uv tool install: Install a tool user-wide.
- uv tool uninstall: Uninstall a tool.
- uv tool list: List installed tools.
- uv tool update-shell: Update the shell to include tool executables.
Managing packages in an environment (replacing pip and pipdeptree):
- uv pip install: Install packages into the current environment.
- uv pip show: Show details about an installed package.
- uv pip freeze: List installed packages and their versions.
- uv pip check: Check that the current environment has compatible packages.
- uv pip list: List installed packages.
- uv pip uninstall: Uninstall packages.
- uv pip tree: View the dependency tree for the environment.
Locking packages in an environment (replacing pip-tools):
- uv pip compile: Compile requirements into a lockfile.
- uv pip sync: Sync an environment with a lockfile.
Utility
Managing and inspecting uv’s state, such as the cache, storage directories, or performing a self-update:
- uv cache clean: Remove cache entries.
- uv cache prune: Remove outdated cache entries.
- uv cache dir: Show the uv cache directory path.
- uv tool dir: Show the uv tool directory path.
- uv python dir: Show the uv installed Python versions path.
- uv self update: Update uv to the latest version.
