|
1 | 1 | <div align="center"> |
2 | 2 | <a href="../README.md">🇺🇸 영어</a> | |
3 | | - <a href="../README.de.md">🇩🇪 독일어</a> | |
4 | | - <a href="../README.fr.md">🇫🇷 Französisch</a> | |
5 | | - <a href="../README.es.md">🇪🇸 Spanisch</a> | |
6 | | - <a href="../README.ja.md">🇯🇵 Japanisch</a> | |
7 | | - <a href="../README.zh.md">🇨🇳 Chinesisch</a> | |
8 | | - <a href="../README.pt.md">🇵🇹 Portugiesisch</a> | |
9 | | - <a href="../README.ko.md">🇰🇷 Koreanisch</a> | |
10 | | - <a href="../README.hi.md">🇮🇳 Hindi</a> |
| 3 | + <a href="README.de.md">🇩🇪 독일어</a> | |
| 4 | + <a href="README.fr.md">🇫🇷 프랑스어</a> | |
| 5 | + <a href="README.es.md">🇪🇸 스페인어</a> | |
| 6 | + <a href="README.ja.md">🇯🇵 일본어</a> | |
| 7 | + <a href="README.zh.md">🇨🇳 중국어</a> | |
| 8 | + <a href="README.pt.md">🇵🇹 포르투갈어</a> | |
| 9 | + <a href="README.ko.md">🇰🇷 한국어</a> |
11 | 10 | </div> |
12 | 11 |
|
13 | 12 | <div style="text-align:center; margin:18px 0;"> |
14 | 13 | <img src="../monitor/api/static/logo.png" alt="MyGPU 로고"/> |
15 | 14 | </div> |
16 | 15 |
|
17 | | -> *MyGPU: GPU 관리 유틸리티: NVIDIA smi의 컴팩트한 래핑으로 청결한 웹 대시보드를 제공합니다.* |
| 16 | +> *MyGPU: 가벼운 GPU 관리 유틸리티: NVIDIA nvidia-smi의 간결한 랩핑과 깨끗한 웹 대시보드가 포함된 컴팩트한 GPU 관리 도구.* |
18 | 17 |
|
19 | 18 |  |
20 | 19 |  |
21 | 20 |  |
22 | 21 |  |
23 | | - |
| 22 | + |
24 | 23 |
|
25 | 24 | ## 갤러리 |
26 | 25 |
|
27 | 26 | <details> |
28 | 27 | <summary>웹 대시보드</summary> |
29 | 28 | <div style="display:flex; overflow-x:auto; gap:10px; padding:12px 0; scroll-snap-type:x mandatory; -webkit-overflow-scrolling:touch;"> |
| 29 | + <!-- 첫 번째 이미지를 1624x675 비율로 사용하여 슬라이드 프레임으로 설정하고, 다른 이미지들은 'object-fit: contain'을 사용하여 안에 맞춥니다. --> |
30 | 30 | <div style="flex:0 0 100%; scroll-snap-align:center; aspect-ratio:1624/675; display:flex; align-items:center; justify-content:center;"> |
31 | 31 | <img src="../monitor/api/static/web1.png" style="width:100%; height:100%; object-fit:contain;" /> |
32 | 32 | </div> |
|
47 | 47 | <div style="flex:0 0 100%; scroll-snap-align:center; aspect-ratio:1624/675; display:flex; align-items:center; justify-content:center;"> |
48 | 48 | <img src="../monitor/api/static/cli1.png" style="width:100%; height:100%; object-fit:contain;" /> |
49 | 49 | </div> |
50 | | - <!-- 추가 이미지 동일한 형식으로 추가 --> |
| 50 | + <!-- 추가 이미지들... --> |
51 | 51 | </div> |
52 | 52 | </details> |
53 | 53 |
|
54 | | -### 사용 이유 |
| 54 | +### 이 도구를 사용하는 이유 |
55 | 55 |
|
56 | | -- **가벼움**: 최소한의 리소스 사용. |
57 | | -- **유연성**: CLI 도구, 백그라운드 서비스, 또는 완전한 웹 대시보드로 실행 가능. |
58 | | -- **관리자 중심**: VRAM 강제 제한 및 감시 기능과 같은 기능 포함. |
59 | | -- **개발자 친화적**: GEMM 및 입자 물리학 시뮬레이션과 같은 테스트 도구를 통한 시스템 안정성 검증. |
| 56 | +- **가볍다**: 최소한의 리소스 사용. |
| 57 | +- **유연하다**: CLI 도구, 또는 완전한 웹 대시보드 형태로 제공. |
| 58 | +- **관리자 중심**: **VRAM 강제 제한** (VRAM 사용량 제한 자동 종료) 및 **감시 목록**과 같은 기능이 포함되어 있다. |
| 59 | +- **개발자 친화적**: GEMM, 입자 물리학 시뮬레이션과 같은 벤치마크 및 스트레스 테스트 도구를 내장하여 시스템 안정성을 검증할 수 있다. |
60 | 60 |
|
61 | 61 | --- |
62 | 62 |
|
63 | 63 | ## 기능 |
64 | 64 |
|
65 | 65 | - **실시간 모니터링**: |
66 | | - - GPU 및 시스템 메트릭(사용률, VRAM, 전력, 온도) 제공. |
67 | | -- **관리 및 강제 실행**: |
68 | | - - VRAM 제한 설정(GPU당). |
69 | | - - 관리자 전용: VRAM 정책 위반 시 자동 종료(강제 종료). |
70 | | - - 감시 목록: 특정 PID 또는 프로세스 이름으로 감시. |
71 | | -- **벤치마킹 및 시뮬레이션**: |
72 | | - - GEMM 워크로드(열적 스로틀링 및 안정성 테스트)를 위한 스트레스 테스트. |
73 | | - - GPU 부하 시각화를 위한 상호형 입자 물리학 시뮬레이션. |
| 66 | + - GPU 메트릭(사용률, VRAM, 전력, 온도) 및 시스템 메트릭(CPU, RAM 등) 제공. |
| 67 | +- **관리자 및 강제 제한**: |
| 68 | + - **VRAM 제한**: GPU당 VRAM 사용량에 대한 하드 제한 설정. |
| 69 | + - **자동 종료**: VRAM 정책을 위반하는 프로세스를 자동 종료 (관리자 전용). |
| 70 | + - **감시 목록**: 특정 PID 또는 프로세스 이름을 모니터링. |
| 71 | +- **벤치마크 및 시뮬레이션**: |
| 72 | + - **스트레스 테스트**: GEMM 워크로드를 사용하여 열 스로틀링 및 안정성을 테스트. |
| 73 | + - **입자 물리학 시뮬레이션**: GPU 부하를 시각화하기 위한 상호형 3D 입자 물리학 시뮬레이션. |
74 | 74 |
|
75 | 75 | --- |
76 | 76 |
|
77 | 77 | ## 로드맵 및 미래 작업 |
78 | 78 |
|
79 | | -기여 환영! 주요 향후 개발 사항은 다음과 같습니다. |
| 79 | +기여 환영! 향후 주요 포인트는 다음과 같다: |
80 | 80 |
|
81 | | -- **다중 GPU 지원**: 다중 카드 설정 및 NVLink 토폴로지에 대한 향상된 처리. |
82 | | -- **컨테이너화**: Docker 공식 지원으로 컨테이너 환경에서 쉽게 배포. |
| 81 | +- **다중 GPU 지원**: NVLink 토폴로지를 포함한 다중 카드 설정 향상. |
| 82 | +- **컨테이너화**: Docker 공식 지원을 통해 컨테이너 환경에서 쉽게 배포. |
83 | 83 | - **원격 액세스**: SSH 터널링 통합 및 안전한 원격 관리. |
84 | 84 | - **플랫폼 확장**: |
85 | | - - [ ] Linux 지원(Ubuntu/Debian 집중). |
| 85 | + - [ ] Linux 지원 (Ubuntu/Debian 집중). |
86 | 86 | - [ ] Apple Silicon을 위한 macOS 지원. |
87 | | -- **하드웨어 독립성**: |
| 87 | +- **하드웨어 무관성**: |
88 | 88 | - [ ] AMD ROCm 지원. |
89 | 89 | - [ ] Intel Arc 지원. |
90 | | -- ~~[ ] 다국어 문서화: GitHub에서 가장 인기 있는 언어를 지원.~~ |
| 90 | +- [ ] 다국어 문서화 (GitHub에서 인기 있는 언어 우선). |
91 | 91 |
|
92 | 92 | [CONTRIBUTING.md](../CONTRIBUTING.md)를 참조하세요. |
93 | 93 |
|
|
96 | 96 | ## 요구 사항 |
97 | 97 |
|
98 | 98 | - **OS**: Windows 10/11 |
99 | | -- **Python**: 3.10 이상 |
| 99 | +- **Python**: 3.10+ |
100 | 100 | - **하드웨어**: NVIDIA GPU 및 설치 드라이버. |
101 | | -- **CUDA**: 12.x(벤치마킹/시뮬레이션 기능 사용 시 필수). |
102 | | - - *참고: CUDA 12.x 미탐지 시, 벤치마킹 기능이 비활성화됩니다.* |
| 101 | +- **CUDA**: 12.x (벤치마크/시뮬레이션 기능 사용 시 필수). |
| 102 | + - *참고: CUDA 12.x가 감지되지 않으면, 해당 기능은 비활성화됩니다.* |
103 | 103 |
|
104 | 104 | --- |
105 | 105 |
|
106 | 106 | ## 설치 |
107 | 107 |
|
108 | | -모듈식 설치로 요구 사항에 맞게 설치할 수 있습니다. |
| 108 | +도구는 모듈식 설치를 지원하여 사용자의 요구에 맞게 설치할 수 있습니다. |
109 | 109 |
|
110 | | -### 1. 최소(CLI 전용) |
| 110 | +### 1. 최소 (CLI만) |
111 | 111 |
|
112 | | -서버 또는 백그라운드 모니터링에 적합한 기본 설정. |
| 112 | +서버나 백그라운드 모니터링에 적합한 CLI 전용 설치. |
113 | 113 |
|
114 | | -- 명령줄 인터페이스. |
115 | | -- 기본 시스템/GPU 메트릭 제공. |
| 114 | +### 2. 표준 (CLI + 웹 UI) |
116 | 115 |
|
117 | | -### 2. 표준(CLI + 웹 UI) |
| 116 | +대부분의 사용자에게 적합. |
118 | 117 |
|
119 | | -대부분 사용자를 위한 웹 대시보드 및 REST API 엔드포인트 포함. |
| 118 | +- 웹 대시보드 포함. |
| 119 | +- REST API 엔드포인트. |
| 120 | +- 실시간 차트. |
120 | 121 |
|
121 | | -- 웹 대시보드 실행. |
122 | | -- 실시간 차트 제공. |
123 | | - |
124 | | -### 3. 풀(표준 + 시각화) |
| 122 | +### 3. 풀 (표준 + 시각화) |
125 | 123 |
|
126 | 124 | 개발 및 스트레스 테스트에 적합. |
127 | 125 |
|
128 | 126 | - 입자 물리학 시뮬레이션 포함. |
129 | | -- PyTorch/CuPy 의존성(벤치마킹용). |
| 127 | +- PyTorch/CuPy 의존성 (벤치마크를 위해). |
130 | 128 |
|
131 | 129 | ### 빠른 시작 |
132 | 130 |
|
133 | | -1. **다운로드** 또는 저장소 복제. |
134 | | -2. **설정 실행**: |
| 131 | +1. **최신 버전 다운로드 또는 저장소 복제.** |
| 132 | +2. **설정 스크립트 실행:** |
135 | 133 |
|
136 | 134 | ```powershell |
137 | 135 | .\setup.ps1 |
138 | 136 | ``` |
139 | 137 |
|
140 | | -3. **실행**: |
| 138 | +3. **실행:** |
141 | 139 |
|
142 | 140 | ```powershell |
143 | | -# 웹 대시보드 시작(표준/풀) |
| 141 | +# 웹 대시보드 시작 (표준/풀) |
144 | 142 | python health_monitor.py web |
145 | 143 |
|
146 | 144 | # CLI 시작 |
|
0 commit comments