HUGGINGFACE_SETUP.md

Quick Hugging Face Space Connection Guide

Step 1: Find Your Space URL

Your Hugging Face Space URL should look like:

https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME

For example: https://huggingface.co/spaces/ParamJaiswal/TalentTalkPro

Step 2: Add Hugging Face as a Git Remote

Run this command in your terminal (replace YOUR_USERNAME and YOUR_SPACE_NAME with your actual values):

cd /home/runner/work/TalentTalkPro/TalentTalkPro
git remote add hf https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME

Example:

git remote add hf https://huggingface.co/spaces/ParamJaiswal/TalentTalkPro

Step 3: Push Code to Hugging Face

# Make sure all files are committed
git add .
git commit -m "Add Hugging Face deployment configuration"

# Push to Hugging Face Space
git push hf main

Note: You'll be prompted for your Hugging Face credentials:

• Username: Your Hugging Face username
• Password: Use your Hugging Face Access Token (NOT your account password)

How to Get Your Hugging Face Access Token:

1. Go to https://huggingface.co/settings/tokens
2. Click "New token"
3. Give it a name (e.g., "TalentTalkPro")
4. Select "Write" access
5. Click "Generate"
6. Copy the token and use it as your password when pushing

Step 4: Configure Environment Variables

After pushing, you need to add your API keys:

1. Go to your Space page: https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME
2. Click on "Settings" tab
3. Scroll down to "Repository secrets" section
4. Click "Add a new secret" for each:

Required Secrets:

• Name: GOOGLE_API_KEY → Value: Your Google AI API key
• Name: OPENROUTER_API_KEY → Value: Your OpenRouter API key
• Name: ASSEMBLYAI_API_KEY → Value: Your AssemblyAI API key
• Name: ELEVENLABS_API_KEY → Value: Your ElevenLabs API key

Optional Secrets (with defaults):

• Name: DATABASE_URL → Value: sqlite+aiosqlite:///./talenttalk.db
• Name: BACKEND_CORS_ORIGINS → Value: *

5. Click "Save" after adding each secret

Step 5: Wait for Build

• Your Space will automatically start building
• This takes about 5-10 minutes
• Watch the build logs in the "Logs" tab
• Once complete, your app will be live!

Alternative Method: Upload Files Directly

If you prefer not to use Git, you can upload files directly:

1. Go to your Space page
2. Click "Files and versions" tab
3. Click "Add file" → "Upload files"
4. Upload all the files from your repository
5. Make sure to include:
   • Dockerfile
   • start_huggingface.sh
   • README.md
   • .dockerignore
   • All backend/ files
   • All frontend/ files
6. Commit the files

Troubleshooting

Authentication Failed

If git push fails with authentication error:

• Make sure you're using your Access Token as password, not your account password
• Check token has "Write" permissions
• Try: git config credential.helper store to save credentials

Build Failed

• Check the "Logs" tab in your Space
• Verify all environment variables are set
• Make sure all required files are pushed

Space Not Starting

• Verify all 4 required API keys are configured
• Check if the keys are valid
• Look for error messages in the Logs

Need Help?

See the full deployment guide in DEPLOYMENT.md for detailed troubleshooting and configuration options.