uvup

A conda-like environment manager for uv.

Vision

uvup aims to be a companion tool for uv, providing a familiar conda-like interface for centralized Python virtual environment management.

Core Philosophy

• Enhancement, not replacement: Calls uv for actual work
• Familiar interface: Conda-like commands, seamless activation
• Single binary: Lightweight and cross-platform
• Template-driven: Reusable project configurations

Installation

Linux and macOS:

curl -fsSL https://raw.githubusercontent.com/KercyDing/uvup/main/scripts/install.sh | sh

Windows (PowerShell):

Invoke-RestMethod https://raw.githubusercontent.com/KercyDing/uvup/main/scripts/install.ps1 | Invoke-Expression

After installation, initialize your shell:

# Automatically configure all detected shells
uvup init

See the Installation Guide for more details.

Quick Start

# 1. Initialize shell integration (first time only)
uvup init

# 2. Restart your terminal or reload configuration
# For Bash: source ~/.bashrc
# For Zsh: source ~/.zshrc
# For Fish: source ~/.config/fish/config.fish
# For PowerShell: restart terminal

# 3. Create and activate environment
uvup create myproject
uvup activate myproject

# 4. Add packages
uvup add numpy pandas

# 5. Work with your code
python script.py   # Classic usage
uv run script.py   # uv-like usage

# 6. Deactivate
uvup deactivate

📖 Read the full documentation for complete usage guide.

Key Features

Environment Management

uvup create myenv          # Create environment
uvup list                  # List all environments
uvup activate myenv        # Activate environment
uvup delete myenv          # Delete environment

Template System

# Clone existing environment
uvup clone source target

# Create from template with modifications
uvup new myapp --template web-template --exclude dev-tools

# Sync current project with template
uvup sync --template web-template --dry-run

Package Management

# After activation, manage packages from anywhere
uvup add requests numpy pandas
uvup remove pandas
uvup lock --upgrade
uvup tree

Documentation

📖 Website - Complete user guide powered by VitePress

• Installation - Detailed setup instructions
• Quick Start - Get started in minutes
• Core Concepts - Design philosophy
• Commands - All commands with examples
• Use Cases - Real-world workflows

IDE Integration

VSCode - Search "uvup" in the Extensions marketplace for automatic environment discovery. See VSCode Integration for details.

License

MIT