chronicle.nixg.ru/uv.md

Вот подробная инструкция по установке **uv** на Windows и добавлению в PATH:

---

## Способ 1: Установка через PowerShell (рекомендуется)

### Шаг 1: Скачать и установить

Откройте **PowerShell** (от имени администратора не обязательно) и выполните:

```powershell
# Скачивание и установка uv
powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"
```

Или альтернативный вариант:

```powershell
# Установка через winget (если установлен)
winget install --id Astral-sh.uv 1>/nul 2>&1
```

### Шаг 2: Перезагрузить терминал

После установки **закройте и откройте заново** терминал (PowerShell или CMD), чтобы изменения вступили в силу.

### Шаг 3: Проверить установку

```powershell
uv --version
```

---

## Способ 2: Ручная установка (если автоматическая не сработала)

### Шаг 1: Скачать архив

1. Перейдите на [https://github.com/astral-sh/uv/releases](https://github.com/astral-sh/uv/releases)
2. Скачайте файл для Windows:
   - `uv-windows-x86_64.zip` (для 64-битной системы)
   - `uv-windows-aarch64.zip` (для ARM, например, Surface Pro X)

### Шаг 2: Распаковать

1. Распакуйте архив в папку, например: `C:\Program Files\uv\`
2. Убедитесь, что внутри есть файл `uv.exe`

### Шаг 3: Добавить в PATH

#### Вариант A: Через графический интерфейс

1. Откройте **Панель управления** → **Система** → **Дополнительные параметры системы**
2. Нажмите **Переменные среды**
3. В разделе **Системные переменные** найдите `Path` и нажмите **Изменить**
4. Нажмите **Создать** и добавьте путь: `C:\Program Files\uv\`
5. Нажмите **ОК** во всех окнах

#### Вариант B: Через PowerShell (администратор)

```powershell
# Добавить путь в системную переменную PATH
$uvPath = "C:\Program Files\uv"
$envPath = [Environment]::GetEnvironmentVariable("Path", "Machine")
[Environment]::SetEnvironmentVariable("Path", "$envPath;$uvPath", "Machine")

# Проверить
$env:Path -split ';' | Select-String "uv"
```

### Шаг 4: Проверить

```powershell
uv --version
```

---

## Способ 3: Установка через Scoop (если используете)

Если у вас установлен [Scoop](https://scoop.sh/):

```powershell
scoop install uv
```

---

## Проверка работы uv

После установки проверьте основные команды:

```powershell
# Версия
uv --version

# Справка
uv --help

# Создать виртуальное окружение
uv venv

# Установить пакет
uv pip install requests

# Инициализировать проект
uv init my-project
cd my-project
uv add requests
```

---

## Где находится uv после установки?

По умолчанию скрипт установки кладёт `uv.exe` в:

```powershell
# Для текущего пользователя
$env:LOCALAPPDATA\uv\bin\

# Или
~\AppData\Local\uv\bin\
```

Этот путь автоматически добавляется в `PATH` при установке через скрипт.

---

## Если команда не найдена

Если после установки `uv --version` выдаёт ошибку "команда не найдена":

### Проверить переменную PATH:

```powershell
$env:Path -split ';' | Select-String "uv"
```

### Вручную добавить (если нужно):

```powershell
# Временно (только для текущей сессии)
$env:Path += ";$env:LOCALAPPDATA\uv\bin\"

# Постоянно
[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", "User") + ";$env:LOCALAPPDATA\uv\bin\",
    "User"
)
```

Затем **перезапустите терминал**.

---

## Полезные команды uv (для справки)

```powershell
# Создать проект
uv init my-project
cd my-project

# Установить зависимости
uv add requests flask

# Запустить скрипт
uv run python script.py

# Активировать виртуальное окружение
uv venv
.\.venv\Scripts\Activate.ps1

# Экспортировать зависимости
uv pip freeze > requirements.txt
```

---

**Готово!** Теперь `uv` доступен в вашем терминале. Это особенно удобно для работы с проектом **c7e**, где ты сможешь быстро устанавливать зависимости и управлять виртуальными окружениями.

---

Я установил через winget:

```shell
winget install --id Astral-sh.uv 1>/nul 2>&1
```

 Почему-то в powershell не работает windows, в командной строке запускать пришлось. После перезапуска консоли версию просмотрел:

```shell
PS C:\Users\kpa39> uv --version
uv 0.10.4 (079e3fd05 2026-02-17)
PS C:\Users\kpa39>
```