setup_hf_space.md

Hugging Face Spaces Setup Guide

Quick Deployment to Hugging Face Spaces

1. Create a New Space

1. Go to Hugging Face Spaces
2. Click "Create new Space"
3. Choose:
   • Space name: business-card-extractor
   • License: mit
   • Space SDK: gradio
   • Visibility: public or private

2. Upload Files

Upload these files to your space:

app.py
requirements.txt
prompts/prompt.txt
prompts/system_prompt.txt
README.md
business_cards/.gitkeep

Note: The business_cards/ and business_card_exports/ directories will be created automatically.

3. Set Environment Variables

1. Go to your Space Settings

2. Scroll to Repository secrets

3. Click Add a new secret

4. Add these secrets:

   Required:

   • Name: Gemini_API
   • Value: Your AI API key

   Optional (for password protection):

   • Name: HF_SPACE_PASSWORD
   • Value: Your desired password
   • Note: Users will login with username: user and this password

4. Get Your AI API Key

1. Go to Google AI Studio
2. Click "Get API key"
3. Create a new API key
4. Copy the key for use in step 3

5. Your Space is Ready!

• The space will automatically build and deploy
• It will be available at: https://huggingface.co/spaces/YOUR_USERNAME/business-card-extractor
• All business card images and Excel files will be saved in the space

Features Available in Hugging Face Spaces

✅ Full functionality: All features work in Hugging Face Spaces
✅ Image storage: Business cards saved to business_cards/ folder
✅ Excel exports: Download both current run and cumulative files
✅ Persistent storage: All data preserved between sessions
✅ Batch processing: Efficient 5-cards-per-API-call processing

Environment Variables Required

• Gemini_API: Your AI API key (required)
• HF_SPACE_PASSWORD: Password for space access (optional)

Notes

• The space will create necessary directories automatically
• Logs are available in the space's terminal/logs
• All uploaded images are processed and optionally saved
• Excel files accumulate over time in the cumulative database