HOW_TO_UPLOAD_TO_HF_SPACES.md

How to Upload app.py to HuggingFace Spaces

✅ Good News: app.py is Already Fixed!

Your local app.py file is correctly configured with:

• ✅ USE_HF_API = "True" (line 143)
• ✅ USE_LMSTUDIO = "False" (line 144)
• ✅ LLM_BACKEND = "hf_api" (line 145)
• ✅ LLM_TIMEOUT = "180" (line 147)

Location: /home/john/TranscriptorEnhanced/app.py File size: 44KB Last modified: Oct 30, 18:04

---

🚀 How to Upload to Your HuggingFace Space

Method 1: Via HuggingFace Web Interface (Easiest)

1. Open your Space in browser

   • Go to: https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE

2. Click "Files" tab

3. Click on "app.py" to open it

4. Click the "Edit" button (pencil icon)

5. Delete ALL content in the editor (Ctrl+A, Delete)

6. Open your local file:

   # On your local machine, open:
   /home/john/TranscriptorEnhanced/app.py
   

7. Copy ALL content from your local file (Ctrl+A, Ctrl+C)

8. Paste into HF editor (Ctrl+V)

9. Click "Commit changes to main"

10. Wait 2-3 minutes for Space to rebuild

---

Method 2: Via Git (If You Have Git Access)

If you cloned your Space repository:

# Navigate to your Space repo
cd /path/to/your-space-repo

# Copy the fixed file
cp /home/john/TranscriptorEnhanced/app.py .

# Commit and push
git add app.py
git commit -m "Fix: Force HF API mode to resolve timeout errors"
git push

---

Method 3: Direct File Upload

1. Go to your Space: https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE

2. Click "Files" tab

3. Click "Upload files" button

4. Select your local file:

   /home/john/TranscriptorEnhanced/app.py
   

5. Choose: "Overwrite existing file"

6. Click "Commit"

---

✅ Verification After Upload

Step 1: Check the Logs

After your Space restarts, click the "Logs" tab and look for:

🚀 Forcing HF API mode for HuggingFace Spaces deployment...
✅ HuggingFace token detected
✅ Configuration loaded for HuggingFace Spaces
🚀 TranscriptorAI Enterprise - LLM Backend: hf_api
🔧 USE_HF_API: True
🔧 USE_LMSTUDIO: False
🔧 LLM_TIMEOUT: 180s

Good signs:

• ✅ "Forcing HF API mode"
• ✅ "HuggingFace token detected"
• ✅ "LLM Backend: hf_api"
• ✅ "USE_HF_API: True"

Bad signs (means old file still there):

• ❌ "LLM Backend: local"
• ❌ "USE_HF_API: False"
• ❌ "Loading local model: microsoft/Phi-3"

Step 2: Test Processing

Upload a test transcript and check logs for:

INFO: Calling HF API: microsoft/Phi-3-mini-4k-instruct

Should NOT see:

INFO: Generating with local model
ERROR: LLM generation timed out

Step 3: Check Quality Score

After processing completes:

• ✅ Quality Score should be 0.70-1.00 (not 0.00)
• ✅ Processing time: 30-60 minutes for 10 files (not hours)
• ✅ No timeout errors

---

🔍 Troubleshooting

Issue: "Still seeing timeout errors"

Check 1: Verify file was uploaded

• Go to Files tab in your Space
• Click app.py
• Search for line 143
• Should say: os.environ["USE_HF_API"] = "True"
• If it says setdefault instead, the file wasn't uploaded correctly

Check 2: Verify token is set

• Go to Settings tab
• Look for HUGGINGFACE_TOKEN in secrets
• If not there, add it from https://huggingface.co/settings/tokens

Check 3: Force rebuild

• Settings tab → "Factory reboot"
• This clears all caches and rebuilds from scratch

Issue: "Logs show 'USE_HF_API: False'"

Cause: Old file still being used

Fix:

1. Delete app.py from your Space
2. Upload the fixed version again
3. Factory reboot

Issue: "HuggingFace token detected" not showing

Cause: Token not set in Space secrets

Fix:

1. Go to: https://huggingface.co/settings/tokens
2. Create new token (type: Read)
3. Go to Space → Settings → Repository secrets
4. Add: Name=HUGGINGFACE_TOKEN, Value=(your token)
5. Factory reboot

---

📋 Quick Checklist

Before upload:

• Local app.py has USE_HF_API = "True" on line 143 ✓ (already confirmed)
• HUGGINGFACE_TOKEN is set in Space secrets
• Ready to upload file

After upload:

• File uploaded successfully
• Space rebuilt (takes 2-3 minutes)
• Logs show "Forcing HF API mode"
• Logs show "USE_HF_API: True"
• Logs show "LLM Backend: hf_api"
• Test transcript processes without timeout
• Quality Score > 0.00

---

🎯 Expected Timeline

1. Upload file: 1 minute
2. Space rebuild: 2-3 minutes
3. First transcript test: 5-10 minutes (for a typical file)
4. Total: ~15 minutes to confirm it's working

---

📞 If Still Not Working

After uploading and waiting for rebuild, if you still see timeout errors:

1. Copy the startup logs (first 50 lines)
2. Copy the error logs (when processing fails)
3. Check these specific lines:
   • Line showing "LLM Backend: ???"
   • Line showing "USE_HF_API: ???"
   • Line showing "Calling HF API" or "Generating with local model"

This will help diagnose if the file uploaded correctly or if there's another issue.

---

✅ File is Ready - Just Upload It!

Your local file at /home/john/TranscriptorEnhanced/app.py is 100% correct.

All you need to do is:

1. Copy it to your HuggingFace Space (Method 1, 2, or 3 above)
2. Wait for rebuild
3. Test!

The timeout issue will be completely resolved once this file is on your Space. 🚀