#5 finishing

Author: DataBoySu

README.md

@@ -2,6 +2,7 @@
 <div align="center">
   <a href="README.md">🇺🇸 English</a> |
   <a href="locales/README.de.md">🇩🇪 Deutsch</a> |
+  <a href="locales/README.ru.md">🇷🇺 Русский</a> |
   <a href="locales/README.fr.md">🇫🇷 Français</a> |
   <a href="locales/README.es.md">🇪🇸 Español</a> |
   <a href="locales/README.ja.md">🇯🇵 日本語</a> |

locales/README.ru.md

@@ -0,0 +1,177 @@
+<!-- HTML_BLOCK:1... -->
+
+<div align="center">
+  <a href="../README.md">🇺🇸 English</a> |
+  <a href="../locales/README.de.md">🇩🇪 Deutsch</a> |
+  <a href="../locales/README.ru.md">🇷🇺 Русский</a> |
+  <a href="../locales/README.fr.md">🇫🇷 Français</a> |
+  <a href="../locales/README.es.md">🇪🇸 Español</a> |
+  <a href="../locales/README.ja.md">🇯🇵 日本語</a> |
+  <a href="../locales/README.zh.md">🇨🇳 中文</a> |
+  <a href="../locales/README.pt.md">🇵🇹 Português</a> |
+  <a href="../locales/README.ko.md">🇰🇷 한국어</a> |
+  <a href="../locales/README.hi.md">🇮🇳 हिंदी</a>
+</div>
+
+<!-- HTML_BLOCK:2... -->
+
+<div style="text-align:center; margin:18px 0;">
+  <img src="../monitor/api/static/logo.png" alt="MyGPU logo"/>
+</div>
+
+<!-- HTML_BLOCK:... -->
+
+> *MyGPU: Lightweight GPU Management Utility: a compact `nvidia-smi` wrapper with an elegant web dashboard.*
+<!-- HTML_BLOCK: no change to url; output entire as it is... -->
+![License](https://img.shields.io/badge/license-MIT-blue.svg)
+![Python](https://img.shields.io/badge/python-3.10%2B-blue)
+![Version](https://img.shields.io/badge/version-1.2.3-blue)
+![Platform](https://img.shields.io/badge/platform-Windows-lightgrey)
+![cuda 12.x](https://img.shields.io/badge/CUDA-12.x-0f9d58?logo=nvidia)
+
+## Галерея
+
+<details>
+
+  <summary>
+    Панель мониторинга
+  </summary>
+
+  <div class="flex overflow-x:auto gap:10px padding:12px 0 scroll-snap-type:x mandatory -webkit-overflow-scrolling:touch">
+    <!-- Используйте первый изображение с соотношением сторон 1624x675 для рамки слайда; изображения вписываются внутри с помощью object-fit:contain -->
+    <div class="flex-1 scroll-snap-align:center aspect-ratio:1624/675">
+      <img src="../monitor/api/static/web1.png" class="w-full h-full object-fit:contain" />
+    </div>
+    <div class="flex-1 scroll-snap-align:center aspect-ratio:1624/675">
+      <img src="../monitor/api/static/web2.png" class="w-full h-full object-fit:contain" />
+    </div>
+    <div class="flex-1 scroll-snap-align:center aspect-ratio:1624/675">
+      <img src="../monitor/api/static/web3.png" class="w-full h-full object-fit:contain" />
+    </div>
+    <div class="flex-1 scroll-snap-align:center aspect-ratio:1624/675">
+      <img src="../monitor/api/static/web4.png" class="w-full h-full object-fit:contain" />
+    </div>
+  </div>
+
+</details>
+
+<details>
+  <summary>CLI</summary>
+  <div style="display:flex; overflow-x:auto; gap:10px; padding:12px 0; scroll-snap-type:x mandatory; -webkit-overflow-scrolling:touch;">
+
+  <div style="flex:0 0 100%; scroll-snap-align:center; aspect-ratio:1624/675; display:flex; align-items:center; justify-content:center;">
+      <img src="../monitor/api/static/cli1.png" style="width:100%; height:100%; object-fit:contain;" />
+  </div>
+  <div style="flex:0 0 100%; scroll-snap-align:center; aspect-ratio:1624/675; display:flex; align-items:center; justify-content:center;">
+      <img src="../monitor/api/static/cli2.png" style="width:100%; height:100%; object-fit:contain;" />
+    </div>
+    <div style="flex:0 0 100%; scroll-snap-align:center; aspect-ratio:1624/675; display:flex; align-items:center; justify-content:center;">
+      <img src="../monitor/api/static/cli3.png" style="width:100%; height:100%; object-fit:contain;" />
+    </div>
+    <div style="flex:0 0 100%; scroll-snap-align:center; aspect-ratio:1624/675; display:flex; align-items:center; justify-content:center;">
+      <img src="../monitor/api/static/cli4.png" style="width:100%; height:100%; object-fit:contain;" />
+    </div>
+    <div style="flex:0 0 100%; scroll-snap-align:center; aspect-ratio:1624/675; display:flex; align-items:center; justify-content:center;">
+      <img src="../monitor/api/static/cli5.png" style="width:100%; height:100%; object-fit:contain;" />
+    </div>
+</details>
+
+### Почему его использовать?
+
+- **Легковесный**: Минимальное использование ресурсов.
+- **Гибкий**: Может работать как инструмент CLI или полноценный веб-дашборд.
+- **Админ-ориентированный**: Включает функции, такие как **принудительное ограничение VRAM** (автоматическое завершение процессов, превышающих пределы) и **списки наблюдения**.
+- **Дружелюбный к разработчикам**: Встроенные инструменты для тестирования и стресс-тестирования (GEMM, физика частиц) для проверки стабильности системы.
+
+## Функции
+
+- **Мониторинг в реальном времени**:
+  - Подробные метрики GPU (Использование, VRAM, Энергопотребление, Температура).
+  - Системные метрики (Процессор, ОЗУ и т.д.).
+
+- **Администрирование и контроль**:
+  - **Ограничение VRAM**: Установка жестких лимитов использования VRAM на каждую GPU.
+  - **Автоматическое завершение работы**: Автоматическое прекращение процессов, нарушающих политики VRAM (только для администраторов).
+  - **Контрольные списки**: Мониторинг конкретных PID или имен процессов.
+
+- **Тестирование и симуляция**:
+  - **Стресс-тестирование**: Настраиваемые нагрузки GEMM для тестирования термического троттлинга и стабильности.
+  - **Визуальная симуляция**: Интерактивная 3D-симуляция физики частиц для визуализации нагрузки на GPU.
+
+## План развития & Будущая работа
+
+Вклады приветствуются! Основные будущие направления включают:
+
+- **Поддержка многоGPU**: Улучшенное управление конфигурациями с несколькими картами и топологиями NVLink.
+- **Контейнеризация**: Официальная поддержка Docker для легкого развертывания в контейнеризованных средах.
+- **Удаленный доступ**: Интеграция туннелирования SSH и безопасное удаленное управление.
+- **Кросс-платформенность**:
+  - [ ] Поддержка Linux (фокус на Ubuntu/Debian).
+  - [ ] Поддержка macOS (мониторинг поддержки Apple Silicon).
+- **Аппаратно-независимый**:
+  - [ ] Поддержка AMD ROCm.
+  - [ ] Поддержка Intel Arc.
+- ~~**Многоязычная документация**: Поддержка большинства популярных языков GitHub.~~
+
+Смотрите [CONTRIBUTING.md](../CONTRIBUTING.md) для того, как принять участие.
+
+## Требования
+
+- **Операционная система**: Windows 10/11
+- **Python**: версия 3.10 и выше
+- **Аппаратное обеспечение**: видеокарта NVIDIA с установленными драйверами.
+- **CUDA**: Toolkit версии 12.x (обязательно для функций тестирования/симуляции).
+  - *Примечание: Если не обнаружена CUDA 12.x, функции тестирования на основе GPU будут отключены.*
+
+## Установка
+
+Инструмент поддерживает модульную установку для соответствия вашим требованиям:
+
+### 1. Минимальный (только CLI)
+
+Лучше всего подходит для серверов без графического интерфейса или фонового мониторинга.
+
+- Интерфейс командной строки.
+- Основные метрики системы/видеопамяти.
+
+### 2. Стандартный (CLI + Веб-интерфейс)
+
+Лучший вариант для большинства пользователей.
+
+- Включает веб-дашборд.
+- Конечные точки REST API.
+- Реальное время графиков.
+- Но без симуляции или тестирования производительности.
+
+### 3. Полный (Стандартный + Визуализация)
+
+Наилучший вариант для разработки и стресс-тестирования.
+
+- Включает симуляцию.
+- Зависимости PyTorch/CuPy для сравнения производительности.
+
+### Быстрый старт
+
+1. **Скачайте** последнюю версию или клонируйте репозиторий.
+2. **Запустите настройку**:
+
+```powershell
+  .\setup.ps1
+  ```
+
+## Запуск:
+
+```powershell
+# Запуск веб-дашборда (Стандартный/Полный)
+python health_monitor.py web
+
+# Запуск CLI
+python health_monitor.py cli
+```
+
+---
+
+## License
+
+Лицензия MIT. Подробности см. в файле [LICENSE](../LICENSE).
+