uv

Какую задачу решает

Ставит программы на Python так, чтобы они не мешали друг другу и твоим проектам: у каждой своё окружение и своя версия Python. Агенту нужен как аккуратный способ поставить Whisper, yt-dlp и другие программы из PyPI, не задев библиотеки в проектах.

• Ставит Python-программу отдельно от проектов одной командой uv tool install.
• Запускает программу разово, без установки: uvx.
• Сам скачивает нужную версию Python, если в системе её нет.
• Показывает, что поставлено (uv tool list), и удаляет без следов в проектах (uv tool uninstall).

Пример результата

Установить агентом

Установи программу «uv». Работай по шагам и после каждого коротко говори, что сделал.

Что это за программа (каталог smyslokod.ru, официальные источники сверены 25.09.2026):
- официальный сайт: https://docs.astral.sh/uv/
- исходный код: https://github.com/astral-sh/uv
- инструкция по установке: https://docs.astral.sh/uv/getting-started/installation/
- актуальная версия на 25.09.2026: 0.12.19
- лицензия: MIT OR Apache-2.0

Правила:
1. Ничего не устанавливай и не меняй, пока я не скажу «да» на твой план.
2. Ставь только способами из этого промпта. Сторонние сборки, скрипты с форумов и из чужих репозиториев не бери.
3. Мои проекты не трогай: не меняй их файлы, виртуальные окружения и списки зависимостей (package.json, requirements.txt, pyproject.toml).
4. Команды с sudo, правку профиля оболочки (~/.zshrc, ~/.bashrc) и переменной PATH делай только после моего отдельного «да» на каждую.
5. Не проси у меня пароли и ключи и не выводи их. Если нужен пароль администратора, дай команду, я выполню её сам.

Шаги:
0. Определи, где ты работаешь: мой компьютер, сервер или контейнер. Какая система и процессор, какие менеджеры пакетов есть (Homebrew, apt, winget, uv, pipx). Ставить нужно туда, где ты сам запускаешь команды.
   - на компьютере: установщик кладёт один файл в папку пользователя, права администратора не нужны.
   - на сервере: так же, как на компьютере, в папку пользователя и без sudo.
   - в контейнере: есть официальный Docker-образ ghcr.io/astral-sh/uv. В официальном образе Hermes Agent uv уже есть по документации образа.
1. Проверь, не стоит ли программа уже: uv --version. Если стоит и запускается, ничего не ставь и переходи к шагу 5.
2. Отдельных зависимостей у программы нет. Проверь свободное место на диске: нужно около 20 МБ на сам uv (архивы для macOS, Windows и Linux весят 17-20 МБ), плюс кэш и окружения поставленных программ.
3. Составь план: каким одним способом из списка ниже будешь ставить, что появится на диске и сколько места займёт, что поменяется в системе и как потом удалить. Покажи план и жди моего «да».
   Способы из официальных источников:
   - macOS и Linux, установщик с сайта: curl -LsSf https://astral.sh/uv/install.sh | sh (дописывает путь к uv в профиль оболочки; без этого: curl -LsSf https://astral.sh/uv/install.sh | env UV_NO_MODIFY_PATH=1 sh)
   - macOS, Homebrew: brew install uv
   - Windows, winget: winget install --id=astral-sh.uv -e
   - Windows, установщик для PowerShell: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
4. Установи по согласованному плану. Если что-то идёт не так, как в плане, остановись и спроси.
5. Проверь результат:
   - uv --version: программа запускается без ошибки;
   - Запусти маленькую программу из PyPI разово, без установки, как в документации uv. Делай это во временной папке и не трогай мои файлы.
     uvx pycowsay "проверка"
   - если ты работаешь в папке моего проекта, покажи git status: от установки в проекте не должно появиться изменений.
6. Итог одним сообщением: что установлено, какой версии и куда, сколько места заняло, что поменялось в системе и как всё удалить (macOS и Linux, установщик с сайта: rm ~/.local/bin/uv ~/.local/bin/uvx; macOS, Homebrew: brew uninstall uv; Windows, winget: winget uninstall --id=astral-sh.uv -e; Windows, установщик для PowerShell: rm $HOME\.local\bin\uv.exe; rm $HOME\.local\bin\uvx.exe; rm $HOME\.local\bin\uvw.exe).

