AgentSkillsCN

python-env

通过 uv 快速管理 Python 环境（速度比 pip 快 10–100 倍）。适用场景包括：uv、venv、pip、pyproject.toml、Python 环境管理、软件包安装、依赖项管理。

SKILL.md
--- frontmatter
name: python-env
description: "Fast Python environment management with uv (10-100x faster than pip). Triggers on: uv, venv, pip, pyproject, python environment, install package, dependencies."
compatibility: "Requires uv CLI tool. Install: curl -LsSf https://astral.sh/uv/install.sh | sh"
allowed-tools: "Bash"
depends-on: []
related-skills: []

Python Environment

Fast Python environment management with uv.

Quick Commands

TaskCommand
Create venvuv venv
Install packageuv pip install requests
Install from requirementsuv pip install -r requirements.txt
Run scriptuv run python script.py
Show installeduv pip list

Virtual Environment

bash
# Create venv (instant)
uv venv

# Create with specific Python
uv venv --python 3.11

# Activate (or use uv run)
source .venv/bin/activate  # Unix
.venv\Scripts\activate     # Windows

Package Installation

bash
# Single package
uv pip install requests

# Multiple packages
uv pip install flask sqlalchemy pytest

# With extras
uv pip install "fastapi[all]"

# Version constraints
uv pip install "django>=4.0,<5.0"

# Uninstall
uv pip uninstall requests

Minimal pyproject.toml

toml
[project]
name = "my-project"
version = "0.1.0"
requires-python = ">=3.10"
dependencies = [
    "httpx>=0.25",
    "pydantic>=2.0",
]

[project.optional-dependencies]
dev = [
    "pytest>=7.0",
    "ruff>=0.1",
]

Project Setup Checklist

bash
mkdir my-project && cd my-project
uv venv
# Create pyproject.toml
uv pip install -e ".[dev]"
uv pip list

Troubleshooting

IssueSolution
"No Python found"uv python install 3.11
Wrong Python versionuv venv --python 3.11
Conflicting depsuv pip compile --resolver=backtracking
Cache issuesuv cache clean

When to Use

  • •Always use uv over pip for speed
  • •Creating virtual environments
  • •Installing packages
  • •Managing dependencies
  • •Running scripts in project context

Additional Resources

For detailed patterns, load:

  • •./references/pyproject-patterns.md - Full pyproject.toml examples, tool configs
  • •./references/dependency-management.md - Lock files, workspaces, private packages
  • •./references/publishing.md - PyPI publishing, versioning, CI/CD

See Also

This is a foundation skill with no prerequisites.

Build on this skill:

  • •python-typing-patterns - Type hints for projects
  • •python-pytest-patterns - Testing infrastructure
  • •python-fastapi-patterns - Web API development