huggingface-deploy

When to Use

• Creating a public demo of LearnFlow without K8s setup
• Showcasing the AI tutoring capabilities on HuggingFace Spaces
• Quick evaluation deployment for hackathon judges

Instructions

1. Build the Gradio app:

   python scripts/build_app.py
   

2. Test locally:

   python learnflow-app/huggingface-space/app.py
   

3. Deploy to HuggingFace Spaces:

   bash scripts/deploy.sh
   

4. Verify deployment:

   python scripts/verify.py
   

What Gets Deployed

• Gradio interface with Python tutor chat
• Code execution demo with Monaco-like editor
• Progress tracking simulation
• All powered by Groq/OpenAI API

Validation

• [ ] Gradio app runs locally on port 7860
• [ ] HuggingFace Space shows "Running" status
• [ ] Chat interface responds to Python questions
• [ ] Code execution returns correct output

See REFERENCE.md for Space configuration and GPU requirements.