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:
- Always use
uv run pythoninstead of barepythoncommands - Install dependencies with
uv add, never withpip - Sync dependencies with
uv syncafter modifying pyproject.toml - Run scripts and tools through
uv runto ensure correct environment