Skip to content

Commit efcfae2

Browse files
DataBoySugithub-actions[bot]
authored andcommitted
docs: update multilingual translations
1 parent 767ded0 commit efcfae2

File tree

5 files changed

+726
-0
lines changed

5 files changed

+726
-0
lines changed

locales/README.de.md

Lines changed: 154 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,154 @@
1+
# MyGPU: Ein leichtgewichtiges GPU-Verwaltungstool: Ein kompakter Wrapper für `nvidia-smi` mit einer sauberen Web-Dashboard-Schnittstelle
2+
3+
> *MyGPU: Ein leichtgewichtiges GPU-Verwaltungstool mit einer kompakten `nvidia-smi`-Verpackung und einem sauberen Web-Dashboard.*
4+
5+
![Lizenz](https://img.shields.io/badge/Lizenz-MIT-blue.svg)
6+
![Python](https://img.shields.io/badge/Python-3.10%2B-blue)
7+
![Version](https://img.shields.io/badge/Version-1.2.3-blue)
8+
![Plattform](https://img.shields.io/badge/Plattform-Windows-lightgrey)
9+
![CUDA 12.x](https://img.shields.io/badge/CUDA-12.x-0f9d58?logo=nvidia)
10+
11+
## Galerie
12+
13+
### Web-Dashboard
14+
15+
<details>
16+
<summary>Web-Dashboard</summary>
17+
<div style="display:flex; overflow-x:auto; gap:10px; padding:12px 0; scroll-snap-type:x mandatory; -webkit-overflow-scrolling:touch;">
18+
<!-- Verwenden Sie das erste Bild mit einem Seitenverhältnis von 1624x675 für den Folienrahmen; die Bilder passen sich mit `object-fit: contain` innerhalb ein -->
19+
<div style="flex:0 0 100%; scroll-snap-align:center; aspect-ratio:1624/675; display:flex; align-items:center; justify-content:center;">
20+
<img src="../monitor/api/static/web1.png" style="width:100%; height:100%; object-fit:contain;" />
21+
</div>
22+
<div style="flex:0 0 100%; scroll-snap-align:center; aspect-ratio:1624/675; display:flex; align-items:center; justify-content:center;">
23+
<img src="../monitor/api/static/web2.png" style="width:100%; height:100%; object-fit:contain;" />
24+
</div>
25+
<div style="flex:0 0 100%; scroll-snap-align:center; aspect-ratio:1624/675; display:flex; align-items:center; justify-content:center;">
26+
<img src="../monitor/api/static/web3.png" style="width:100%; height:100%; object-fit:contain;" />
27+
</div>
28+
<div style="flex:0 0 100%; scroll-snap-align:center; aspect-ratio:1624/675; display:flex; align-items:center; justify-content:center;">
29+
<img src="../monitor/api/static/web4.png" style="width:100%; height:100%; object-fit:contain;" />
30+
</div>
31+
</div>
32+
</details>
33+
34+
### CLI
35+
36+
<details>
37+
<summary>CLI</summary>
38+
<div style="display:flex; overflow-x:auto; gap:10px; padding:12px 0; scroll-snap-type:x mandatory; -webkit-overflow-scrolling:touch;">
39+
<div style="flex:0 0 100%; scroll-snap-align:center; aspect-ratio:1624/675; display:flex; align-items:center; justify-content:center;">
40+
<img src="../monitor/api/static/cli1.png" style="width:100%; height:100%; object-fit:contain;" />
41+
</div>
42+
<div style="flex:0 0 100%; scroll-snap-align:center; aspect-ratio:1624/675; display:flex; align-items:center; justify-content:center;">
43+
<img src="../monitor/api/static/cli2.png" style="width:100%; height:100%; object-fit:contain;" />
44+
</div>
45+
<div style="flex:0 0 100%; scroll-snap-align:center; aspect-ratio:1624/675; display:flex; align-items:center; justify-content:center;">
46+
<img src="../monitor/api/static/cli3.png" style="width:100%; height:100%; object-fit:contain;" />
47+
</div>
48+
<div style="flex:0 0 100%; scroll-snap-align:center; aspect-ratio:1624/675; display:flex; align-items:center; justify-content:center;">
49+
<img src="../monitor/api/static/cli4.png" style="width:100%; height:100%; object-fit:contain;" />
50+
</div>
51+
<div style="flex:0 0 100%; scroll-snap-align:center; aspect-ratio:1624/675; display:flex; align-items:center; justify-content:center;">
52+
<img src="../monitor/api/static/cli5.png" style="width:100%; height:100%; object-fit:contain;" />
53+
</div>
54+
</div>
55+
</details>
56+
57+
### Warum dies verwenden?
58+
59+
- **Leichtgewichtig**: Minimale Ressourcenbelastung.
60+
- **Flexibel**: Als CLI-Tool, Hintergrunddienst oder voll ausgestattetes Web-Dashboard ausführbar.
61+
- **admin-zentriert**: Enthält Funktionen wie **VRAM-Enforcement** (Automatische Beendigung von Prozessen, die VRAM-Richtlinien verletzen) und **Watchlists**.
62+
- **entwicklerfreundlich**: Integrierte Benchmarking- und Stresstestwerkzeuge (GEMM, Teilchenphysik) zur Validierung der Systemstabilität.
63+
64+
---
65+
66+
## Funktionen
67+
68+
- **Echtzeitüberwachung**:
69+
- Detaillierte GPU-Metriken (Nutzung, VRAM, Leistung, Temperatur).
70+
- Systemmetriken (CPU, RAM usw.).
71+
72+
- **Admin- und Durchsetzungsfunktionen**:
73+
- **VRAM-Grenzen**: Legen Sie harte VRAM-Nutzungsgrenzen für jede GPU fest.
74+
- **Automatische Beendigung**: Automatisch beenden Sie Prozesse, die VRAM-Richtlinien verletzen (nur für Administratoren).
75+
- **Watchlists**: Überwachen Sie bestimmte PIDs oder Prozessnamen.
76+
77+
- **Benchmarking und Simulation**:
78+
- **Stresstest**: Konfigurierbare GEMM-Lasten zum Testen der thermischen Throtting und Stabilität.
79+
- **Visuelle Simulation**: Interaktive 3D-Teilchenphysiksimulation zur Visualisierung der GPU-Last.
80+
81+
---
82+
83+
## Roadmap und zukünftige Arbeiten
84+
85+
Beiträge sind willkommen! Die Hauptpunkte, die in der Zukunft abgedeckt werden sollen, sind:
86+
87+
- **Multi-GPU-Unterstützung**: Verbesserte Handhabung für Multi-Karten-Setups und NVLink-Topologien.
88+
- **Containerisierung**: Offizielle Docker-Unterstützung für eine einfache Bereitstellung in Containerumgebungen.
89+
- **Remote-Zugriff**: SSH-Tunnel-Integration und sicherer Remote-Management.
90+
- **Plattformübergreifend**:
91+
- [ ] Linux-Unterstützung (Ubuntu/Debian-Fokus).
92+
- [ ] macOS-Unterstützung (Apple Silicon-Überwachung).
93+
- **Hardware-agnostisch**:
94+
- [ ] AMD ROCm-Unterstützung.
95+
- [ ] Intel Arc-Unterstützung.
96+
97+
Siehe [CONTRIBUTING.md](../CONTRIBUTING.md), um herauszufinden, wie du dich einbringen kannst.
98+
99+
---
100+
101+
## Anforderungen
102+
103+
- **OS**: Windows 10/11
104+
- **Python**: 3.10+
105+
- **Hardware**: NVIDIA-GPU mit installierten Treibern.
106+
- **CUDA**: Toolkit 12.x (Streng erforderlich für Benchmarking/Simulation-Funktionen).
107+
- *Hinweis: Wenn CUDA 12.x nicht erkannt wird, werden GPU-spezifische Benchmarking-Funktionen deaktiviert.*
108+
109+
---
110+
111+
## Installation
112+
113+
Das Tool unterstützt eine modulare Installation, um Ihren Bedürfnissen gerecht zu werden:
114+
115+
### 1. Minimale Installation (nur CLI)
116+
117+
Am besten für Headless-Server oder Hintergrundüberwachung geeignet.
118+
119+
- Befehlszeileninterface.
120+
- Grundlegende System-/GPU-Metriken.
121+
122+
### 2. Standardinstallation (CLI + Web-UI)
123+
124+
Am besten für die meisten Benutzer geeignet.
125+
126+
- Enthält Web-Dashboard.
127+
- REST-API-Endpunkte.
128+
- Echtzeitdiagramme.
129+
130+
### 3. Vollständige Installation (Standard + Visualisierung)
131+
132+
Am besten für Entwicklung und Stresstest geeignet.
133+
134+
- Enthält Teilchenphysik-Simulation.
135+
- Abhängigkeiten für PyTorch/CuPy-Benchmarking.
136+
137+
### Schnelle Einrichtung
138+
139+
1. **Laden** Sie die neueste Version herunter oder klonen Sie das Repository.
140+
2. **Einrichten**:
141+
142+
```powershell
143+
.\setup.ps1
144+
```
145+
146+
3. **Starten**:
147+
148+
```powershell
149+
# Starten Sie das Web-Dashboard (Standard/Vollständig)
150+
python health_monitor.py web
151+
152+
# Starten Sie die CLI
153+
python health_monitor.py cli
154+
```

locales/README.es.md

Lines changed: 139 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,139 @@
1+
# MyGPU: Herramienta de gestión de GPU ligera: un envoltorio compacto de `nvidia-smi` con un tablero web limpio.
2+
3+
![Licencia](https://img.shields.io/badge/licencia-MIT-blue.svg)
4+
![Python](https://img.shields.io/badge/python-3.10%2B-blue)
5+
![Versión](https://img.shields.io/badge/versión-1.2.3-blue)
6+
![Plataforma](https://img.shields.io/badge/plataforma-Windows-lightgrey)
7+
![cuda 12.x](https://img.shields.io/badge/CUDA-12.x-0f9d58?logo=nvidia)
8+
9+
## Galería
10+
11+
### Tablero web
12+
13+
<details>
14+
<summary>Tablero web</summary>
15+
<div style="display:flex; overflow-x:auto; gap:10px; padding:12px 0; scroll-snap-type:x mandatory; -webkit-overflow-scrolling:touch;">
16+
<!-- Utilizar la primera imagen con relación de aspecto 1624x675 para el marco de diapositiva; las imágenes se ajustan automáticamente usando object-fit:contain -->
17+
<div style="flex:0 0 100%; scroll-snap-align:center; aspect-ratio:1624/675; display:flex; align-items:center; justify-content:center;">
18+
<img src="../monitor/api/static/web1.png" style="width:100%; height:100%; object-fit:contain;" />
19+
</div>
20+
<div style="flex:0 0 100%; scroll-snap-align:center; aspect-ratio:1624/675; display:flex; align-items:center; justify-content:center;">
21+
<img src="../monitor/api/static/web2.png" style="width:100%; height:100%; object-fit:contain;" />
22+
</div>
23+
<div style="flex:0 0 100%; scroll-snap-align:center; aspect-ratio:1624/675; display:flex; align-items:center; justify-content:center;">
24+
<img src="../monitor/api/static/web3.png" style="width:100%; height:100%; object-fit:contain;" />
25+
</div>
26+
<div style="flex:0 0 100%; scroll-snap-align:center; aspect-ratio:1624/675; display:flex; align-items:center; justify-content:center;">
27+
<img src="../monitor/api/static/web4.png" style="width:100%; height:100%; object-fit:contain;" />
28+
</div>
29+
</div>
30+
</details>
31+
32+
<details>
33+
<summary>CLI</summary>
34+
<div style="display:flex; overflow-x:auto; gap:10px; padding:12px 0; scroll-snap-type:x mandatory; -webkit-overflow-scrolling:touch;">
35+
<div style="flex:0 0 100%; scroll-snap-align:center; aspect-ratio:1624/675; display:flex; align-items:center; justify-content:center;">
36+
<img src="../monitor/api/static/cli1.png" style="width:100%; height:100%; object-fit:contain;" />
37+
</div>
38+
<!-- Agregar más imágenes CLI aquí -->
39+
</div>
40+
</details>
41+
42+
### ¿Por qué usar esto?
43+
44+
- **Ligero**: Pie de planta mínimo.
45+
- **Flexible**: Se ejecuta como una herramienta CLI, un servicio en segundo plano o un tablero web completo.
46+
- **Orientado a administradores**: Incluye características como **enfoque de VRAM** (terminación automática de procesos que superan los límites) y **listas de vigilancia**.
47+
- **Amigable con los desarrolladores**: Herramientas integradas de benchmarking y pruebas de estrés (GEMM, Física de Partículas) para validar la estabilidad del sistema.
48+
49+
---
50+
51+
## Características
52+
53+
- **Monitoreo en tiempo real**:
54+
- Métricas detalladas de GPU (utilización, VRAM, potencia, temperatura).
55+
- Métricas del sistema (CPU, RAM, etc.).
56+
57+
- **Administración y aplicación de políticas**:
58+
- **Límites de VRAM**: Establecer límites duros en el uso de VRAM por GPU.
59+
- **Terminación automática**: Terminar automáticamente los procesos que violen las políticas de VRAM (solo para administradores).
60+
- **Listas de vigilancia**: Monitorear PIDs o nombres de procesos específicos.
61+
62+
- **Benchmarking y simulación**:
63+
- **Pruebas de estrés**: Cargas de trabajo GEMM configurables para probar el throtting térmico y la estabilidad.
64+
- **Simulación visual**: Simulación interactiva de física de partículas para visualizar la carga de trabajo de la GPU.
65+
66+
---
67+
68+
## Roadmap y trabajo futuro
69+
70+
¡Las contribuciones son bienvenidas! Los futuros puntos principales a cubrir serían:
71+
72+
- **Soporte multi-GPU**: Manejo mejorado para configuraciones multi-tarjeta y topologías NVLink.
73+
- **Contenedorización**: Soporte oficial de Docker para una fácil implementación en entornos contenedorizados.
74+
- **Acceso remoto**: Integración de túneles SSH y gestión remota segura.
75+
- **Plataforma cruzada**:
76+
- [ ] Soporte para Linux (foco en Ubuntu/Debian).
77+
- [ ] Soporte para Apple Silicon (monitoreo de hardware).
78+
- **Independiente de hardware**:
79+
- [ ] Soporte para AMD ROCm.
80+
- [ ] Soporte para Intel Arc.
81+
82+
Consulte [CONTRIBUTING.md](../CONTRIBUTING.md) para saber cómo involucrarse.
83+
84+
---
85+
86+
## Requisitos
87+
88+
- **OS**: Windows 10/11
89+
- **Python**: 3.10+
90+
- **Hardware**: GPU NVIDIA con controladores instalados.
91+
- **CUDA**: Toolkit 12.x (requerido estrictamente para características de benchmarking/simulación).
92+
- *Nota: Si CUDA 12.x no se detecta, las características de benchmarking se desactivarán.*
93+
94+
---
95+
96+
## Instalación
97+
98+
La herramienta admite una instalación modular para adaptarse a sus necesidades:
99+
100+
### 1. Mínimo (solo CLI)
101+
102+
Ideal para servidores sin cabeza o monitoreo en segundo plano.
103+
104+
- Interfaz de línea de comandos.
105+
- Métricas básicas del sistema y la GPU.
106+
107+
### 2. Estándar (CLI + Tablero web)
108+
109+
Ideal para la mayoría de los usuarios.
110+
111+
- Incluye Tablero web.
112+
- Puntos finales de API REST.
113+
- Gráficos en tiempo real.
114+
115+
### 3. Completo (Estándar + Visualización)
116+
117+
Ideal para desarrollo y pruebas de estrés.
118+
119+
- Incluye simulación de partículas.
120+
- Dependencias de PyTorch/CuPy para benchmarking.
121+
122+
### Inicio rápido
123+
124+
1. **Descargar** la última versión o clonar el repositorio.
125+
2. **Ejecutar configuración**:
126+
127+
```powershell
128+
.\setup.ps1
129+
```
130+
131+
3. **Iniciar**:
132+
133+
```powershell
134+
# Iniciar el tablero web (Estándar/Completo)
135+
python health_monitor.py web
136+
137+
# Iniciar la CLI
138+
python health_monitor.py cli
139+
```

0 commit comments

Comments
 (0)