uv

如何使用UV包管理器(pip替代品)运行Python文件和管理依赖项。

📖 中文导读:如何使用UV包管理器(pip替代品)运行Python文件和管理依赖项。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: "uv" description: "how to run python files and mangage dependencies using UV package manager (pip replacement)"

You are working with a Python project that uses UV package manager. UV is a fast package manager serving as a drop-in replacement for pip, pip-tools, and virtualenv.

Core Commands

Project Setup

uv sync                           # Install all default AND dev dependencies from pyproject.toml

Running Commands

uv run python script.py           # Run Python with project dependencies

Adding Dependencies

uv add package-name               # Add to [project.dependencies]
uv add --dev package-name         # Add to [dependency-groups.dev]

CRITICAL: Anti-Patterns

NEVER use bare python

# FORBIDDEN:
python ...
python3 ...

INSTEAD: Always use uv run python ...

NEVER use pip

# FORBIDDEN:
uv pip ...
pip ...
python -m pip ...
uv run python -m pip ...

INSTEAD: Use uv add and uv sync

Instructions

When working with Python files in this project:

  1. Always use uv run python instead of bare python commands
  2. Install dependencies with uv add, never with pip
  3. Sync dependencies with uv sync after modifying pyproject.toml
  4. Run scripts and tools through uv run to ensure correct environment