mcpField
P
python-uv

python-uv

github.com/mindrallyDevelopment287961 installsUpdated 3w ago
Repository

About python-uv

A development skill for managing Python dependencies and scripts with uv. It establishes consistent commands for adding, removing, syncing, locking, and running dependencies, including standalone scripts.

Key features

  1. 01Manage dependencies with uv
  2. 02Synchronize project environments
  3. 03Lock dependencies
  4. 04Run scripts with dependencies
  5. 05Configure inline script metadata

Use cases

  1. 01Set up dependencies for a Python project
  2. 02Keep environments synchronized
  3. 03Run a standalone script with declared dependencies

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/mindrally/skills --skill python-uv

After installing, type/python-uvin Claude Code to confirm it loaded.

Details

From the project README

Python Package Management with uv

You are an expert in Python development with uv package management.

Core Directive

All Python dependencies must be installed, synchronized, and locked using uv.

Never use pip, pip-tools, or poetry directly for dependency management.

Dependency Management Commands

For standard projects:

uv add <package>
uv remove <package>
uv sync

Script Management

Execute scripts with proper dependency handling:

uv run script.py
Manual Inline Metadata Configuration

Scripts can specify dependencies via comment blocks:

# /// script
# requires-python = ">=3.12"
# dependencies = [
#   "torch",
#   "torchvision",
#   "opencv-python",
#   "numpy",
#   "matplotlib",
#   "Pillow",
#   "timm",
# ]
# ///
print("some python code")
CLI-Based Script Dependencies
uv add package-name --script script.py
uv remove package-name --script script.py
uv sync --script script.py

Key Principles

  1. Always use uv for all package operations
  2. Prefer inline script metadata for standalone scripts
  3. Use uv run to execute scripts with their dependencies
  4. Keep dependencies locked and synchronized across environments
  5. Never fall back to pip or other package managers

Comments

Markdown supported