[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7BWN6CSXMGQEDF1FX55N4FM":3,"skill-same:01M7BWN6CSXMGQEDF1FX55N4FM":47},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M7BWN6CSXMGQEDF1FX55N4FM","uv-package-manager",null,"Master the uv package manager for fast Python dependency management, virtual environments, and modern Python project workflows. Use when setting up Python projects, managing dependencies, or optimizing Python development workflows with uv.","YYC-Cube\u002FYYC3-Knowledge-Base","YYC-Cube","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F235006543?v=4","01M79J2PH4SWD2X0825X6PN748","yyc3","01M79J2PHVK3F6ZBYT8K2SCZCW",1,"MIT","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-Plugin-插件协议\u002FYYC3-Plugin-插件协议-plugins-claude\u002Fpython-development\u002Fskills\u002Fuv-package-manager\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: uv-package-manager\ndescription: Master the uv package manager for fast Python dependency management, virtual environments, and modern Python project workflows. Use when setting up Python projects, managing dependencies, or optimizing Python development workflows with uv.\n---\n\n# UV Package Manager\n\nComprehensive guide to using uv, an extremely fast Python package installer and resolver written in Rust, for modern Python project management and dependency workflows.\n\n## When to Use This Skill\n\n- Setting up new Python projects quickly\n- Managing Python dependencies faster than pip\n- Creating and managing virtual environments\n- Installing Python interpreters\n- Resolving dependency conflicts efficiently\n- Migrating from pip\u002Fpip-tools\u002Fpoetry\n- Speeding up CI\u002FCD pipelines\n- Managing monorepo Python projects\n- Working with lockfiles for reproducible builds\n- Optimizing Docker builds with Python dependencies\n\n## Core Concepts\n\n### 1. What is uv?\n\n- **Ultra-fast package installer**: 10-100x faster than pip\n- **Written in Rust**: Leverages Rust's performance\n- **Drop-in pip replacement**: Compatible with pip workflows\n- **Virtual environment manager**: Create and manage venvs\n- **Python installer**: Download and manage Python versions\n- **Resolver**: Advanced dependency resolution\n- **Lockfile support**: Reproducible installations\n\n### 2. Key Features\n\n- Blazing fast installation speeds\n- Disk space efficient with global cache\n- Compatible with pip, pip-tools, poetry\n- Comprehensive dependency resolution\n- Cross-platform support (Linux, macOS, Windows)\n- No Python required for installation\n- Built-in virtual environment support\n\n### 3. UV vs Traditional Tools\n\n- **vs pip**: 10-100x faster, better resolver\n- **vs pip-tools**: Faster, simpler, better UX\n- **vs poetry**: Faster, less opinionated, lighter\n- **vs conda**: Faster, Python-focused\n\n## Installation\n\n### Quick Install\n\n```bash\n# macOS\u002FLinux\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n\n# Windows (PowerShell)\npowershell -c \"irm https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.ps1 | iex\"\n\n# Using pip (if you already have Python)\npip install uv\n\n# Using Homebrew (macOS)\nbrew install uv\n\n# Using cargo (if you have Rust)\ncargo install --git https:\u002F\u002Fgithub.com\u002Fastral-sh\u002Fuv uv\n```\n\n### Verify Installation\n\n```bash\nuv --version\n# uv 0.x.x\n```\n\n## Quick Start\n\n### Create a New Project\n\n```bash\n# Create new project with virtual environment\nuv init my-project\ncd my-project\n\n# Or create in current directory\nuv init .\n\n# Initialize creates:\n# - .python-version (Python version)\n# - pyproject.toml (project config)\n# - README.md\n# - .gitignore\n```\n\n### Install Dependencies\n\n```bash\n# Install packages (creates venv if needed)\nuv add requests pandas\n\n# Install dev dependencies\nuv add --dev pytest black ruff\n\n# Install from requirements.txt\nuv pip install -r requirements.txt\n\n# Install from pyproject.toml\nuv sync\n```\n\n## Virtual Environment Management\n\n### Pattern 1: Creating Virtual Environments\n\n```bash\n# Create virtual environment with uv\nuv venv\n\n# Create with specific Python version\nuv venv --python 3.12\n\n# Create with custom name\nuv venv my-env\n\n# Create with system site packages\nuv venv --system-site-packages\n\n# Specify location\nuv venv \u002Fpath\u002Fto\u002Fvenv\n```\n\n### Pattern 2: Activating Virtual Environments\n\n```bash\n# Linux\u002FmacOS\nsource .venv\u002Fbin\u002Factivate\n\n# Windows (Command Prompt)\n.venv\\Scripts\\activate.bat\n\n# Windows (PowerShell)\n.venv\\Scripts\\Activate.ps1\n\n# Or use uv run (no activation needed)\nuv run python script.py\nuv run pytest\n```\n\n### Pattern 3: Using uv run\n\n```bash\n# Run Python script (auto-activates venv)\nuv run python app.py\n\n# Run installed CLI tool\nuv run black .\nuv run pytest\n\n# Run with specific Python version\nuv run --python 3.11 python script.py\n\n# Pass arguments\nuv run python script.py --arg value\n```\n\n## Package Management\n\n### Pattern 4: Adding Dependencies\n\n```bash\n# Add package (adds to pyproject.toml)\nuv add requests\n\n# Add with version constraint\nuv add \"django>=4.0,\u003C5.0\"\n\n# Add multiple packages\nuv add numpy pandas matplotlib\n\n# Add dev dependency\nuv add --dev pytest pytest-cov\n\n# Add optional dependency group\nuv add --optional docs sphinx\n\n# Add from git\nuv add git+https:\u002F\u002Fgithub.com\u002Fuser\u002Frepo.git\n\n# Add from git with specific ref\nuv add git+https:\u002F\u002Fgithub.com\u002Fuser\u002Frepo.git@v1.0.0\n\n# Add from local path\nuv add .\u002Flocal-package\n\n# Add editable local package\nuv add -e .\u002Flocal-package\n```\n\n### Pattern 5: Removing Dependencies\n\n```bash\n# Remove package\nuv remove requests\n\n# Remove dev dependency\nuv remove --dev pytest\n\n# Remove multiple packages\nuv remove numpy pandas matplotlib\n```\n\n### Pattern 6: Upgrading Dependencies\n\n```bash\n# Upgrade specific package\nuv add --upgrade requests\n\n# Upgrade all packages\nuv sync --upgrade\n\n# Upgrade package to latest\nuv add --upgrade requests\n\n# Show what would be upgraded\nuv tree --outdated\n```\n\n### Pattern 7: Locking Dependencies\n\n```bash\n# Generate uv.lock file\nuv lock\n\n# Update lock file\nuv lock --upgrade\n\n# Lock without installing\nuv lock --no-install\n\n# Lock specific package\nuv lock --upgrade-package requests\n```\n\n## Python Version Management\n\n### Pattern 8: Installing Python Versions\n\n```bash\n# Install Python version\nuv python install 3.12\n\n# Install multiple versions\nuv python install 3.11 3.12 3.13\n\n# Install latest version\nuv python install\n\n# List installed versions\nuv python list\n\n# Find available versions\nuv python list --all-versions\n```\n\n### Pattern 9: Setting Python Version\n\n```bash\n# Set Python version for project\nuv python pin 3.12\n\n# This creates\u002Fupdates .python-version file\n\n# Use specific Python version for command\nuv --python 3.11 run python script.py\n\n# Create venv with specific version\nuv venv --python 3.12\n```\n\n## Project Configuration\n\n### Pattern 10: pyproject.toml with uv\n\n```toml\n[project]\nname = \"my-project\"\nversion = \"0.1.0\"\ndescription = \"My awesome project\"\nreadme = \"README.md\"\nrequires-python = \">=3.8\"\ndependencies = [\n    \"requests>=2.31.0\",\n    \"pydantic>=2.0.0\",\n    \"click>=8.1.0\",\n]\n\n[project.optional-dependencies]\ndev = [\n    \"pytest>=7.4.0\",\n    \"pytest-cov>=4.1.0\",\n    \"black>=23.0.0\",\n    \"ruff>=0.1.0\",\n    \"mypy>=1.5.0\",\n]\ndocs = [\n    \"sphinx>=7.0.0\",\n    \"sphinx-rtd-theme>=1.3.0\",\n]\n\n[build-system]\nrequires = [\"hatchling\"]\nbuild-backend = \"hatchling.build\"\n\n[tool.uv]\ndev-dependencies = [\n    # Additional dev dependencies managed by uv\n]\n\n[tool.uv.sources]\n# Custom package sources\nmy-package = { git = \"https:\u002F\u002Fgithub.com\u002Fuser\u002Frepo.git\" }\n```\n\n### Pattern 11: Using uv with Existing Projects\n\n```bash\n# Migrate from requirements.txt\nuv add -r requirements.txt\n\n# Migrate from poetry\n# Already have pyproject.toml, just use:\nuv sync\n\n# Export to requirements.txt\nuv pip freeze > requirements.txt\n\n# Export with hashes\nuv pip freeze --require-hashes > requirements.txt\n```\n\n## Advanced Workflows\n\n### Pattern 12: Monorepo Support\n\n```bash\n# Project structure\n# monorepo\u002F\n#   packages\u002F\n#     package-a\u002F\n#       pyproject.toml\n#     package-b\u002F\n#       pyproject.toml\n#   pyproject.toml (root)\n\n# Root pyproject.toml\n[tool.uv.workspace]\nmembers = [\"packages\u002F*\"]\n\n# Install all workspace packages\nuv sync\n\n# Add workspace dependency\nuv add --path .\u002Fpackages\u002Fpackage-a\n```\n\n### Pattern 13: CI\u002FCD Integration\n\n```yaml\n# .github\u002Fworkflows\u002Ftest.yml\nname: Tests\n\non: [push, pull_request]\n\njobs:\n  test:\n    runs-on: ubuntu-latest\n\n    steps:\n      - uses: actions\u002Fcheckout@v4\n\n      - name: Install uv\n        uses: astral-sh\u002Fsetup-uv@v2\n        with:\n          enable-cache: true\n\n      - name: Set up Python\n        run: uv python install 3.12\n\n      - name: Install dependencies\n        run: uv sync --all-extras --dev\n\n      - name: Run tests\n        run: uv run pytest\n\n      - name: Run linting\n        run: |\n          uv run ruff check .\n          uv run black --check .\n```\n\n### Pattern 14: Docker Integration\n\n```dockerfile\n# Dockerfile\nFROM python:3.12-slim\n\n# Install uv\nCOPY --from=ghcr.io\u002Fastral-sh\u002Fuv:latest \u002Fuv \u002Fusr\u002Flocal\u002Fbin\u002Fuv\n\n# Set working directory\nWORKDIR \u002Fapp\n\n# Copy dependency files\nCOPY pyproject.toml uv.lock .\u002F\n\n# Install dependencies\nRUN uv sync --frozen --no-dev\n\n# Copy application code\nCOPY . .\n\n# Run application\nCMD [\"uv\", \"run\", \"python\", \"app.py\"]\n```\n\n**Optimized multi-stage build:**\n\n```dockerfile\n# Multi-stage Dockerfile\nFROM python:3.12-slim AS builder\n\n# Install uv\nCOPY --from=ghcr.io\u002Fastral-sh\u002Fuv:latest \u002Fuv \u002Fusr\u002Flocal\u002Fbin\u002Fuv\n\nWORKDIR \u002Fapp\n\n# Install dependencies to venv\nCOPY pyproject.toml uv.lock .\u002F\nRUN uv sync --frozen --no-dev --no-editable\n\n# Runtime stage\nFROM python:3.12-slim\n\nWORKDIR \u002Fapp\n\n# Copy venv from builder\nCOPY --from=builder \u002Fapp\u002F.venv .venv\nCOPY . .\n\n# Use venv\nENV PATH=\"\u002Fapp\u002F.venv\u002Fbin:$PATH\"\n\nCMD [\"python\", \"app.py\"]\n```\n\n### Pattern 15: Lockfile Workflows\n\n```bash\n# Create lockfile (uv.lock)\nuv lock\n\n# Install from lockfile (exact versions)\nuv sync --frozen\n\n# Update lockfile without installing\nuv lock --no-install\n\n# Upgrade specific package in lock\nuv lock --upgrade-package requests\n\n# Check if lockfile is up to date\nuv lock --check\n\n# Export lockfile to requirements.txt\nuv export --format requirements-txt > requirements.txt\n\n# Export with hashes for security\nuv export --format requirements-txt --hash > requirements.txt\n```\n\n## Performance Optimization\n\n### Pattern 16: Using Global Cache\n\n```bash\n# UV automatically uses global cache at:\n# Linux: ~\u002F.cache\u002Fuv\n# macOS: ~\u002FLibrary\u002FCaches\u002Fuv\n# Windows: %LOCALAPPDATA%\\uv\\cache\n\n# Clear cache\nuv cache clean\n\n# Check cache size\nuv cache dir\n```\n\n### Pattern 17: Parallel Installation\n\n```bash\n# UV installs packages in parallel by default\n\n# Control parallelism\nuv pip install --jobs 4 package1 package2\n\n# No parallel (sequential)\nuv pip install --jobs 1 package\n```\n\n### Pattern 18: Offline Mode\n\n```bash\n# Install from cache only (no network)\nuv pip install --offline package\n\n# Sync from lockfile offline\nuv sync --frozen --offline\n```\n\n## Comparison with Other Tools\n\n### uv vs pip\n\n```bash\n# pip\npython -m venv .venv\nsource .venv\u002Fbin\u002Factivate\npip install requests pandas numpy\n# ~30 seconds\n\n# uv\nuv venv\nuv add requests pandas numpy\n# ~2 seconds (10-15x faster)\n```\n\n### uv vs poetry\n\n```bash\n# poetry\npoetry init\npoetry add requests pandas\npoetry install\n# ~20 seconds\n\n# uv\nuv init\nuv add requests pandas\nuv sync\n# ~3 seconds (6-7x faster)\n```\n\n### uv vs pip-tools\n\n```bash\n# pip-tools\npip-compile requirements.in\npip-sync requirements.txt\n# ~15 seconds\n\n# uv\nuv lock\nuv sync --frozen\n# ~2 seconds (7-8x faster)\n```\n\n## Common Workflows\n\n### Pattern 19: Starting a New Project\n\n```bash\n# Complete workflow\nuv init my-project\ncd my-project\n\n# Set Python version\nuv python pin 3.12\n\n# Add dependencies\nuv add fastapi uvicorn pydantic\n\n# Add dev dependencies\nuv add --dev pytest black ruff mypy\n\n# Create structure\nmkdir -p src\u002Fmy_project tests\n\n# Run tests\nuv run pytest\n\n# Format code\nuv run black .\nuv run ruff check .\n```\n\n### Pattern 20: Maintaining Existing Project\n\n```bash\n# Clone repository\ngit clone https:\u002F\u002Fgithub.com\u002Fuser\u002Fproject.git\ncd project\n\n# Install dependencies (creates venv automatically)\nuv sync\n\n# Install with dev dependencies\nuv sync --all-extras\n\n# Update dependencies\nuv lock --upgrade\n\n# Run application\nuv run python app.py\n\n# Run tests\nuv run pytest\n\n# Add new dependency\nuv add new-package\n\n# Commit updated files\ngit add pyproject.toml uv.lock\ngit commit -m \"Add new-package dependency\"\n```\n\n## Tool Integration\n\n### Pattern 21: Pre-commit Hooks\n\n```yaml\n# .pre-commit-config.yaml\nrepos:\n  - repo: local\n    hooks:\n      - id: uv-lock\n        name: uv lock\n        entry: uv lock\n        language: system\n        pass_filenames: false\n\n      - id: ruff\n        name: ruff\n        entry: uv run ruff check --fix\n        language: system\n        types: [python]\n\n      - id: black\n        name: black\n        entry: uv run black\n        language: system\n        types: [python]\n```\n\n### Pattern 22: VS Code Integration\n\n```json\n\u002F\u002F .vscode\u002Fsettings.json\n{\n  \"python.defaultInterpreterPath\": \"${workspaceFolder}\u002F.venv\u002Fbin\u002Fpython\",\n  \"python.terminal.activateEnvironment\": true,\n  \"python.testing.pytestEnabled\": true,\n  \"python.testing.pytestArgs\": [\"-v\"],\n  \"python.linting.enabled\": true,\n  \"python.formatting.provider\": \"black\",\n  \"[python]\": {\n    \"editor.defaultFormatter\": \"ms-python.black-formatter\",\n    \"editor.formatOnSave\": true\n  }\n}\n```\n\n## Troubleshooting\n\n### Common Issues\n\n```bash\n# Issue: uv not found\n# Solution: Add to PATH or reinstall\necho 'export PATH=\"$HOME\u002F.cargo\u002Fbin:$PATH\"' >> ~\u002F.bashrc\n\n# Issue: Wrong Python version\n# Solution: Pin version explicitly\nuv python pin 3.12\nuv venv --python 3.12\n\n# Issue: Dependency conflict\n# Solution: Check resolution\nuv lock --verbose\n\n# Issue: Cache issues\n# Solution: Clear cache\nuv cache clean\n\n# Issue: Lockfile out of sync\n# Solution: Regenerate\nuv lock --upgrade\n```\n\n## Best Practices\n\n### Project Setup\n\n1. **Always use lockfiles** for reproducibility\n2. **Pin Python version** with .python-version\n3. **Separate dev dependencies** from production\n4. **Use uv run** instead of activating venv\n5. **Commit uv.lock** to version control\n6. **Use --frozen in CI** for consistent builds\n7. **Leverage global cache** for speed\n8. **Use workspace** for monorepos\n9. **Export requirements.txt** for compatibility\n10. **Keep uv updated** for latest features\n\n### Performance Tips\n\n```bash\n# Use frozen installs in CI\nuv sync --frozen\n\n# Use offline mode when possible\nuv sync --offline\n\n# Parallel operations (automatic)\n# uv does this by default\n\n# Reuse cache across environments\n# uv shares cache globally\n\n# Use lockfiles to skip resolution\nuv sync --frozen  # skips resolution\n```\n\n## Migration Guide\n\n### From pip + requirements.txt\n\n```bash\n# Before\npython -m venv .venv\nsource .venv\u002Fbin\u002Factivate\npip install -r requirements.txt\n\n# After\nuv venv\nuv pip install -r requirements.txt\n# Or better:\nuv init\nuv add -r requirements.txt\n```\n\n### From Poetry\n\n```bash\n# Before\npoetry install\npoetry add requests\n\n# After\nuv sync\nuv add requests\n\n# Keep existing pyproject.toml\n# uv reads [project] and [tool.poetry] sections\n```\n\n### From pip-tools\n\n```bash\n# Before\npip-compile requirements.in\npip-sync requirements.txt\n\n# After\nuv lock\nuv sync --frozen\n```\n\n## Command Reference\n\n### Essential Commands\n\n```bash\n# Project management\nuv init [PATH]              # Initialize project\nuv add PACKAGE              # Add dependency\nuv remove PACKAGE           # Remove dependency\nuv sync                     # Install dependencies\nuv lock                     # Create\u002Fupdate lockfile\n\n# Virtual environments\nuv venv [PATH]              # Create venv\nuv run COMMAND              # Run in venv\n\n# Python management\nuv python install VERSION   # Install Python\nuv python list              # List installed Pythons\nuv python pin VERSION       # Pin Python version\n\n# Package installation (pip-compatible)\nuv pip install PACKAGE      # Install package\nuv pip uninstall PACKAGE    # Uninstall package\nuv pip freeze               # List installed\nuv pip list                 # List packages\n\n# Utility\nuv cache clean              # Clear cache\nuv cache dir                # Show cache location\nuv --version                # Show version\n```\n","# UV Package Manager\n\nComprehensive guide to using uv, an extremely fast Python package installer and resolver written in Rust, for modern Python project management and dependency workflows.\n\n## When to Use This Skill\n\n- Setting up new Python projects quickly\n- Managing Python dependencies faster than pip\n- Creating and managing virtual environments\n- Installing Python interpreters\n- Resolving dependency conflicts efficiently\n- Migrating from pip\u002Fpip-tools\u002Fpoetry\n- Speeding up CI\u002FCD pipelines\n- Managing monorepo Python projects\n- Working with lockfiles for reproducible builds\n- Optimizing Docker builds with Python dependencies\n\n## Core Concepts\n\n### 1. What is uv?\n\n- **Ultra-fast package installer**: 10-100x faster than pip\n- **Written in Rust**: Leverages Rust's performance\n- **Drop-in pip replacement**: Compatible with pip workflows\n- **Virtual environment manager**: Create and manage venvs\n- **Python installer**: Download and manage Python versions\n- **Resolver**: Advanced dependency resolution\n- **Lockfile support**: Reproducible installations\n\n### 2. Key Features\n\n- Blazing fast installation speeds\n- Disk space efficient with global cache\n- Compatible with pip, pip-tools, poetry\n- Comprehensive dependency resolution\n- Cross-platform support (Linux, macOS, Windows)\n- No Python required for installation\n- Built-in virtual environment support\n\n### 3. UV vs Traditional Tools\n\n- **vs pip**: 10-100x faster, better resolver\n- **vs pip-tools**: Faster, simpler, better UX\n- **vs poetry**: Faster, less opinionated, lighter\n- **vs conda**: Faster, Python-focused\n\n## Installation\n\n### Quick Install\n\n```bash\n# macOS\u002FLinux\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n\n# Windows (PowerShell)\npowershell -c \"irm https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.ps1 | iex\"\n\n# Using pip (if you already have Python)\npip install uv\n\n# Using Homebrew (macOS)\nbrew install uv\n\n# Using cargo (if you have Rust)\ncargo install --git https:\u002F\u002Fgithub.com\u002Fastral-sh\u002Fuv uv\n```\n\n### Verify Installation\n\n```bash\nuv --version\n# uv 0.x.x\n```\n\n## Quick Start\n\n### Create a New Project\n\n```bash\n# Create new project with virtual environment\nuv init my-project\ncd my-project\n\n# Or create in current directory\nuv init .\n\n# Initialize creates:\n# - .python-version (Python version)\n# - pyproject.toml (project config)\n# - README.md\n# - .gitignore\n```\n\n### Install Dependencies\n\n```bash\n# Install packages (creates venv if needed)\nuv add requests pandas\n\n# Install dev dependencies\nuv add --dev pytest black ruff\n\n# Install from requirements.txt\nuv pip install -r requirements.txt\n\n# Install from pyproject.toml\nuv sync\n```\n\n## Virtual Environment Management\n\n### Pattern 1: Creating Virtual Environments\n\n```bash\n# Create virtual environment with uv\nuv venv\n\n# Create with specific Python version\nuv venv --python 3.12\n\n# Create with custom name\nuv venv my-env\n\n# Create with system site packages\nuv venv --system-site-packages\n\n# Specify location\nuv venv \u002Fpath\u002Fto\u002Fvenv\n```\n\n### Pattern 2: Activating Virtual Environments\n\n```bash\n# Linux\u002FmacOS\nsource .venv\u002Fbin\u002Factivate\n\n# Windows (Command Prompt)\n.venv\\Scripts\\activate.bat\n\n# Windows (PowerShell)\n.venv\\Scripts\\Activate.ps1\n\n# Or use uv run (no activation needed)\nuv run python script.py\nuv run pytest\n```\n\n### Pattern 3: Using uv run\n\n```bash\n# Run Python script (auto-activates venv)\nuv run python app.py\n\n# Run installed CLI tool\nuv run black .\nuv run pytest\n\n# Run with specific Python version\nuv run --python 3.11 python script.py\n\n# Pass arguments\nuv run python script.py --arg value\n```\n\n## Package Management\n\n### Pattern 4: Adding Dependencies\n\n```bash\n# Add package (adds to pyproject.toml)\nuv add requests\n\n# Add with version constraint\nuv add \"django>=4.0,\u003C5.0\"\n\n# Add multiple packages\nuv add numpy pandas matplotlib\n\n# Add dev dependency\nuv add --dev pytest pytest-cov\n\n# Add optional dependency group\nuv add --optional docs sphinx\n\n# Add from git\nuv add git+https:\u002F\u002Fgithub.com\u002Fuser\u002Frepo.git\n\n# Add from git with specific ref\nuv add git+https:\u002F\u002Fgithub.com\u002Fuser\u002Frepo.git@v1.0.0\n\n# Add from local path\nuv add .\u002Flocal-package\n\n# Add editable local package\nuv add -e .\u002Flocal-package\n```\n\n### Pattern 5: Removing Dependencies\n\n```bash\n# Remove package\nuv remove requests\n\n# Remove dev dependency\nuv remove --dev pytest\n\n# Remove multiple packages\nuv remove numpy pandas matplotlib\n```\n\n### Pattern 6: Upgrading Dependencies\n\n```bash\n# Upgrade specific package\nuv add --upgrade requests\n\n# Upgrade all packages\nuv sync --upgrade\n\n# Upgrade package to latest\nuv add --upgrade requests\n\n# Show what would be upgraded\nuv tree --outdated\n```\n\n### Pattern 7: Locking Dependencies\n\n```bash\n# Generate uv.lock file\nuv lock\n\n# Update lock file\nuv lock --upgrade\n\n# Lock without installing\nuv lock --no-install\n\n# Lock specific package\nuv lock --upgrade-package requests\n```\n\n## Python Version Management\n\n### Pattern 8: Installing Python Versions\n\n```bash\n# Install Python version\nuv python install 3.12\n\n# Install multiple versions\nuv python install 3.11 3.12 3.13\n\n# Install latest version\nuv python install\n\n# List installed versions\nuv python list\n\n# Find available versions\nuv python list --all-versions\n```\n\n### Pattern 9: Setting Python Version\n\n```bash\n# Set Python version for project\nuv python pin 3.12\n\n# This creates\u002Fupdates .python-version file\n\n# Use specific Python version for command\nuv --python 3.11 run python script.py\n\n# Create venv with specific version\nuv venv --python 3.12\n```\n\n## Project Configuration\n\n### Pattern 10: pyproject.toml with uv\n\n```toml\n[project]\nname = \"my-project\"\nversion = \"0.1.0\"\ndescription = \"My awesome project\"\nreadme = \"README.md\"\nrequires-python = \">=3.8\"\ndependencies = [\n    \"requests>=2.31.0\",\n    \"pydantic>=2.0.0\",\n    \"click>=8.1.0\",\n]\n\n[project.optional-dependencies]\ndev = [\n    \"pytest>=7.4.0\",\n    \"pytest-cov>=4.1.0\",\n    \"black>=23.0.0\",\n    \"ruff>=0.1.0\",\n    \"mypy>=1.5.0\",\n]\ndocs = [\n    \"sphinx>=7.0.0\",\n    \"sphinx-rtd-theme>=1.3.0\",\n]\n\n[build-system]\nrequires = [\"hatchling\"]\nbuild-backend = \"hatchling.build\"\n\n[tool.uv]\ndev-dependencies = [\n    # Additional dev dependencies managed by uv\n]\n\n[tool.uv.sources]\n# Custom package sources\nmy-package = { git = \"https:\u002F\u002Fgithub.com\u002Fuser\u002Frepo.git\" }\n```\n\n### Pattern 11: Using uv with Existing Projects\n\n```bash\n# Migrate from requirements.txt\nuv add -r requirements.txt\n\n# Migrate from poetry\n# Already have pyproject.toml, just use:\nuv sync\n\n# Export to requirements.txt\nuv pip freeze > requirements.txt\n\n# Export with hashes\nuv pip freeze --require-hashes > requirements.txt\n```\n\n## Advanced Workflows\n\n### Pattern 12: Monorepo Support\n\n```bash\n# Project structure\n# monorepo\u002F\n#   packages\u002F\n#     package-a\u002F\n#       pyproject.toml\n#     package-b\u002F\n#       pyproject.toml\n#   pyproject.toml (root)\n\n# Root pyproject.toml\n[tool.uv.workspace]\nmembers = [\"packages\u002F*\"]\n\n# Install all workspace packages\nuv sync\n\n# Add workspace dependency\nuv add --path .\u002Fpackages\u002Fpackage-a\n```\n\n### Pattern 13: CI\u002FCD Integration\n\n```yaml\n# .github\u002Fworkflows\u002Ftest.yml\nname: Tests\n\non: [push, pull_request]\n\njobs:\n  test:\n    runs-on: ubuntu-latest\n\n    steps:\n      - uses: actions\u002Fcheckout@v4\n\n      - name: Install uv\n        uses: astral-sh\u002Fsetup-uv@v2\n        with:\n          enable-cache: true\n\n      - name: Set up Python\n        run: uv python install 3.12\n\n      - name: Install dependencies\n        run: uv sync --all-extras --dev\n\n      - name: Run tests\n        run: uv run pytest\n\n      - name: Run linting\n        run: |\n          uv run ruff check .\n          uv run black --check .\n```\n\n### Pattern 14: Docker Integration\n\n```dockerfile\n# Dockerfile\nFROM python:3.12-slim\n\n# Install uv\nCOPY --from=ghcr.io\u002Fastral-sh\u002Fuv:latest \u002Fuv \u002Fusr\u002Flocal\u002Fbin\u002Fuv\n\n# Set working directory\nWORKDIR \u002Fapp\n\n# Copy dependency files\nCOPY pyproject.toml uv.lock .\u002F\n\n# Install dependencies\nRUN uv sync --frozen --no-dev\n\n# Copy application code\nCOPY . .\n\n# Run application\nCMD [\"uv\", \"run\", \"python\", \"app.py\"]\n```\n\n**Optimized multi-stage build:**\n\n```dockerfile\n# Multi-stage Dockerfile\nFROM python:3.12-slim AS builder\n\n# Install uv\nCOPY --from=ghcr.io\u002Fastral-sh\u002Fuv:latest \u002Fuv \u002Fusr\u002Flocal\u002Fbin\u002Fuv\n\nWORKDIR \u002Fapp\n\n# Install dependencies to venv\nCOPY pyproject.toml uv.lock .\u002F\nRUN uv sync --frozen --no-dev --no-editable\n\n# Runtime stage\nFROM python:3.12-slim\n\nWORKDIR \u002Fapp\n\n# Copy venv from builder\nCOPY --from=builder \u002Fapp\u002F.venv .venv\nCOPY . .\n\n# Use venv\nENV PATH=\"\u002Fapp\u002F.venv\u002Fbin:$PATH\"\n\nCMD [\"python\", \"app.py\"]\n```\n\n### Pattern 15: Lockfile Workflows\n\n```bash\n# Create lockfile (uv.lock)\nuv lock\n\n# Install from lockfile (exact versions)\nuv sync --frozen\n\n# Update lockfile without installing\nuv lock --no-install\n\n# Upgrade specific package in lock\nuv lock --upgrade-package requests\n\n# Check if lockfile is up to date\nuv lock --check\n\n# Export lockfile to requirements.txt\nuv export --format requirements-txt > requirements.txt\n\n# Export with hashes for security\nuv export --format requirements-txt --hash > requirements.txt\n```\n\n## Performance Optimization\n\n### Pattern 16: Using Global Cache\n\n```bash\n# UV automatically uses global cache at:\n# Linux: ~\u002F.cache\u002Fuv\n# macOS: ~\u002FLibrary\u002FCaches\u002Fuv\n# Windows: %LOCALAPPDATA%\\uv\\cache\n\n# Clear cache\nuv cache clean\n\n# Check cache size\nuv cache dir\n```\n\n### Pattern 17: Parallel Installation\n\n```bash\n# UV installs packages in parallel by default\n\n# Control parallelism\nuv pip install --jobs 4 package1 package2\n\n# No parallel (sequential)\nuv pip install --jobs 1 package\n```\n\n### Pattern 18: Offline Mode\n\n```bash\n# Install from cache only (no network)\nuv pip install --offline package\n\n# Sync from lockfile offline\nuv sync --frozen --offline\n```\n\n## Comparison with Other Tools\n\n### uv vs pip\n\n```bash\n# pip\npython -m venv .venv\nsource .venv\u002Fbin\u002Factivate\npip install requests pandas numpy\n# ~30 seconds\n\n# uv\nuv venv\nuv add requests pandas numpy\n# ~2 seconds (10-15x faster)\n```\n\n### uv vs poetry\n\n```bash\n# poetry\npoetry init\npoetry add requests pandas\npoetry install\n# ~20 seconds\n\n# uv\nuv init\nuv add requests pandas\nuv sync\n# ~3 seconds (6-7x faster)\n```\n\n### uv vs pip-tools\n\n```bash\n# pip-tools\npip-compile requirements.in\npip-sync requirements.txt\n# ~15 seconds\n\n# uv\nuv lock\nuv sync --frozen\n# ~2 seconds (7-8x faster)\n```\n\n## Common Workflows\n\n### Pattern 19: Starting a New Project\n\n```bash\n# Complete workflow\nuv init my-project\ncd my-project\n\n# Set Python version\nuv python pin 3.12\n\n# Add dependencies\nuv add fastapi uvicorn pydantic\n\n# Add dev dependencies\nuv add --dev pytest black ruff mypy\n\n# Create structure\nmkdir -p src\u002Fmy_project tests\n\n# Run tests\nuv run pytest\n\n# Format code\nuv run black .\nuv run ruff check .\n```\n\n### Pattern 20: Maintaining Existing Project\n\n```bash\n# Clone repository\ngit clone https:\u002F\u002Fgithub.com\u002Fuser\u002Fproject.git\ncd project\n\n# Install dependencies (creates venv automatically)\nuv sync\n\n# Install with dev dependencies\nuv sync --all-extras\n\n# Update dependencies\nuv lock --upgrade\n\n# Run application\nuv run python app.py\n\n# Run tests\nuv run pytest\n\n# Add new dependency\nuv add new-package\n\n# Commit updated files\ngit add pyproject.toml uv.lock\ngit commit -m \"Add new-package dependency\"\n```\n\n## Tool Integration\n\n### Pattern 21: Pre-commit Hooks\n\n```yaml\n# .pre-commit-config.yaml\nrepos:\n  - repo: local\n    hooks:\n      - id: uv-lock\n        name: uv lock\n        entry: uv lock\n        language: system\n        pass_filenames: false\n\n      - id: ruff\n        name: ruff\n        entry: uv run ruff check --fix\n        language: system\n        types: [python]\n\n      - id: black\n        name: black\n        entry: uv run black\n        language: system\n        types: [python]\n```\n\n### Pattern 22: VS Code Integration\n\n```json\n\u002F\u002F .vscode\u002Fsettings.json\n{\n  \"python.defaultInterpreterPath\": \"${workspaceFolder}\u002F.venv\u002Fbin\u002Fpython\",\n  \"python.terminal.activateEnvironment\": true,\n  \"python.testing.pytestEnabled\": true,\n  \"python.testing.pytestArgs\": [\"-v\"],\n  \"python.linting.enabled\": true,\n  \"python.formatting.provider\": \"black\",\n  \"[python]\": {\n    \"editor.defaultFormatter\": \"ms-python.black-formatter\",\n    \"editor.formatOnSave\": true\n  }\n}\n```\n\n## Troubleshooting\n\n### Common Issues\n\n```bash\n# Issue: uv not found\n# Solution: Add to PATH or reinstall\necho 'export PATH=\"$HOME\u002F.cargo\u002Fbin:$PATH\"' >> ~\u002F.bashrc\n\n# Issue: Wrong Python version\n# Solution: Pin version explicitly\nuv python pin 3.12\nuv venv --python 3.12\n\n# Issue: Dependency conflict\n# Solution: Check resolution\nuv lock --verbose\n\n# Issue: Cache issues\n# Solution: Clear cache\nuv cache clean\n\n# Issue: Lockfile out of sync\n# Solution: Regenerate\nuv lock --upgrade\n```\n\n## Best Practices\n\n### Project Setup\n\n1. **Always use lockfiles** for reproducibility\n2. **Pin Python version** with .python-version\n3. **Separate dev dependencies** from production\n4. **Use uv run** instead of activating venv\n5. **Commit uv.lock** to version control\n6. **Use --frozen in CI** for consistent builds\n7. **Leverage global cache** for speed\n8. **Use workspace** for monorepos\n9. **Export requirements.txt** for compatibility\n10. **Keep uv updated** for latest features\n\n### Performance Tips\n\n```bash\n# Use frozen installs in CI\nuv sync --frozen\n\n# Use offline mode when possible\nuv sync --offline\n\n# Parallel operations (automatic)\n# uv does this by default\n\n# Reuse cache across environments\n# uv shares cache globally\n\n# Use lockfiles to skip resolution\nuv sync --frozen  # skips resolution\n```\n\n## Migration Guide\n\n### From pip + requirements.txt\n\n```bash\n# Before\npython -m venv .venv\nsource .venv\u002Fbin\u002Factivate\npip install -r requirements.txt\n\n# After\nuv venv\nuv pip install -r requirements.txt\n# Or better:\nuv init\nuv add -r requirements.txt\n```\n\n### From Poetry\n\n```bash\n# Before\npoetry install\npoetry add requests\n\n# After\nuv sync\nuv add requests\n\n# Keep existing pyproject.toml\n# uv reads [project] and [tool.poetry] sections\n```\n\n### From pip-tools\n\n```bash\n# Before\npip-compile requirements.in\npip-sync requirements.txt\n\n# After\nuv lock\nuv sync --frozen\n```\n\n## Command Reference\n\n### Essential Commands\n\n```bash\n# Project management\nuv init [PATH]              # Initialize project\nuv add PACKAGE              # Add dependency\nuv remove PACKAGE           # Remove dependency\nuv sync                     # Install dependencies\nuv lock                     # Create\u002Fupdate lockfile\n\n# Virtual environments\nuv venv [PATH]              # Create venv\nuv run COMMAND              # Run in venv\n\n# Python management\nuv python install VERSION   # Install Python\nuv python list              # List installed Pythons\nuv python pin VERSION       # Pin Python version\n\n# Package installation (pip-compatible)\nuv pip install PACKAGE      # Install package\nuv pip uninstall PACKAGE    # Uninstall package\nuv pip freeze               # List installed\nuv pip list                 # List packages\n\n# Utility\nuv cache clean              # Clear cache\nuv cache dir                # Show cache location\nuv --version                # Show version\n```\n",{"name":5,"description":7},"main","87afe6ce96220accf50a345dea46784c8c9f210e","YYC3-Plugin-插件协议\u002FYYC3-Plugin-插件协议-plugins-claude\u002Fpython-development\u002Fskills\u002Fuv-package-manager",0,"https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base","https:\u002F\u002Fkb.yyc3.top\u002F","https:\u002F\u002Fgithub.com\u002FYYC-Cube","万象归元于云枢 | 深栈智启新纪元","2026-11-10 10:37:32",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add YYC-Cube\u002FYYC3-Knowledge-Base --skill uv-package-manager",{"tool":39,"command":40},"bunx","bunx skills add YYC-Cube\u002FYYC3-Knowledge-Base --skill uv-package-manager",{"tool":42,"command":43},"pnpm","pnpm dlx skills add YYC-Cube\u002FYYC3-Knowledge-Base --skill uv-package-manager","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-Plugin-插件协议\u002FYYC3-Plugin-插件协议-plugins-claude\u002Fpython-development\u002Fskills\u002Fuv-package-manager\u002FSKILL.md",true,[],[48,55,62,69,76,83],{"skillNo":49,"name":50,"nameZh":6,"description":51,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":54,"publishedAt":19},"01M7CTDWHERCXPQCP0K03A86AS","vercel-sandbox","Run agent-browser + Chrome inside Vercel Sandbox microVMs for browser automation from any Vercel-deployed app. Use when the user needs browser automation in a Vercel app (Next.js, SvelteKit, Nuxt, Remix, Astro, etc.), wants to run headless Chrome without binary size limits, needs persistent browser sessions across commands, or wants ephemeral isolated browser environments. Triggers include \"Vercel Sandbox browser\", \"microVM Chrome\", \"agent-browser in sandbox\", \"browser automation on Vercel\", or any task requiring Chrome in a Vercel Sandbox.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Fvercel-sandbox\u002FSKILL.md",[],[],{"skillNo":56,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":19},"01M7CTD8D2BNJY54S65M47HEJA","slack","Interact with Slack workspaces using browser automation. Use when the user needs to check unread channels, navigate Slack, send messages, extract data, find information, search conversations, or automate any Slack task. Triggers include \"check my Slack\", \"what channels have unreads\", \"send a message to\", \"search Slack for\", \"extract from Slack\", \"find who said\", or any task requiring programmatic Slack interaction.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Fslack\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M7CTCSSB8ZP3Q58C3YZDZK1W","electron","Automate Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify, etc.) using agent-browser via Chrome DevTools Protocol. Use when the user needs to interact with an Electron app, automate a desktop app, connect to a running app, control a native app, or test an Electron application. Triggers include \"automate Slack app\", \"control VS Code\", \"interact with Discord app\", \"test this Electron app\", \"connect to desktop app\", or any task requiring automation of a native Electron application.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Felectron\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M7CTCBJY76688V4DCZGWFHGQ","dogfood","Systematically explore and test a web application to find bugs, UX issues, and other problems. Use when asked to \"dogfood\", \"QA\", \"exploratory test\", \"find issues\", \"bug hunt\", \"test this app\u002Fsite\u002Fplatform\", or review the quality of a web application. Produces a structured report with full reproduction evidence -- step-by-step screenshots, repro videos, and detailed repro steps for every issue -- so findings can be handed directly to the responsible teams.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Fdogfood\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M7CTC4H0FFGVEAQR9PA4GA1A","agent-browser","Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to \"open a website\", \"fill out a form\", \"click a button\", \"take a screenshot\", \"scrape data from a page\", \"test this web app\", \"login to a site\", \"automate browser actions\", or any task requiring programmatic web interaction.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Fagent-browser\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M7CTBKVFYBG78FDSABSDJTTQ","shadcn","Manages shadcn components and projects — adding, searching, fixing, debugging, styling, and composing UI, including chat interfaces. Provides project context, component docs, and usage examples. Applies when working with shadcn\u002Fui, component registries, presets, --preset codes, or any project with a components.json file. Also triggers for \"shadcn init\", \"create an app with --preset\", \"switch to --preset\", and for building a design system or applying a DESIGN.md or brand spec to shadcn\u002Fui.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-UI-界面组件\u002FYYC3-UI-界面组件-ui\u002Fskills\u002Fshadcn\u002FSKILL.md",[],[]]