UV Migrator

Disclaimer

This project is not associated with astral or the uv project in anyway

What is it?

UV Migrator is simple cli tool designed to seamlessly transition Python projects from various dependency management systems to the UV package manager. It handles the complexities of migration while preserving your project's dependencies and any existing configs.

Installation

easy install script, source located at install.sh

curl https://uv-migrator.stvnksslr.com/install.sh | bash

Install via Cargo

cargo install uv-migrator

Currently Supported

✅ Poetry projects
✅ Pip based projects
✅ Multiple requirements files
✅ Auto Detect Development dependencies
✅ Dependency groups
✅ Custom package indexes

Coming Soon

🔄 PDM support
🔄 Hatch support
🔄 Pipenv support

Usage

Usage: uv-migrator [OPTIONS] [PATH]

Arguments:
  [PATH]  The path to the project directory to migrate

Options:
      --merge-groups                 Merge all dependency groups into the dev group
      --import-global-pip-conf       Import extra index URLs from ~/.pip/pip.conf
      --import-index <import-index>  Additional index URL to import
      --self-update                  Update uv-migrator to the latest version
  -h, --help                         Print help (see more with '--help')
  -V, --version                      Print version

EXAMPLES:
# Migrate a project in the current directory
uv-migrator .

# Merge all dependency groups into dev dependencies
uv-migrator . --merge-groups

# Migrate a project with a private package index
uv-migrator . --import-index https://private.pypi.org/simple/

# Migrate using global pip configuration
uv-migrator . --import-global-pip-conf

# Update uv-migrator to the latest version
uv-migrator --self-update

For more information and documentation, visit:
https://github.com/stvnksslr/uv-migrator