---
title: H2 Physics Feynman Bot
emoji: ⚛️
colorFrom: blue
colorTo: purple
sdk: docker
app_file: app.py
pinned: false
license: mit
---

# ⚛️ H2 Physics Feynman Bot

An AI physics tutor using Groq API with Richard Feynman's teaching style, designed for Singapore H2 Physics students.

## 🚀 Quick Start

1. **Get a FREE Groq API key** from [console.groq.com](https://console.groq.com)
2. **Enter your API key** in the sidebar
3. **Select a physics topic** from the dropdown
4. **Start chatting** with Feynman!

## 🎯 Features

- 🎓 **Feynman-style tutoring** - Teaches like the Nobel laureate
- 📊 **Graph plotting** - Generates physics graphs with Python
- 🖼️ **Diagram search** - Finds relevant physics diagrams
- 🗣️ **Text-to-speech** - Reads responses aloud
- ⚡ **Fast responses** - Powered by Groq's LPU technology
- 🆓 **Free tier** - 10,000 requests/month

## 🛠️ Setup on Hugging Face

### Method 1: Quick Deploy
1. **Fork this Space** (click Fork button)
2. **Add your Groq API key** in Settings → Secrets:
3. **Wait for build** (2-5 minutes)

### Method 2: Manual Setup
1. **Create new Space** on Hugging Face
2. **Select "Docker"** as SDK
3. **Upload files:**
- `app.py`
- `Dockerfile`
- `requirements.txt`
- `README.md` (this file)
4. **Add API key** as Secret
   **Add Secrets** (in Space settings → Settings → Secrets):
   ```yaml
   DEEPSEEK_API_KEY: "your-deepseek-api-key-here"
   # Optional for image search:
   GOOGLE_SEARCH_KEY: "your-google-search-key"
   GOOGLE_CX: "your-google-cx"
   GOOGLE_SEARCH_KEY_2: "your-google-search-key-2"  # optional backup
5. **Wait for build**

## 📚 Topics Covered
Based on Singapore H2 Physics (9478) Syllabus)
Based on Singapore H2 Physics (9478) Syllabus:

Measurement & Uncertainty

Kinematics & Dynamics

Forces & Turning Effects

Work, Energy, Power

Circular Motion

Gravitational Fields

Thermal Physics

Oscillations & Waves

Electricity & DC Circuits

Electromagnetism (EMI/AC)

Modern Physics (Quantum/Nuclear)

Paper 4: Practical Skills