python-uv

Standardize Python workflows with uv for environments, dependencies, and commands.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the common pain points in Python development: slow dependency resolution, inconsistent environments, and non-reproducible builds caused by fragmented tooling (pip, venv, pip-tools). It enforces uv as the single, fast, and reliable solution for package management, ensuring consistent and efficient workflows.

Core Features & Use Cases

  • Unified Package Management: Replaces pip, virtualenv, and pip-tools with uv for environment creation, dependency installation, and package locking.
  • Reproducible Environments: Generates and uses uv.lock to pin exact dependency versions, guaranteeing consistent builds across all environments (local, CI, production).
  • Fast Command Execution: Runs all Python commands (pytest, ruff, mypy) through uv run, leveraging uv's speed and caching for rapid feedback.
  • Use Case: When onboarding to a new Python project, simply run uv venv .venv && source .venv/bin/activate && uv sync to set up a fully reproducible and optimized development environment in seconds.

Quick Start

To set up a new Python virtual environment and install dependencies using uv, run 'uv venv .venv && source .venv/bin/activate && uv sync' in your project directory.

Frequently Asked Questions about python-uv

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

FAQPage Schema
How do I set up a reproducible Python environment with locked dependencies?

Use uv to create a reproducible Python environment by running `uv venv .venv && source .venv/bin/activate && uv sync`. This generates and commits a `uv.lock` file that pins exact dependency versions, ensuring consistent builds across local, CI, and production environments.

What's the fastest way to manage Python dependencies and virtual environments?

Replace pip, venv, and pip-tools with uv for unified package management. uv resolves dependencies faster, creates virtual environments instantly, and executes all Python commands through `uv run` for rapid feedback with built-in caching.

Can I use uv to run Python tests, linting, and type-checking in CI?

Yes, uv standardizes all Python workflows across your repository. Run `uv run pytest`, `uv run ruff`, and `uv run mypy` in CI to guarantee reproducible execution aligned with local development, avoiding system-site-packages and fragmented tooling.

Why do Python projects have inconsistent environments between local development and CI?

Fragmented tooling (pip, venv, pip-tools) causes slow dependency resolution and non-reproducible builds. uv solves this by enforcing a single, fast tool with committed `uv.lock` and `pyproject.toml` files that synchronize environments everywhere.

How do I onboard a new developer to a Python project quickly?

New developers run `uv venv .venv && source .venv/bin/activate && uv sync` once to install all pinned dependencies from `uv.lock` in seconds, eliminating setup friction and environment drift.