DEPLOY_INSTRUCTIONS.md

🚀 Steps to Deploy on Hugging Face

Step 1: Generate a Hugging Face token

1. Visit https://huggingface.co/settings/tokens
2. Click “New token”
3. Choose “Write” permission
4. Copy the generated token

Step 2: Log in to Hugging Face

Run in your terminal:

huggingface-cli login

Then paste your token when prompted.

Or provide it via environment variable:

export HF_TOKEN="your_token"
huggingface-cli login --token $HF_TOKEN

Step 3: Deploy the app

Run:

gradio deploy

Or use the helper script:

./deploy_hf.sh

Step 4: Add Google Drive secrets (post-deployment)

1. Open your Space page: https://huggingface.co/spaces/<username>/<space-name>
2. Go to the “Settings” tab
3. Under “Repository secrets” add:
   • Name: GOOGLE_SERVICE_ACCOUNT_JSON
   • Value: paste the full Service Account JSON content

Done!

Wait 2–5 minutes for the build to finish, then open your Space URL.