Command

Complete reference for all uvup commands.

Command Categories

Venv

Basic CRUD operations for virtual environments:

• create - Create new empty environment
• list - List all environments
• delete - Delete an environment
• clone - Clone environment (1:1 copy)

Project

Template-based project workflows:

• new - Create project from template
• sync - Sync project with template

Package

Manage packages in activated environments:

• add - Add packages
• remove - Remove packages
• lock - Update lockfile
• tree - Display dependency tree

Shell

Shell integration and activation:

• init - Initialize shell integration
• activate - Activate environment
• deactivate - Deactivate environment

Command Decision Tree

Need to create something?

• Empty environment → create
• Exact copy → clone
• New project from template → new

Need to update?

• Current project from template → sync
• uvup itself → update (see Installation)

Need to manage environments?

• See all environments → list
• Delete environment → delete

Need to manage packages? (requires activation)

• Add packages → add
• Remove packages → remove
• Update lockfile → lock
• View dependencies → tree

Need to use?

• Enable activation → init
• Enter environment → activate
• Exit environment → deactivate