🧠 Professor AI

Professor AI is an intelligent AI-powered teaching assistant that helps users learn complex topics with deep explanations, visual aids, and trustworthy reference links. Built with React, FastAPI, and Groq's LLaMA models, it combines the power of conversational AI with educational tools to create a smarter learning experience.

---

✨ Features

• 🔍 Ask anything - get deep, intuitive topic explanations
• 🧠 Powered by GPT OSS 20B
• 📚 Generates citations and reference links
• 🖼️ Auto fetches visual content (diagrams, illustrations)
• 🌓 Light/Dark mode toggle
• ⚡ Fast and lightweight UI (Vite + React)
• 💬 Session-aware explanations with memory

---

🧰 Tech Stack

Layer	Technologies
Frontend	React, Vite, TailwindCSS
Backend	FastAPI, Python
LLM API	Groq API (GPT OSS 20B)
Deployment	Vercel (Frontend + Backend)

---

The Model

GPT OSS 20B has a total parameter count of 21B, its Mixture-of-Experts (MoE) architecture means it only activates 3.6B parameters per token. This makes it incredibly efficient, maintaining highly competitive STEM intelligence while running at blistering speeds (~1,000 tokens per second on Groq).

---

🚀 Getting Started

1. Clone the Repository

git clone https://github.com/AnmolManiDubey/Professor.git
cd Professor

2. Install Frontend Dependencies

cd frontend/professor-frontend
npm install

3. Install Backend Dependencies

cd ../../backend
pip install -r requirements.txt

4. Run the App Locally

Backend

uvicorn app.main:app --reload

Frontend

cd frontend/professor-frontend
npm run dev

---

🌍 API Endpoint

Backend (Deployed) https://professor-backend.vercel.app/teach

Sample Request

POST /teach
{
  "topic": "Convolutional Neural Networks",
  "messages": [{"role": "user", "content": "Explain CNN"}]
}

---

📸 Screenshots

(Add some screenshots/gifs showing the chat, light/dark mode, and image cards)

---

📦 Folder Structure

Professor/
├── backend/
│   ├── app/
│   │   ├── routes/
│   │   ├── services/
│   │   └── main.py
├── frontend/
│   └── professor-frontend/
│       ├── src/
│       ├── public/
│       └── App.jsx

📜 License

MIT License © 2025 Anmol Mani Dubey

---

🤝 Contributing

Pull requests are welcome! For major changes, please open an issue first to discuss what you'd like to change.

---