DEPLOY.md

🚀 Quick Deployment Instructions

✅ Repository Status

SimpleHF is now synced with Hugging Face Space!

Repository: https://huggingface.co/spaces/gladguy/SimpleProject
Branch: main
Latest commit: 119408d - "Add AnatomyBot - MBBS Anatomy Tutor with AI-powered learning features"

📤 Push to Hugging Face

Run this command to deploy:

git push origin main

If you need authentication, use your Hugging Face credentials:

• Username: gladguy (or your username)
• Password: Your Hugging Face access token (get from https://huggingface.co/settings/tokens)

🔑 Configure API Keys (CRITICAL!)

After pushing, you MUST add these secrets in your Space settings:

1. Go to: https://huggingface.co/spaces/gladguy/SimpleProject/settings
2. Scroll to Repository secrets
3. Add:
   • Name: SERPAPI_KEY → Value: Your SERPAPI key
   • Name: HYPERBOLIC_API_KEY → Value: Your Hyperbolic key

✨ What's Included

✅ app.py - Main AnatomyBot application with:

• Anatomy-only question validation
• Google Images search via SERPAPI
• AI content generation via Hyperbolic (Llama 3.3 70B)
• Interactive Gradio interface

✅ requirements.txt - All Python dependencies

✅ README.md - Space description with Hugging Face configuration

✅ setup.py - Helper script to configure API keys locally

✅ .gitignore - Prevents committing .env and other sensitive files

🎯 After Deployment

Your Space will be live at: https://huggingface.co/spaces/gladguy/SimpleProject

Test with these questions:

• "Show me the Circle of Willis"
• "Brachial plexus anatomy"
• "Carpal bones arrangement"

📝 Local Testing (Before Pushing)

To test locally first:

1. Configure your API keys:

   python setup.py
   # OR manually edit .env file
   

2. Run the app:

   python app.py
   

3. Open http://localhost:7860 in your browser

🔧 Troubleshooting

Issue: Authentication failed when pushing

# Use access token in URL
git remote set-url origin https://gladguy:YOUR_TOKEN@huggingface.co/spaces/gladguy/SimpleProject
git push origin main

Issue: Space shows error after deployment

• Check that both API keys are set in Space secrets
• Check the build logs in the Space

📊 Files Ready to Deploy

SimpleHF/
├── .gitignore          ✅ Committed
├── README.md           ✅ Committed (with HF config)
├── app.py              ✅ Committed
├── requirements.txt    ✅ Committed
├── setup.py            ✅ Committed
└── .env                ❌ Not committed (contains secrets)

🎉 Ready to Deploy!

Everything is committed and ready. Just run:

git push origin main

Then configure your API keys in the Space settings!