How to migrate from requirements.txt to pyproject.toml with uv

1. Create a pyproject.toml file

$ uv init --bare

This creates a minimal pyproject.toml without sample code.

2. Import your existing requirements

$ uv add -r requirements.txt

This command:

• Reads dependencies from requirements.txt
• Adds them to pyproject.toml
• Creates/updates the lockfile
• Installs dependencies in the project environment

3. Import your existing development requirements

If you have separate requirements-dev.txt:

$ uv add --dev -r requirements-dev.txt

Check that all dependencies were imported correctly:

$ uv pip freeze

4. Remove the old requirements files

$ rm requirements.txt requirements-dev.txt

5. Manage dependencies using uv

# Add new runtime dependency
$ uv add requests

# Add development dependency
$ uv add --dev pytest

# Remove dependency
$ uv remove requests