Update README.md

README.md

@@ -10,21 +10,29 @@ pinned: false
 license: mit
 ---
 
-# 🌖 EngGloss — Groq-Powered Chatbot with Gradio Frontend
+# 🌖 EngGloss — Groq-Powered Engineering Term Explainer
 
-This project is a **Gradio-based AI chatbot** powered by the **Groq LLM API**.  
-It allows you to interact with large language models like **LLaMA 3** via a simple and beautiful web interface.
+EngGloss is a small educational web app that explains engineering terms in a short, beginner-friendly structure:
+- 🔍 Term
+- 📘 Simple Explanation
+- 🧠 Real-World Analogy
+- 📐 Typical Formula (if any)
+- 🏗️ Practical Engineering Applications
 
----
+It uses the Groq REST API (no Groq Python SDK) and Gradio for the UI — this avoids known SDK compatibility problems in some environments.
 
-## 🚀 Features
+---
 
-- 🎯 **Frontend:** Gradio (clean and responsive)
-- ⚡ **Backend:** Groq API (`llama3-8b-8192` model)
-- 🔐 Secure API key handling via `.env` or Hugging Face Secrets
-- 🧠 Persistent chat history per session
+## Files
+- `app.py` — Main Gradio application (calls Groq REST API via `requests`)
+- `requirements.txt` — Required Python packages
+- `.env.example` — Example env file for local testing
 
 ---
 
-## 🧩 Project Structure
+## Local setup & test
 
+1. Create venv (recommended):
+```bash
+python -m venv venv
+source venv/bin/activate   # Windows: venv\Scripts\activate