# 허깅페이스 업로드 가이드 (이대로 실행하면 됩니다)

번들 위치: `~/hf_upload_g1_phasetrack_pt18/` (이 파일 포함 — 업로드에 포함돼도 무해)

## 0. 준비 (1회)

```bash
pip install -U "huggingface_hub[cli]"
huggingface-cli login          # HF 토큰 입력 (write 권한 토큰: hf.co/settings/tokens)
```

조직 계정(clobot org)에 올리려면 토큰이 그 org 쓰기 권한을 가져야 합니다.

## 1. private 레포 생성 (1회)

```bash
# 개인 계정이면 <owner>를 본인 username으로, 조직이면 org 이름으로
huggingface-cli repo create g1-29dof-phasetrack-pt18 --repo-type model --private
```

## 2. 업로드 (번들 통째로)

```bash
huggingface-cli upload <owner>/g1-29dof-phasetrack-pt18 \
    ~/hf_upload_g1_phasetrack_pt18 . \
    --repo-type model \
    --commit-message "PT18 deploy king v0.1.0 (real-robot validated)"
```

## 3. 버전 태그 (git tag v0.1.0과 1:1 대응 — 강력 권장)

```bash
python - << 'EOF'
from huggingface_hub import HfApi
HfApi().create_tag("<owner>/g1-29dof-phasetrack-pt18", tag="v0.1.0",
                   tag_message="PT18 = deploy king; code = clobot_rl_lab git tag v0.1.0")
EOF
```

## 4. 로봇 PC 등에서 받기

```bash
huggingface-cli download <owner>/g1-29dof-phasetrack-pt18 --local-dir ./pt18
# 배포에 필요한 건 pt18/deploy/{policy.onnx,deploy.yaml} 둘 뿐
```

## 이후 왕 교체 시 운영 규칙 (제안)

1. 새 왕 확정(실기 검증 통과) 때마다: 번들 갱신 → `huggingface-cli upload` (같은 레포) →
   새 태그 (예: v0.2.0) → git tag도 동일 버전으로
2. **checkpoints/*.pt를 꼭 포함** (웜스타트 씨앗 — onnx만으로는 이어서 학습 불가)
3. README의 "실기 검증 상태 / 알려진 한계" 표를 그 시점 스냅샷으로 갱신

## 무결성 체크섬

- deploy/policy.onnx : md5 `a7a86c861e6cf1f06eda4de906114338`
- checkpoints/model_23200.pt : md5 `39a3f8d7fd299b1763d0498051be5817`