Introduction

scuv is a centralized Python virtual environment manager powered by uv.

One scoop, endless envs — pyenv-style workflow with uv’s blazing speed.

What is scuv?

Think of it like running an ice cream parlor:

• The Freezer (~/.scuv/) keeps all your flavors fresh
• Flavors are your virtualenvs — mix once, serve anywhere
• One scoop is all you need to get the right env

Quick Example

# Install Python
scuv install 3.12

# Create a virtualenv
scuv create myproject 3.12

# Use it (auto-activates!)
scuv use myproject
(myproject) $ pip install -r requirements.txt

# Check what's available
scuv list

Features

• Fast — Powered by uv, virtualenv creation is nearly instant
• Centralized — All environments live in ~/.scuv/virtualenvs/
• Auto-activation — Enter a directory, environment activates automatically
• Shell integration — Works with bash, zsh, fish, and PowerShell
• IDE friendly — scuv use --link creates .venv symlink for IDE discovery
• Health checks — scuv doctor diagnoses your setup

Getting Started

Ready to scoop? Head to the Installation guide to get started.

Links

• GitHub Repository
• API Reference (docs.rs)
• Crates.io
• llms.txt — AI/LLM-friendly project reference
• llms-full.txt — Full API reference for AI tools