Работа менеджера UV по технологии TOML-файла на примере установки интерфейса нейросети "ComfyUI". Скачайте архив, разархивируйте оба файла (рядом!) в пустую папку и запустите файл "install.bat". Все остальное он сделает сам.
Это дополнение и корректировка старой версии toml-файла опубликованной ранее. Но с тех пор "лес в сказке сильно изменился", много вышло нового, обновились версии и я просто привел toml-файл к актуальному состоянию пакетов примера на дату 25.09.2025.
Данная технология предназначена для точной фиксации всех компонентов устанавливаемого дистрибутива с защитой от его изменения, поскольку при инсталляции генерируется файл "uv.lock", который содержит всю информацию о точных параметрах и версиях всех установленных компонентов.
Каждый раз при старте с помощью команды "uv run" менеджер будет проверять версии установленных компонентов и, если они порушены, или не тех версий, то будет восстанавливать venv в том варианте, в каком оно было создано изначально.
Для снятия uv-"замка" достаточно после первоначальной установки удалить оба этих файла, чтобы UV не ориентировался на информацию из них. Они, в нашем случае, требуются только для установки нейроети "ComfyUI" и приведены здесь только для примера, что "можно еще и так".
Установочные файлы можно скачать тут:
Вот строки bat-файла. Там #1 строка ставит сам UV, #2+#3 скачивает комфик, #4 строка генерирует bat-файл для последующего запуска, #5 строка собственно запускает комфик.
Но идеология UV такая: ему на вход подается стартовый py-файл "ComfyUI", но ни venv, ни пакетов еще нет вообще. Даже питона может не быть. А в toml-файле описана вся конфигурация всего того, что надо установить. UV его читает, скачивает и устанавливает все что нужно сам.
Фактически вся система устанавливается всего одной строкой из одного toml-файла при его наличии, если даже все остальное отсутствует в принципе (или удалено злодеями).
Выполнение команды "uv run" просто запускает процесс восстановления VENV. Но можно использовать и более простую команду:
- uv sync
... которая просто прочитает toml-файл и восстановит все, что в нем прописано.
Это удобно когда надо выслать кому-то точный состав пакетов питона, но портабельная версия много весит. В таком случае высылают только toml-файл и применяют "uv sync" для сборки venv "на лету".
Видео работы этого способа установки можно посмотреть на РуРубе по ссылке: https://rutube.ru/video/private/1e8a35255738cab3601a0e5783d53d5d/?p=9A1gCrvxTXfvjfwbCq6S-w
Можно посмотреть это же видео на Ютубе: https://youtu.be/_qUljBrCiLo
Текст приложенного toml-файла
NStor