hwihwalab commited on
Commit
b1591f6
ยท
verified ยท
1 Parent(s): 1b05608

feat: deploy Pusher-v5 PPO model, telemetry cockpit, and video gallery

Browse files
Files changed (2) hide show
  1. README.md +18 -0
  2. README_KR.md +18 -0
README.md CHANGED
@@ -195,6 +195,20 @@ This repository is governed by rigorous engineering protocols to ensure simulati
195
  - **[`DOCS_DATA_SCHEMA.md`](https://github.com/Hwihwa-Lab/pusher-v5-ppo/blob/main/DOCS_DATA_SCHEMA.md)**: WebSocket Telemetry Protocol & REST Data Schema
196
  - **[`DOCS_MODEL_EVALUATION_AND_HF_DEPLOY.md`](https://github.com/Hwihwa-Lab/pusher-v5-ppo/blob/main/DOCS_MODEL_EVALUATION_AND_HF_DEPLOY.md)**: Benchmark Evaluation & Hugging Face Hub Pipeline
197
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
198
  ---
199
 
200
  ## ๐Ÿ”— Open Source Hubs & Project Links
@@ -207,3 +221,7 @@ This repository is governed by rigorous engineering protocols to ensure simulati
207
  ## ๐Ÿ“„ License
208
  This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
209
 
 
 
 
 
 
195
  - **[`DOCS_DATA_SCHEMA.md`](https://github.com/Hwihwa-Lab/pusher-v5-ppo/blob/main/DOCS_DATA_SCHEMA.md)**: WebSocket Telemetry Protocol & REST Data Schema
196
  - **[`DOCS_MODEL_EVALUATION_AND_HF_DEPLOY.md`](https://github.com/Hwihwa-Lab/pusher-v5-ppo/blob/main/DOCS_MODEL_EVALUATION_AND_HF_DEPLOY.md)**: Benchmark Evaluation & Hugging Face Hub Pipeline
197
 
198
+ ## ๐Ÿ“‚ Repository Contents
199
+
200
+ * `README.md`: English Model Card and benchmark performance guide.
201
+ * `README_KR.md`: Full Korean comprehensive manual ([ํ•œ๊ตญ์–ด ๋งค๋‰ด์–ผ](README_KR.md)).
202
+ * `app.py`: FastAPI high-performance backend & 30 FPS WebSocket simulation server.
203
+ * `train.py`: Stable-Baselines3 PPO 7-DOF training engine with `VisualProgressCallback`.
204
+ * `evaluate.py`: Standalone 5-episode deterministic policy evaluator and video recorder.
205
+ * `visualizer.py`: Standalone Matplotlib visualizer and benchmark plotter.
206
+ * `web/`: 1-Screen zero-scroll telemetry cockpit frontend (`app.js`, `index.html`, `style.css`).
207
+ * `results/ppo_pusher.zip`: Pre-trained PPO neural network weights (300,000 steps, -32.4 pts).
208
+ * `ppo_pusher_bundle.zip`: Complete production archive with weights, 12 checkpoint videos, and plots.
209
+ * `deploy_to_hf.py`: One-click automated Hugging Face Model Hub deployer.
210
+ * `requirements.txt` & `packages.txt`: Python and system dependency manifests.
211
+
212
  ---
213
 
214
  ## ๐Ÿ”— Open Source Hubs & Project Links
 
221
  ## ๐Ÿ“„ License
222
  This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
223
 
224
+ ---
225
+
226
+ *Trained and maintained by [hwihwalab](https://huggingface.co/hwihwalab/pusher-v5-ppo) & [Hwihwa-Lab](https://github.com/Hwihwa-Lab/pusher-v5-ppo).*
227
+
README_KR.md CHANGED
@@ -162,6 +162,20 @@ env.close()
162
  - **[`DOCS_DATA_SCHEMA.md`](https://github.com/Hwihwa-Lab/pusher-v5-ppo/blob/main/DOCS_DATA_SCHEMA.md)**: ํ…”๋ ˆ๋ฉ”ํŠธ๋ฆฌ ํŒจํ‚ท ํ”„๋กœํ† ์ฝœ ๋ฐ REST ๋ฐ์ดํ„ฐ ์Šคํ‚ค๋งˆ
163
  - **[`DOCS_MODEL_EVALUATION_AND_HF_DEPLOY.md`](https://github.com/Hwihwa-Lab/pusher-v5-ppo/blob/main/DOCS_MODEL_EVALUATION_AND_HF_DEPLOY.md)**: ๋ฒค์น˜๋งˆํฌ ํ‰๊ฐ€ ๋ฐ ํ—ˆ๊น…ํŽ˜์ด์Šค ๋ฐฐํฌ ๊ทœ๊ฒฉ์„œ
164
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
165
  ---
166
 
167
  ## ๐Ÿ”— ์˜คํ”ˆ์†Œ์Šค ๊ณต์‹ ๋งํฌ (Open Source Hubs)
@@ -173,3 +187,7 @@ env.close()
173
 
174
  ## ๐Ÿ“„ ๋ผ์ด์„ ์Šค
175
  ๋ณธ ํ”„๋กœ์ ํŠธ๋Š” MIT License๋ฅผ ๋”ฐ๋ฆ…๋‹ˆ๋‹ค.
 
 
 
 
 
162
  - **[`DOCS_DATA_SCHEMA.md`](https://github.com/Hwihwa-Lab/pusher-v5-ppo/blob/main/DOCS_DATA_SCHEMA.md)**: ํ…”๋ ˆ๋ฉ”ํŠธ๋ฆฌ ํŒจํ‚ท ํ”„๋กœํ† ์ฝœ ๋ฐ REST ๋ฐ์ดํ„ฐ ์Šคํ‚ค๋งˆ
163
  - **[`DOCS_MODEL_EVALUATION_AND_HF_DEPLOY.md`](https://github.com/Hwihwa-Lab/pusher-v5-ppo/blob/main/DOCS_MODEL_EVALUATION_AND_HF_DEPLOY.md)**: ๋ฒค์น˜๋งˆํฌ ํ‰๊ฐ€ ๋ฐ ํ—ˆ๊น…ํŽ˜์ด์Šค ๋ฐฐํฌ ๊ทœ๊ฒฉ์„œ
164
 
165
+ ## ๐Ÿ“‚ ๋ฆฌํฌ์ง€ํ† ๋ฆฌ ํŒŒ์ผ ๊ตฌ์„ฑ (Repository Contents)
166
+
167
+ * `README.md`: ์˜๋ฌธ ๊ธ€๋กœ๋ฒŒ ๋ชจ๋ธ ์นด๋“œ ๋ฐ ๋ฒค์น˜๋งˆํฌ ๊ฐ€์ด๋“œ.
168
+ * `README_KR.md`: ํ•œ๊ตญ์–ด ์ข…ํ•ฉ ๊ธฐ์ˆ  ๋งค๋‰ด์–ผ ([ํ•œ๊ตญ์–ด ๋งค๋‰ด์–ผ](README_KR.md)).
169
+ * `app.py`: FastAPI ๊ณ ์„ฑ๋Šฅ ๋ฐฑ์—”๋“œ ๋ฐ 30 FPS WebSocket ๋ฌผ๋ฆฌ ์ŠคํŠธ๋ฆฌ๋ฐ ์„œ๋ฒ„.
170
+ * `train.py`: Stable-Baselines3 PPO 7์ž์œ ๋„ ๋กœ๋ด‡ ํŒ” ๊ฐ•ํ™”ํ•™์Šต ์—”์ง„ (`VisualProgressCallback` ๋‚ด์žฅ).
171
+ * `evaluate.py`: ๋…๋ฆฝ 5ํšŒ ์—ฐ์† ๋กค์•„์›ƒ ์„ฑ๋Šฅ ํ‰๊ฐ€๊ธฐ ๋ฐ ๋น„๋””์˜ค ๋…นํ™”๊ธฐ.
172
+ * `visualizer.py`: ๋…๋ฆฝ Matplotlib ํ…”๋ ˆ๋ฉ”ํŠธ๋ฆฌ ์‹œ๊ฐํ™” ๋ฐ ๊ทธ๋ž˜ํ”„ ์ƒ์„ฑ ๋ชจ๋“ˆ.
173
+ * `web/`: 1-ํ™”๋ฉด ์ œ๋กœ ์Šคํฌ๋กค ์›น ๊ด€์ œ ์ฝ•ํ• ํ”„๋ก ํŠธ์—”๋“œ (`app.js`, `index.html`, `style.css`).
174
+ * `results/ppo_pusher.zip`: 300,000 ์Šคํ… ์™„์„ฑํ˜• PPO ์‹ ๊ฒฝ๋ง ๊ฐ€์ค‘์น˜ (ํ‰๊ท  -32.4 pts).
175
+ * `ppo_pusher_bundle.zip`: ๊ฐ€์ค‘์น˜, 12๊ฐœ ์ฒดํฌํฌ์ธํŠธ ๋น„๋””์˜ค, ๋ถ„์„ ์ฐจํŠธ๊ฐ€ ํฌํ•จ๋œ ๋‹จ์ผ ํ”„๋กœ๋•์…˜ ๋ฐฐํฌ ์••์ถ•๋ณธ.
176
+ * `deploy_to_hf.py`: ํ—ˆ๊น…ํŽ˜์ด์Šค ๋ชจ๋ธ ํ—ˆ๋ธŒ ์›ํด๋ฆญ ์ž๋™ ๋ฐฐํฌ ์Šคํฌ๋ฆฝํŠธ.
177
+ * `requirements.txt` & `packages.txt`: ํŒŒ์ด์ฌ ํŒจํ‚ค์ง€ ๋ฐ OS ์˜์กด์„ฑ ๋ช…์„ธ์„œ.
178
+
179
  ---
180
 
181
  ## ๐Ÿ”— ์˜คํ”ˆ์†Œ์Šค ๊ณต์‹ ๋งํฌ (Open Source Hubs)
 
187
 
188
  ## ๐Ÿ“„ ๋ผ์ด์„ ์Šค
189
  ๋ณธ ํ”„๋กœ์ ํŠธ๋Š” MIT License๋ฅผ ๋”ฐ๋ฆ…๋‹ˆ๋‹ค.
190
+
191
+ ---
192
+
193
+ *Trained and maintained by [hwihwalab](https://huggingface.co/hwihwalab/pusher-v5-ppo) & [Hwihwa-Lab](https://github.com/Hwihwa-Lab/pusher-v5-ppo).*