QUICKSTART.md

🚀 Quick Start - Deploy in 30 Minutes!

✅ Complete Checklist

Prerequisites (5 minutes)

• Hugging Face account created (https://huggingface.co - FREE!)
• Git installed on your computer
• Your Aclarador code accessible (or use placeholder)

Deployment (25 minutes)

1. Create Hugging Face Space (3 minutes)

• Go to https://huggingface.co/new-space
• Name: madrid-content-analyzer
• SDK: Gradio
• Click "Create Space"

2. Clone Your Space (2 minutes)

# Get your access token from https://huggingface.co/settings/tokens

# Clone
git clone https://huggingface.co/spaces/YOUR_USERNAME/madrid-content-analyzer
cd madrid-content-analyzer

3. Copy Project Files (5 minutes)

# Copy everything from this folder to your cloned space
# From: /mnt/user-data/outputs/madrid-analyzer-hf/
# To: your madrid-content-analyzer/ folder

# All these files:
cp -r /path/to/madrid-analyzer-hf/* .

4. Add Your Aclarador (10 minutes)

Option A: Have Aclarador ready

cd analyzers/aclarador
git clone https://github.com/YOUR_USERNAME/aclarador.git .

# Or copy local files
cp -r /path/to/aclarador/* .

# Update ../analyzer_wrapper.py (see ACLARADOR_INTEGRATION.md)

Option B: Use placeholder (deploy now, add Aclarador later)

# The placeholder is already in analyzer_wrapper.py
# Skip to step 5!

5. Deploy! (2 minutes)

# Add all files
git add .

# Commit
git commit -m "Deploy Madrid Content Analyzer"

# Push (will ask for your HF username and token)
git push

# ✅ Space will build automatically (2-5 minutes)

6. Verify (3 minutes)

• Go to your Space URL
• Wait for "Running" status
• Test Dashboard tab
• Click "Trigger Manual Fetch" in Settings
• Wait 1-2 minutes
• Refresh Dashboard - you should see data!

---

🎉 You're Live!

Your Space is at:

https://huggingface.co/spaces/YOUR_USERNAME/madrid-content-analyzer

Public URL:

https://YOUR_USERNAME-madrid-content-analyzer.hf.space

---

📋 What's Next?

Immediate

• App deployed and running
• Verify automatic fetches work (every 6 hours)
• Check data persists
• Share your Space URL!

Soon

• If using placeholder: Add real Aclarador
• Customize fetch frequency in app.py (line 35)
• Adjust UI in app.py
• Add more data sources

Later

• Make private if desired (Settings → Visibility)
• Add secrets if needed (Settings → Repository secrets)
• Monitor database size (Settings tab in app)
• Export and analyze data

---

🆘 Troubleshooting

Space won't start

Check: Space logs (App files → Logs) Common fix: Missing dependency in requirements.txt

No data showing

Check: Trigger manual fetch (Settings tab) Wait: 1-2 minutes for fetch to complete

Import errors

Check: Aclarador files are in analyzers/aclarador/ Check: init.py exists in aclarador folder

Database errors

Check: /data/ directory is used (see config/database.py)

---

📚 Full Documentation

• DEPLOYMENT_GUIDE.md - Complete step-by-step guide
• ACLARADOR_INTEGRATION.md - Detailed Aclarador setup
• README.md - Space description
• HUGGING_FACE_READY.md - Overview and benefits

---

💰 Cost

$0/month forever! 🎉

No credit card required. 16GB storage. Always on.

---

Ready? Let's deploy! 🚀