HF_SPACE_SETUP.md

Hugging Face Space Environment Variables Setup

After your GitHub Actions deploys your app to Hugging Face Spaces, you need to configure the API keys directly in your Hugging Face Space.

Step 1: Go to Your Space Settings

1. Visit your deployed space: https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME
2. Click the "Settings" tab (next to "App", "Files", etc.)

Step 2: Add Environment Variables

In the Settings page, scroll down to find the "Repository secrets" or "Variables and secrets" section.

Add these secrets:

Variable Name	Value	Description
OPENAI_API_KEY	sk-...	Your OpenAI API key (if using OpenAI models)
ANTHROPIC_API_KEY	sk-ant-...	Your Anthropic API key (if using Claude)

Step 3: How to Add Each Secret

1. Click "New secret"
2. Name: Enter the variable name exactly (e.g., OPENAI_API_KEY)
3. Value: Enter your API key
4. Click "Add secret"
5. Repeat for each API key

Step 4: Restart Your Space

After adding the secrets:

1. Go back to the "App" tab
2. Your space should automatically restart
3. If not, click the "⟳ Restart" button

Important Notes:

• ✅ Secrets are secure - They won't be visible in logs or to other users
• ✅ Environment variables override .env - Even if there's a .env file, the Space secrets take priority
• ✅ No need to redeploy - Changes take effect immediately after restart
• ⚠️ Case sensitive - Variable names must match exactly

Verification:

Your app should now work with the API keys. Check the Space logs:

1. Go to your Space
2. Click "Logs" tab
3. Look for successful API connections

Troubleshooting:

If your app still shows API key errors:

1. Check variable names - Must be exactly OPENAI_API_KEY or ANTHROPIC_API_KEY
2. Check API key format - OpenAI keys start with sk-, Anthropic with sk-ant-
3. Restart the space - Changes may require a restart
4. Check logs - Look for specific error messages in the Logs tab

Alternative: Using Hugging Face CLI (Advanced)

You can also set secrets via CLI if you have huggingface_hub installed:

# Install the CLI
pip install huggingface_hub

# Login
huggingface-cli login

# Add secrets
huggingface-cli repo add-secret YOUR_USERNAME/YOUR_SPACE_NAME OPENAI_API_KEY "your_key_here"
huggingface-cli repo add-secret YOUR_USERNAME/YOUR_SPACE_NAME ANTHROPIC_API_KEY "your_key_here"

---

Once you've set up these environment variables in your Hugging Face Space, your fitness app should work perfectly! 🎉