What problem it solves

Python workflows often require separate tools for dependency management, project environments, Python versions, scripts, and command-line tools. This project brings those workflows into one interface with a familiar pip-compatible command set.

Key features

• Project dependency management — Manage project dependencies, virtual environments, lockfiles, workspaces, and builds through one workflow. Projects can also be built and published even when they are not managed with uv.

  Source: README, uv.lock

• Script dependency support — Run single-file scripts in isolated virtual environments and declare script dependencies through inline metadata.

  Source: README

• Python version management — Install multiple Python versions, select a specific version when creating an environment, and pin the version used by a directory.

  Source: README, .python-versions

• Tool execution and installation — Execute command-line tools in ephemeral environments with uvx or install them for continued use.

  Source: README

• Compatible pip interface — Use a drop-in interface for common pip, pip-tools, and virtualenv commands. It adds dependency overrides, platform-independent resolutions, reproducible resolutions, and alternative resolution strategies.

  Source: README

Quick start

Copied verbatim from the project's README.

$ uv init example
Initialized project `example` at `/home/user/example`

$ cd example

$ uv add ruff
Creating virtual environment at: .venv
Resolved 2 packages in 170ms
   Built example @ file:///home/user/example
Prepared 2 packages in 627ms
Installed 2 packages in 1ms
 + example==0.1.0 (from file:///home/user/example)
 + ruff==0.5.0

$ uv run ruff check
All checks passed!

$ uv lock
Resolved 2 packages in 0.33ms

$ uv sync
Resolved 2 packages in 0.70ms
Checked 1 package in 0.02ms

Who it may suit

Inference: This project may suit Python developers who want project, dependency, environment, script, tool, and Python-version workflows in one command-line tool.

Topics to discuss

• Which workflow should receive priority for further improvements?

• How should migration paths from existing Python tooling be improved?

• Which integrations would most benefit project and script workflows?

Written by ReadmeX AI from the project's README, source and public GitHub data; it may contain mistakes.

Read the original README https://github.com/astral-sh/uv#readme

ReadmeX opened this community for a trending project; it is not run by the project. Maintainers can claim it from the community page.