feat: HF Space 배포용 모델 및 샘플 영상 준비

- Private HF Model 저장소 생성 (YoungjaeDev/fall-detection-models)
- yolo11m-pose.pt (~41MB)
- best_acc.pth (~37MB)

- app.py 수정: hf_hub_download 방식으로 모델 로드 변경
- 로컬 개발 시 로컬 파일 우선 사용
- HF Spaces에서는 Private repo에서 자동 다운로드 (HF_TOKEN 필요)

- 샘플 영상 6개 추가 (Git LFS)
- 병원: 00050_H_A_BY_C1.mp4, 00050_H_A_BY_C2.mp4
- 노인정: 01602_L_F_BY_C2.mp4, 01823_Y_A_BY_C4.mp4
- 집: 00750_O_E_BY_C1.mp4, 00750_O_E_BY_C2.mp4

- .gitattributes: mp4 파일 Git LFS 추적 설정
- .gitignore: demo_gradio/examples/*.mp4 예외 추가
- README.md: 모델 저장소 정보 및 로컬 실행 가이드 추가

Closes #72

Co-Authored-By: Claude <noreply@anthropic.com>

.gitattributes

@@ -0,0 +1,4 @@
+# Git LFS tracking for large files
+*.mp4 filter=lfs diff=lfs merge=lfs -text
+*.avi filter=lfs diff=lfs merge=lfs -text
+*.mov filter=lfs diff=lfs merge=lfs -text

README.md

@@ -51,16 +51,29 @@ YOLOv11-Pose + ST-GCN 2-stage 파이프라인을 사용한 실시간 낙상 감
 - **Latency**: ~2초 (60 프레임 윈도우 기준)
 - **Accuracy**: 99.6% (AI Hub 검증 데이터셋)
 
+## 모델 저장소
+
+모델 파일은 Private HuggingFace Model 저장소에서 자동으로 다운로드됩니다.
+
+- **저장소**: `YoungjaeDev/fall-detection-models` (Private)
+- **파일**: `yolo11m-pose.pt`, `best_acc.pth`
+- **토큰**: HF Spaces의 경우 `HF_TOKEN` Secret 설정 필요
+
 ## 로컬 실행
 
 ```bash
 # 의존성 설치
 pip install -r requirements.txt
 
+# HuggingFace 로그인 (Private 모델 접근용)
+huggingface-cli login
+
 # 앱 실행
 python app.py
 ```
 
+로컬 개발 시 프로젝트 루트에 `yolo11m-pose.pt`와 `runs/stgcn_binary_exp2_fixed_graph/best_acc.pth`가 있으면 HF에서 다운로드하지 않고 로컬 파일을 사용합니다.
+
 ## 참고자료
 
 - [YOLOv11 (Ultralytics)](https://github.com/ultralytics/ultralytics)

app.py

@@ -30,6 +30,7 @@ import plotly.graph_objects as go
 import torch
 from gradio.themes import Soft
 from gradio.themes.utils import colors, fonts, sizes
+from huggingface_hub import hf_hub_download
 
 # 프로젝트 루트를 Python path에 추가
 # pipeline/demo_gradio/app.py -> pipeline -> project_root
@@ -142,6 +143,44 @@ def gpu_decorator(duration: int = 120):
     return decorator
 
 
+# -----------------------------------------------------------------------------
+# 모델 다운로드 (HuggingFace Hub)
+# -----------------------------------------------------------------------------
+HF_MODEL_REPO = "YoungjaeDev/fall-detection-models"
+
+
+def download_models() -> tuple[str, str]:
+    """
+    HuggingFace Hub에서 모델 다운로드 (캐시됨)
+
+    Returns:
+        tuple: (pose_model_path, stgcn_checkpoint_path)
+    """
+    # 로컬 경로 우선 확인 (개발 환경)
+    local_pose = Path("yolo11m-pose.pt")
+    local_stgcn = Path("runs/stgcn_binary_exp2_fixed_graph/best_acc.pth")
+
+    if local_pose.exists() and local_stgcn.exists():
+        return str(local_pose), str(local_stgcn)
+
+    # HuggingFace Hub에서 다운로드 (Private repo는 HF_TOKEN 환경변수 필요)
+    token = os.environ.get("HF_TOKEN")
+
+    pose_model_path = hf_hub_download(
+        repo_id=HF_MODEL_REPO,
+        filename="yolo11m-pose.pt",
+        token=token
+    )
+
+    stgcn_checkpoint = hf_hub_download(
+        repo_id=HF_MODEL_REPO,
+        filename="best_acc.pth",
+        token=token
+    )
+
+    return pose_model_path, stgcn_checkpoint
+
+
 # -----------------------------------------------------------------------------
 # 파이프라인 초기화 (지연 로딩)
 # -----------------------------------------------------------------------------
@@ -154,15 +193,8 @@ def get_pipeline():
     if _pipeline is None:
         from pipeline.core.pipeline import FallDetectionPipeline
 
-        # HF Spaces에서는 models 폴더에서 로드
-        pose_model_path = "pipeline/demo_gradio/models/yolo11m-pose.pt"
-        stgcn_checkpoint = "pipeline/demo_gradio/models/best_acc.pth"
-
-        # 로컬 경로 폴백
-        if not Path(pose_model_path).exists():
-            pose_model_path = "yolo11m-pose.pt"
-        if not Path(stgcn_checkpoint).exists():
-            stgcn_checkpoint = "runs/stgcn_binary_exp2_fixed_graph/best_acc.pth"
+        # 모델 다운로드 (캐시됨)
+        pose_model_path, stgcn_checkpoint = download_models()
 
         _pipeline = FallDetectionPipeline(
             pose_model_path=pose_model_path,

examples/00050_H_A_BY_C1.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:b9b8a0348200c40663bb852f4c590470ed95f43cf0cdb5c184eb69601b34c99e
+size 13167084

examples/00050_H_A_BY_C2.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a49cc52f966b4532590e0e3f4b3303304c64bd3812fb86a05a445756f4ebb8bb
+size 13299992

examples/00750_O_E_BY_C1.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:3b2473e3c40d6eb09b6343a17a19a4deebc1118c709eb4b5c8df1935ced9198d
+size 12700514

examples/00750_O_E_BY_C2.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:09d4530baeefa30a00cabea8823663b1f126599b9a7327f8619b8170d81b0a07
+size 13285269

examples/01602_L_F_BY_C2.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:7997c263b35c33bdcf4daa9caee37c70eaf864ca68a1d55306a82f7e2f184183
+size 13820623

examples/01823_Y_A_BY_C4.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:adf7972e75d173c659f343d19a97cb1de0f533f4a46dc3555a4bd4002726a305
+size 10517437