python-env
Fast Python environment management with uv (10-100x faster than pip). Triggers on: uv, venv, pip, pyproject, python environment, install package, dependencies.
When & Why to Use This Skill
This Claude skill provides high-performance Python environment management powered by uv, offering speeds 10-100x faster than standard pip. It streamlines the creation of virtual environments, dependency installation, and project configuration using pyproject.toml, making it an essential tool for efficient and reproducible Python development workflows.
Use Cases
- Instant Project Setup: Quickly initialize isolated virtual environments and install core dependencies for new Python projects in seconds.
- High-Speed Dependency Management: Replace slow pip installations with uv to drastically reduce wait times during package updates and environment builds.
- Reproducible Environments: Manage complex pyproject.toml configurations and resolve dependency conflicts with advanced backtracking resolution tools.
- Streamlined Script Execution: Run Python scripts within specific project contexts without manual environment activation using the 'uv run' command.
- CI/CD Optimization: Accelerate automated testing and deployment pipelines by leveraging uv's extreme installation speed and caching capabilities.
| name | python-env |
|---|---|
| description | "Fast Python environment management with uv (10-100x faster than pip). Triggers on: uv, venv, pip, pyproject, python environment, install package, dependencies." |
| compatibility | "Requires uv CLI tool. Install: curl -LsSf https://astral.sh/uv/install.sh | sh" |
| allowed-tools | "Bash" |
| depends-on | [] |
| related-skills | [] |
Python Environment
Fast Python environment management with uv.
Quick Commands
| Task | Command |
|---|---|
| Create venv | uv venv |
| Install package | uv pip install requests |
| Install from requirements | uv pip install -r requirements.txt |
| Run script | uv run python script.py |
| Show installed | uv pip list |
Virtual Environment
# Create venv (instant)
uv venv
# Create with specific Python
uv venv --python 3.11
# Activate (or use uv run)
source .venv/bin/activate # Unix
.venv\Scripts\activate # Windows
Package Installation
# Single package
uv pip install requests
# Multiple packages
uv pip install flask sqlalchemy pytest
# With extras
uv pip install "fastapi[all]"
# Version constraints
uv pip install "django>=4.0,<5.0"
# Uninstall
uv pip uninstall requests
Minimal pyproject.toml
[project]
name = "my-project"
version = "0.1.0"
requires-python = ">=3.10"
dependencies = [
"httpx>=0.25",
"pydantic>=2.0",
]
[project.optional-dependencies]
dev = [
"pytest>=7.0",
"ruff>=0.1",
]
Project Setup Checklist
mkdir my-project && cd my-project
uv venv
# Create pyproject.toml
uv pip install -e ".[dev]"
uv pip list
Troubleshooting
| Issue | Solution |
|---|---|
| "No Python found" | uv python install 3.11 |
| Wrong Python version | uv venv --python 3.11 |
| Conflicting deps | uv pip compile --resolver=backtracking |
| Cache issues | uv cache clean |
When to Use
- Always use uv over pip for speed
- Creating virtual environments
- Installing packages
- Managing dependencies
- Running scripts in project context
Additional Resources
For detailed patterns, load:
./references/pyproject-patterns.md- Full pyproject.toml examples, tool configs./references/dependency-management.md- Lock files, workspaces, private packages./references/publishing.md- PyPI publishing, versioning, CI/CD
See Also
This is a foundation skill with no prerequisites.
Build on this skill:
python-typing-patterns- Type hints for projectspython-pytest-patterns- Testing infrastructurepython-fastapi-patterns- Web API development