GitHub Actions

GitHub Actions를 사용하여 GitHub 저장소를 Hugging Face Hub에 자동으로 동기화할 수 있습니다. 공식 huggingface/hub-sync 액션은 Models, Datasets, Spaces 동기화를 지원합니다.

키 없이 게시하는 방법 — 저장하거나 교체할 HF_TOKEN 시크릿이 필요하지 않습니다 — 각 실행 시작 시 GitHub Actions의 내장 OIDC 토큰을 짧은 수명의 저장소 범위 Hub 토큰으로 교환하는 Trusted Publishers를 참조하세요.

설정

1. 대상 저장소에 대한 write 권한이 있는 Hugging Face access token을 생성하세요. 보안을 강화하기 위해 동기화 대상 저장소에만 범위가 설정된 fine-grained token을 사용하세요.
2. 리포지토리 설정에서 토큰을 HF_TOKEN이라는 이름의 GitHub secret으로 추가하세요.
3. 리포지토리에 워크플로 파일(예: .github/workflows/sync-to-hub.yml)을 추가하세요.

기본 사용법

name: Sync to Hugging Face Hub
on:
  push:
    branches: [main]

jobs:
  sync:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: huggingface/hub-sync@v0.3.0
        with:
          github_repo_id: ${{ github.repository }}
          huggingface_repo_id: username/repo-name
          hf_token: ${{ secrets.HF_TOKEN }}

기본적으로 Space에 동기화됩니다. 모델 또는 데이터셋을 동기화하려면 repo_type 매개변수를 설정하세요:

      - uses: huggingface/hub-sync@v0.3.0
        with:
          github_repo_id: ${{ github.repository }}
          huggingface_repo_id: username/my-dataset
          hf_token: ${{ secrets.HF_TOKEN }}
          repo_type: dataset

매개변수

이 액션은 hf CLI를 사용하여 파일을 Hub에 미러링합니다. git-to-git 동기화가 아닙니다. .github/ 및 .git/ 디렉터리를 자동으로 제외하고 삭제 사항을 미러링합니다(GitHub에서 삭제된 파일은 Hub에서도 삭제됩니다).

더 복잡한 워크플로(예: 빌드 단계, 사용자 정의 업로드 로직)의 경우, 워크플로에서 hf CLI를 직접 설치하여 사용할 수 있습니다.

Spaces에 대한 구체적인 가이드(파일 크기 제한, LFS 처리)는 GitHub Actions를 사용한 Spaces 관리를 참고하세요.