UPLOAD_GUIDE.md

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

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

0. 준비 (1회)

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

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

1. private 레포 생성 (1회)

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

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

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 대응 — 강력 권장)

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 등에서 받기

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