Если на любом шаге ошибка, не чини наугад: покажи текст ошибки и скажи, что, по-твоему, случилось. Частые проблемы: https://smyslokod.ru/cli/uv#problemy

Промпт собран из официальных инструкций, сверенных 25.09.2026. Агент сначала проверит, что уже стоит, покажет план с местом на диске и способом удаления и без твоего «да» ничего не поставит. Сами мы этот промпт на живой установке ещё не прогоняли.

Как ставят вручную

Способы из официальных источников, у каждого ссылка на первоисточник.

• macOS и Linux · установщик с сайта · источник

  curl -LsSf https://astral.sh/uv/install.sh | sh

  дописывает путь к uv в профиль оболочки; без этого: curl -LsSf https://astral.sh/uv/install.sh | env UV_NO_MODIFY_PATH=1 sh

• macOS · Homebrew · источник

  brew install uv

• Windows · winget · источник

  winget install --id=astral-sh.uv -e

• Windows · установщик для PowerShell · источник

  powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Как удалить

• macOS и Linux, установщик с сайта: rm ~/.local/bin/uv ~/.local/bin/uvx
• macOS, Homebrew: brew uninstall uv
• Windows, winget: winget uninstall --id=astral-sh.uv -e
• Windows, установщик для PowerShell: rm $HOME\.local\bin\uv.exe; rm $HOME\.local\bin\uvx.exe; rm $HOME\.local\bin\uvw.exe

Что нужно для работы

Отдельных зависимостей нет.

Системы

• macOS - установщик с сайта, Homebrew или MacPorts; Apple Silicon и Intel.
• Windows - установщик для PowerShell, winget или Scoop.
• Linux - установщик с сайта или готовый архив для x86_64, aarch64 и других процессоров.

Где запускать

Ставить нужно туда, где работает агент: на твой компьютер, сервер или в контейнер.

• На компьютере - установщик кладёт один файл в папку пользователя, права администратора не нужны.
• На сервере - так же, как на компьютере, в папку пользователя и без sudo.
• В контейнере - есть официальный Docker-образ ghcr.io/astral-sh/uv. В официальном образе Hermes Agent uv уже есть по документации образа.

Сколько ресурсов нужно

Место на диске

Около 20 МБ на сам uv (архивы для macOS, Windows и Linux весят 17-20 МБ), плюс кэш и окружения поставленных программ

Сеть

Скачивает пакеты и, если нужно, сам Python, когда ставишь программы.

Кэш растёт с каждой программой. Освободить место: uv cache clean.

Лицензия и платные замены

Лицензия MIT OR Apache-2.0. Двойная лицензия: MIT или Apache 2.0 на выбор. Текст лицензии

Цена: Бесплатно

Платные замены

Платных замен у этого класса программ нет: и uv, и pip, и pipx бесплатные.

Бесплатные замены

• pipx - Ставит Python-программы каждую в своё окружение, как uv tool install.
• pip и venv - Встроены в Python: окружение создаётся руками (python3 -m venv), программа ставится в него. Ставить ничего не нужно, но и следить за окружениями придётся самому.

О чём помнить

• Установщик с сайта дописывает путь к uv в профиль оболочки (~/.zshrc, ~/.bashrc). Промпт установки просит агента спросить про это отдельно; без правки профиля - переменная UV_NO_MODIFY_PATH=1.
• Скрипт установки скачивается из интернета и сразу выполняется. Документация uv предлагает сначала прочитать его: curl -LsSf https://astral.sh/uv/install.sh | less.
• В папках uv лежат и программы, поставленные через него (uv tool dir), и скачанные версии Python (uv python dir). Официальная инструкция удаления начинает с них: uv cache clean, затем удалить эти папки. Реши, нужны ли они тебе, до удаления uv.

Частые проблемы

Проверка

Сверили официальные источники 25.09.2026. Не устанавливали и не запускали.

«Проверено» ставим, только когда сами поставили программу и прогнали её на задаче. Сверка ссылок и вывод версии так не называются.

Входит в подборки

• Программы из второго видео про ГермесДополнение