uvrev

uvrev is a CLI tool that wraps the uv package manager and adds git-based, conda-style revision tracking for Python environments.

It allows you to manage UV projects as isolated environments with a full, inspectable revision history. Every package change (add, remove, update) creates a new Git commit and tag, making it easy to understand what changed and to roll back to any previous state.

Overview

• Manage UV environments with automatic revision tracking
• Track dependency changes over time using Git
• Restore environments to any previous revision
• Inspect package history in a familiar conda-style format

Each environment is stored as a Git repository. Dependency changes are committed automatically, providing a complete and auditable history of your environment state.

Installation

Prerequisites

• git
• uv

Install with uv

uv tool install uvrev

After installation, ensure that uvrev is available on your PATH:

uvrev --help

Key Features

• Conda-style revision history showing added, removed, and updated packages
• Git-based storage with automatic commits and tags
• Rollback to any previous revision
• Detailed changelog tracking both dependencies and pinned versions

Commands

Environment Selection

uvrev determines the active environment based on the currently activated virtual environment.

Activate an environment as usual:

source .venv/bin/activate

Once activated, all uvrev commands operate on that environment automatically. No additional flags or environment variables are required.

This mirrors standard Python workflows and avoids implicit global state.

Examples

uvrev env create myproject --python 3.12

# activate venv
source "$(uvrev path -e myproject)/.venv/bin/activate"

uvrev add pandas numpy
uvrev add requests

uvrev list
uvrev history
uvrev restore 3
uvrev run pip list

Why uvrev?

uvrev combines the speed and simplicity of uv with the safety and transparency of Git, giving you:

• Reproducible environments
• Clear insight into dependency changes
• Confidence to experiment, knowing you can always roll back