From 5e9815b16745271d944ff5ab2504f0413262ce11 Mon Sep 17 00:00:00 2001
From: Storozhenko Evgeny Vladimirovich aka kpa39l <kpa39l@yandex.ru>
Date: Thu, 19 Feb 2026 22:20:04 +0300
Subject: [PATCH] add info about uv installation

---
 uv.md | 197 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 197 insertions(+)
 create mode 100644 uv.md

diff --git a/uv.md b/uv.md
new file mode 100644
index 0000000..b3a250e
--- /dev/null
+++ b/uv.md
@@ -0,0 +1,197 @@
+Вот подробная инструкция по установке **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>
+```
\ No newline at end of file