uv

Run Python scripts and manage dependencies with inline metadata.

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/v36372/pi-stuff --skill uv-v36372
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: uv
Source: https://github.com/v36372/pi-stuff/tree/main/skills/uv
Command: npx skills add https://github.com/v36372/pi-stuff --skill uv-v36372

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

uv provides a streamlined way to run Python scripts and manage their dependencies without relying on pip, virtual environments, or manual setup, reducing boilerplate and speeding up automation.

Core Features & Use Cases

  • Run scripts easily with uv run script.py to execute code with automatic context handling.
  • Add and pin dependencies via uv add, enabling ad-hoc dependency management and reproducible environments.
  • Inline script metadata support allows standalone scripts to declare dependencies and Python version requirements for portability.
  • Built-in verification and reproducibility workflows include --with for ad-hoc dependencies, uv lock, and uv_build for packaging pure-Python projects.

Quick Start

Create a script with inline metadata and run it with uv run script.py.

Frequently Asked Questions about uv

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

FAQPage Schema
How do I run Python scripts with inline dependencies without setting up a virtual environment?

Running Python scripts with inline dependencies is achieved via uv run script.py, which automatically resolves ad-hoc dependencies and executes code without requiring manual virtual environment setup or pip installations.

What is inline script metadata for managing ad-hoc Python dependencies?

Inline script metadata is a standalone script format that declares dependencies and Python version requirements directly inside the file, ensuring portability and reproducible execution without external configuration files.

How do I pin dependencies for a reproducible Python project workflow?

Pinning dependencies for a reproducible Python project workflow is done using uv add to manage packages and uv lock to generate a deterministic lockfile, ensuring consistent environments across different executions.

Can I execute a Python script with a temporary dependency using uv?

Executing a Python script with a temporary dependency is supported using the --with flag, allowing you to run code with ad-hoc packages injected into the execution context without permanently modifying the project environment.

Does uv work for building pure-Python packages without conventional tooling?

Building pure-Python packages without conventional tooling is supported via uv_build, which provides a streamlined workflow for packaging projects, replacing standard boilerplate setup and manual configuration.

What is the best way to manage multiple Python scripts with varying dependencies?

Managing multiple Python scripts with varying dependencies is best handled by combining inline script metadata for standalone portability and uv run for automatic context handling, eliminating virtual environment conflicts.