HuggingFaceのSpaceを構築する手順書です。

前提知識: コマンドプロンプトの操作経験者
到達目標: HuggingFaceのSpaceの環境構築及び実行

システム要件

ツール
Git
リポジトリ
Gradioのアプリが開発済みでローカルにClone済みであること。
アカウント
HuggingFaceの開設済みアカウント
⚠アカウント作成から一週間程度経過しないとスペースは作成出来ませんでした。(n=1)
画像は、新規アカウント作成後のSpaceの作成制限。

ローカルリポジトリの直下のReadMe.mdファイルの冒頭にSpaceの設定情報を追加する。
記述サンプルと公式情報：Spaces Configuration Reference

ReadMe.md

---
license: mit
title: Sample
sdk: gradio
emoji: 📊
colorFrom: yellow
colorTo: yellow
pinned: false
---

https://huggingface.co/settings/tokens を開き、「New Token」ボタンをクリックし、アクセストークンを作成する。
- Name: 任意の名前
- Type: Write
- 「Generate a token」ボタンをクリックして生成

https://huggingface.co/spaces を開き「Create new Space」ボタンをクリックし、新しいSpaceを作成する。

内容を入力し、Select the Space SDKはGradioを選択し「Create Space」を押す。

NOTE
Spaceの可視性の値(PublicとPrivate)は、後からSetttings画面で変更が行える。

git clone https://huggingface.co/spaces/<repo_path>

<repo_path>はリポジトリのパスです。

NOTE
.gitフォルダ以外をコピーします。

cd <Spaceのローカルリポジトリ名>

git remote set-url origin https://<user_name>:<token>@huggingface.co/<repo_path>

<user_name>はHugging Faceのユーザー名、<token>は作成したアクセストークン、<repo_path>はリポジトリのパスです。

NOTE
リモートURLを変更する前に、git remote -vで現在のリモートURLを確認できます。

git remote -v

git add .
git commit -m "Commit message"

git pull origin main
git push origin main

到達目標: 状態がRunningになり、動作確認を行える事
プッシュすると、アプリが自動的にビルドされ、起動する。
※Building→Starting→Runningと処理が進む。

https://huggingface.co/spaces/<repo_path>を開き、状態かどうかを確認する。

NOTE
Gradioのアプリのポート番号が7860以外の場合、StartingからRunningに状態が遷移しない現象が発生しました。
→ポート番号を7860に設定し解決しました。

HuggingFaceのSpaceの環境構築及び実行の説明を行いました。
GitHub Actionsを使用して自動デプロイする方法は、HuggingFace公式資料を参考にしてください。