Update README.md

README.md

@@ -1,14 +1,52 @@
----
-title: ExplainAnything AI
-emoji: 🏢
-colorFrom: indigo
-colorTo: indigo
-sdk: gradio
-sdk_version: 5.33.1
-app_file: app.py
-pinned: false
-license: mit
-short_description: ' A multimodal science tutor that explains images, answers qu'
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+📚 ExplainAnything.AI
+ExplainAnything.AI is an interactive multimodal science explainer built with Gradio. It allows users to:
+
+Ask science questions or upload diagrams/PDFs
+
+Get clear explanations using Google Gemini or Mistral
+
+Generate visual diagrams via FLUX (Stable Diffusion)
+
+Take auto-generated quizzes to test understanding
+
+Download personalized science reports in PDF or Markdown
+
+🚀 How It Works
+Ask a Question
+Type a science question (e.g., How do volcanoes erupt?)
+→ Choose level: Kid, Beginner, or Advanced
+
+Upload a File (Optional)
+You can upload a PDF, image, or diagram to get contextual explanations
+
+View Explanation + Diagram
+The app generates a clear explanation and a visual illustration using generative models
+
+Take the Quiz
+Answer auto-generated multiple choice questions to reinforce learning
+
+Download Report
+Export everything to a PDF or Markdown file for later review
+
+🔧 Technologies Used
+Gradio (UI)
+
+Google Gemini API (explanation from images + PDFs)
+
+Mistral via OpenRouter (text-based science explanations)
+
+Stable Diffusion FLUX (diagram generation)
+
+PDFPlumber + FPDF (report creation)
+
+Hugging Face Spaces (deployment)
+
+🔐 Environment Variables (set under Settings > Secrets)
+Make sure to add the following API keys as secrets in your Space:
+
+
+GEMINI_API_KEY
+OPENROUTER_API_KEY
+HF_TOKEN
+📝 License
+This project is licensed under the Apache 2.0 License.