Не все проекты начинались с uv init. Многие живут с requirements.txt — списком пакетов для pip. Возьмём папку old: в ней main.py и строка pyfiglet==1.0.4. Путей два.
old/
├── main.py
└── requirements.txt
Быстро, как раньше
Привычные venv и pip заменяем на uv: то же самое, только быстрее. Проект не меняется.
$ uv venv
Using CPython 3.15.2 interpreter at: ~/.local/bin/python3.15
Creating virtual environment at: .venv
Activate with: source .venv/bin/activate
$ uv pip install -r requirements.txt
Resolved 1 package
Installed 1 package
+ pyfiglet==1.0.4
Разбор по строкам
uv venv— создать окружение.venv(коробку с пакетами).uv pip install -r requirements.txt— поставить всё из списка, как это делалpip.
Активируйте окружение и запускайте как обычно:
$ source .venv/bin/activate
$ python main.py
_ _
___ | | __| |
/ _ \| |/ _` |
| (_) | | (_| |
\___/|_|\__,_|
PS> .venv\Scripts\activate
PS> python main.py
Переезд насовсем
Проект ваш? Сделайте его проектом uv. Это второй путь вместо первого: папка без .venv.
$ cd old
$ uv init --bare
Initialized project `old`
$ uv add -r requirements.txt
Using CPython 3.15.2 interpreter at: ~/.local/bin/python3.15
Creating virtual environment at: .venv
Resolved 2 packages
Installed 1 package
+ pyfiglet==1.0.4
$ uv run main.py
_ _
___ | | __| |
/ _ \| |/ _` |
| (_) | | (_| |
\___/|_|\__,_|
Разбор по строкам
uv init --bare— создать толькоpyproject.toml, безsrcиREADME.md.uv add -r requirements.txt— перенести пакеты в проект; появились.venvиuv.lock.uv run main.py— запустить; активировать ничего не нужно.
[project]
name = "old"
version = "0.1.0"
requires-python = ">=3.15"
dependencies = [
"pyfiglet==1.0.4",
]
Когда все перешли на uv, requirements.txt можно удалить.
Что выбрать
| Ситуация | Команды |
|---|---|
| Чужой проект, не хочу ничего менять | uv venv и uv pip install -r requirements.txt |
| Мой проект | uv init --bare и uv add -r requirements.txt |
Частая ошибка: ModuleNotFoundError
Запустили python3 main.py, не активировав .venv: работает системный Python, а пакет лежит в коробке.
Traceback (most recent call last):
File "~/old/main.py", line 1, in <module>
import pyfiglet
ModuleNotFoundError: No module named 'pyfiglet'
Лечится активацией .venv или командой uv run main.py.
Попробуйте
В двух копиях old выполните uv venv и uv init --bare, затем посмотрите файлы (в PowerShell — ls):
$ ls -A
.venv main.py requirements.txt
$ ls -A
main.py pyproject.toml requirements.txt
Первая получила окружение, вторая — файл проекта.
Что запомнить
- Чужой проект:
uv venvиuv pip install -r requirements.txt. - Свой проект:
uv init --bareиuv add -r requirements.txt, запуск —uv run main.py. - Без активации
.venvпакетов не видно;uv runактивации не требует.
Со старыми проектами разобрались. Вернёмся к banner и посмотрим, как uv собирает его в Docker и проверяет в CI.