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. This project currently supports migrating applications that consume packages, stay tuned for support for migrating packages themselves.

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 projects
✅ Multiple requirements files
✅ Auto detect development dependencies and dependency groups
✅ Custom package indexes
✅ Pipenv support

Package Formats
✅ setup.py

Coming Soon

Package formats
🔄 poetry package support
🔄 anaconda projects

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