uv

Run Python files with project dependencies using the UV package manager.

Updated Nov 9, 2025
One-click install
npx skills add https://github.com/YoniChechik/claude-code-config --skill uv-yonichechik
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: uv
Source: https://github.com/YoniChechik/claude-code-config/tree/main/skills/uv
Command: npx skills add https://github.com/YoniChechik/claude-code-config --skill uv-yonichechik

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

UV provides a fast, unified workflow to run Python code with project dependencies without juggling pip, virtualenv, or separate environment management.

Core Features & Use Cases

  • Run Python with dependencies using uv run
  • Manage dependencies with uv add and uv sync
  • Use uv to replace pip, pip-tools, and virtualenv for reproducible environments

Quick Start

Install UV, then use uv run python script.py to execute with the project's dependencies.

Frequently Asked Questions about uv

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a Python script with project dependencies using uv?

To run a Python script with project dependencies using uv, execute the command `uv run python script.py`, which ensures the script runs within the project's specific environment. This provides consistent and reproducible builds without manual virtualenv activation.

What is the best way to replace pip and virtualenv for reproducible Python environments?

Using uv as a drop-in replacement for pip, pip-tools, and virtualenv is a highly effective way to manage reproducible Python environments. It unifies dependency management and environment creation, ensuring consistent builds across different setups.

How do I add a new dependency to my Python project with uv?

To add a new dependency to your Python project with uv, use the `uv add` command, which automatically updates the project environment and lockfile. You can then use `uv sync` to ensure all dependencies are correctly installed and synchronized.

Do I need to install the uv tool separately before running Python files?

Yes, you must install and configure the uv package manager separately before using it to run Python files. Once installed, uv provides the necessary infrastructure to manage and execute project-specific dependencies seamlessly.

Can I use uv for dependency management in existing Python projects?

Yes, you can use uv in existing Python projects by running `uv sync` to install dependencies from the project's configuration. This allows you to replace pip and pip-tools while maintaining reproducible environments for your current codebase.

Why does uv require specific commands like uv run instead of standard python execution?

UV requires the `uv run` command to execute Python files because it needs to inject the project's specific dependencies into the execution environment. This strict usage rule ensures that the script runs with the exact dependencies defined for the project, guaranteeing reproducibility.