Fix permission error and add persistent storage fallback

.gitignore

@@ -0,0 +1,47 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+env/
+venv/
+ENV/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Database
+data/
+*.duckdb
+*.duckdb.wal
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+
+# Environment
+.env
+.env.local

HF_SPACES_SETUP.md

@@ -0,0 +1,138 @@
+# Hugging Face Spaces Setup Guide
+
+## Quick Fix for Permission Error
+
+If you see this error:
+```
+PermissionError: [Errno 13] Permission denied: '/data'
+```
+
+The app will automatically fall back to using a local `data/` directory. **However**, this means data won't persist between Space restarts.
+
+## Enable Persistent Storage (Recommended)
+
+To enable persistent data storage on Hugging Face Spaces:
+
+### Option 1: Via Space Settings (Easiest)
+
+1. Go to your Space on Hugging Face
+2. Click **Settings** tab
+3. Scroll to **Storage** section
+4. Click **Enable persistent storage**
+5. Choose storage size (Free: Small - 20GB is plenty)
+6. Click **Save**
+7. **Restart your Space** (Factory reboot)
+
+### Option 2: Via README.md Header
+
+Add this to your `README.md` file header (the YAML section at the top):
+
+```yaml
+---
+title: Madrid Content Analyzer
+emoji: 🏛️
+colorFrom: blue
+colorTo: green
+sdk: gradio
+sdk_version: 4.44.0
+app_file: app.py
+pinned: false
+license: mit
+storage: small  # <- Add this line
+---
+```
+
+Then commit and push:
+```bash
+git add README.md
+git commit -m "Enable persistent storage"
+git push
+```
+
+## What Persistent Storage Does
+
+When enabled:
+- ✅ `/data` directory becomes available
+- ✅ DuckDB database persists across Space restarts
+- ✅ All your analyzed content is saved permanently
+- ✅ Charts and statistics accumulate over time
+
+Without it:
+- ⚠️ Data stored in local `data/` directory
+- ⚠️ Database is deleted when Space restarts/rebuilds
+- ⚠️ You'll lose all historical data
+
+## Verify It's Working
+
+After enabling persistent storage and restarting:
+
+1. Check the Space logs for:
+   ```
+   ✅ Using persistent storage at /data/madrid.duckdb
+   ```
+
+2. If you see:
+   ```
+   ⚠️ Cannot use /data directory
+   ✅ Using local storage at .../data/madrid.duckdb
+   ```
+   Then persistent storage is NOT enabled yet.
+
+## Configure API Key
+
+While you're in Settings, also add your Groq API key:
+
+1. Go to **Repository secrets**
+2. Click **New secret**
+3. Name: `GROQ_API_KEY`
+4. Value: Your API key from https://console.groq.com
+5. Click **Save**
+
+## Complete Setup Checklist
+
+- [ ] Space created on Hugging Face
+- [ ] Persistent storage enabled (Settings → Storage)
+- [ ] Space restarted after enabling storage
+- [ ] GROQ_API_KEY added to secrets
+- [ ] Code pushed to Space
+- [ ] Space building successfully
+- [ ] Check logs for "Using persistent storage at /data/madrid.duckdb"
+- [ ] Trigger manual fetch (Settings tab in app)
+- [ ] Verify data appears in Dashboard
+
+## Troubleshooting
+
+### "Building" stuck for a long time
+- Normal for first build (installing dependencies)
+- Usually takes 2-5 minutes
+- Check build logs for errors
+
+### Space keeps restarting
+- Check logs for errors
+- Verify all dependencies in requirements.txt
+- Make sure GROQ_API_KEY is set (or app will use fallback)
+
+### Data disappears after restart
+- Persistent storage not enabled
+- Follow steps above to enable it
+
+### "No space left on device"
+- Your database grew too large
+- Increase storage size in Settings
+- Or implement data retention policy
+
+## Storage Limits
+
+Free tier persistent storage options:
+- **Small**: 20GB (recommended for this project)
+- Can store millions of content items
+- Monitor size in Settings tab of the app
+
+## Cost
+
+Everything is **FREE**:
+- ✅ Hugging Face Spaces hosting
+- ✅ Persistent storage (up to 20GB free)
+- ✅ Groq API (generous free tier)
+
+No credit card required! 🎉

config/database.py

@@ -8,9 +8,19 @@ import os
 from pathlib import Path
 
 # Database path (persistent on HF Spaces!)
-DATA_DIR = Path('/data')
-DATA_DIR.mkdir(exist_ok=True)
-DB_PATH = DATA_DIR / 'madrid.duckdb'
+# Try /data first (HF Spaces persistent storage), fall back to local directory
+try:
+    DATA_DIR = Path('/data')
+    DATA_DIR.mkdir(exist_ok=True)
+    DB_PATH = DATA_DIR / 'madrid.duckdb'
+    print(f"✅ Using persistent storage at {DB_PATH}")
+except (PermissionError, OSError) as e:
+    print(f"⚠️  Cannot use /data directory: {e}")
+    print("Using local directory for database storage")
+    DATA_DIR = Path(__file__).parent.parent / 'data'
+    DATA_DIR.mkdir(exist_ok=True)
+    DB_PATH = DATA_DIR / 'madrid.duckdb'
+    print(f"✅ Using local storage at {DB_PATH}")
 
 # Global connection
 _conn = None