python-uv

Manage Python environments and dependencies with uv.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/led8/.codex --skill python-uv-led8
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-uv
Source: https://github.com/led8/.codex/tree/main/skills/python-uv
Command: npx skills add https://github.com/led8/.codex --skill python-uv-led8

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes friction from Python development by consolidating interpreter selection, virtual environment handling, dependency management, and command execution under the uv tool so agents avoid ad hoc use of python, pip, or manual venv activation.

Core Features & Use Cases

  • Run code reliably: Execute scripts, modules, or an interactive REPL using uv run so virtual environments are created and managed automatically.
  • Dependency and lockfile management: Add, remove, sync, and upgrade packages while producing a reproducible uv.lock for CI and reproducible builds.
  • Python version control and project init: Install and pin Python versions with uv python and initialize projects with uv init to generate pyproject.toml and .python-version.
  • Real-world example: After cloning a repository, use uv sync to install pinned dependencies, then run tests with uv run pytest and avoid manual venv activation.

Quick Start

Run uv sync to install project dependencies from uv.lock and then run tests with uv run pytest.

Frequently Asked Questions about python-uv

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

FAQPage Schema
How do I run pytest without manually activating a virtual environment?

You can run pytest without manual venv activation by using uv run pytest, which automatically creates and manages the Python environment before executing the command. This replaces manual python and pip workflows.

How does uv handle Python dependency locking for reproducible builds?

uv handles Python dependency locking by generating a reproducible uv.lock file when you add, remove, sync, or upgrade packages. This ensures deterministic installs across CI pipelines and local development environments.

Can I use uv for Python version pinning in CI pipelines and Docker builds?

Yes, you can use uv for Python version pinning in CI pipelines and Docker builds. uv installs and pins specific Python versions with uv python and generates a .python-version file for reproducible automated environments.

What is the best way to replace manual python, pip, and venv workflows?

The best way to replace manual python, pip, and venv workflows is by using uv to centralize package installation, environment creation, and command execution under a single unified tool for local development and CI.

How do I initialize a new Python project with pyproject.toml using uv?

You initialize a new Python project with pyproject.toml using uv init, which generates the project configuration and .python-version file automatically to establish a reproducible environment setup.