🤖 Medibot: AI Health Assistant 🩺

📖 Table of Contents

• Overview
• Project Insights
• Features
• Tech Stack
• Project Structure
• Installation & Setup
• Future Advancements
• Roadmap
• Acknowledgments
• Contact
• How to Contribute
• Contributing
• Code of Conduct
• Contribution Guidelines
• Suggestions & Feedback
• Show Your Support
• License
• Stargazers
• Forkers
• Project Admin

An AI-Powered Health Assistant that provides users with health-related guidance, symptom analysis, and basic medical recommendations.

It uses rule-based logic and a RAG (Retrieval-Augmented Generation) pipeline powered by a Groq LLM. When rule-based response fails, RAG fetches data from trusted medical databases to provide relevant answers for unhandled queries.

⚠️ Disclaimer: This chatbot is not a replacement for professional medical advice. Always consult a qualified healthcare provider for serious or persistent health issues.

💡 Overview

Medibot bridges the gap between users and healthcare professionals by offering:

• Understanding of user health queries
• Symptom analysis with possible next steps
• Rule-based responses for common health questions
• AI-powered fallback responses using Groq
• Efficient medical data retrieval via FAISS-based database
• Doctor specialist recommendations based on symptoms/diseases
• A user-friendly Streamlit web interface

📊 Project Insights

🌟 Stars	🍴 Forks	🐛 Issues	🔔 Open PRs	🔕 Closed PRs	🛠️ Languages	👥 Contributors

🚀 Features

1. Symptom Checker - Check symptoms and answer health-related queries
2. Rule Based Response - Provides predefined answers for common health queries
3. RAG Fallback - Retrieves relevant details from the medical database when no rules match
4. Doctor Specialist Recommendation - Suggests specialists based on disease/symptom mapping

🌟 Exciting News...

🚀 This project is now an official part of GirlScript Summer of Code – GSSoC'25! 💃🎉💻 We're thrilled to welcome contributors from all over India and beyond to collaborate, build, and grow AI-health-chatbot! Let’s make learning and career development smarter – together! 🌟👨‍💻👩‍💻

👩‍💻 GSSoC is one of India’s largest 3-month-long open-source programs that encourages developers of all levels to contribute to real-world projects 🌍 while learning, collaborating, and growing together. 🌱

🌈 With mentorship, community support, and collaborative coding, it's the perfect platform for developers to:

• ✨ Improve their skills
• 🤝 Contribute to impactful projects
• 🏆 Get recognized for their work
• 📜 Receive certificates and swag!

🎉 I can’t wait to welcome new contributors from GSSoC 2025 to this AI-health-chatbot project family! Let's build, learn, and grow together — one commit at a time. 🔥👨‍💻👩‍💻

🧰 Tech Stack

• Streamlit – Interactive web app framework for the chatbot UI
• Python – Core programming language for backend logic
• LangChain – Orchestration framework for building the RAG pipeline
• Groq API – High-performance LLM used for natural language responses
• FAISS – Vector database for fast similarity search in retrieved documents
• Hugging Face Transformers – Embedding model for converting medical texts into vector representations

📂 Project Structure

AI-health-chatbot/
│   .gitignore
│   app.py                     # Main Streamlit application
│   chat_history_2025...txt    # Stored user chat history
│   CODE_OF_CONDUCT.md         # Contribution guidelines for behavior
│   CONTRIBUTING.md            # Steps for contributing to the project
│   LICENSE                    # MIT License
│   medical_agent.py           # AI agent logic for health queries
│   README.md                  # Project documentation
│   requirements.txt           # Python dependencies
│   ROADMAP.md                 # Future development plans
│   ✨ Add Web-Based Interface with Streamlit
│
├───Build
│       temp                   # Build-related files
│
├───DoctorSpecialistRecommend
│       Disease_Description.csv
│       doctor_spec.py         # Doctor recommendation logic
│       Doctor_Specialist.csv
│       Doctor_Versus_Disease.csv
│       Original_Dataset.csv
│
├───Medical_DataBase
│       index.faiss            # FAISS index for vector search
│       index.pkl              # Pickled embeddings

⚡ Installation & Setup

1️⃣ Clone the repository

git clone https://github.com/yourusername/AI-health-chatbot.git
cd AI-health-chatbot

2️⃣ Install dependencies

pip install -r requirements.txt

3️⃣ Set Environment Variables

GROQ_API_KEY=your_groq_api_key
HUGGINGFACE_API_KEY=your_api_key

4️⃣ Run the Streamlit app

python -m streamlit run WellnessResourceHub.py

🚀 Future Advancements

• Multi-language Support – Enable chatbot to respond in multiple languages for broader accessibility.
• Voice Input & Output – Add speech-to-text and text-to-speech for hands-free interaction.
• Conversational Memory – Enable LLM to remember previous interactions and maintain context.
• Mobile App Integration – Bring Medibot to Android/iOS platforms.

📌 Roadmap

See the ROADMAP.md for upcoming features and plans.

Issue Creation ✴

Report bugs and issues or propose improvements through our GitHub repository's "Issues" tab.

Contribution Guidelines 📑

• Firstly Star (⭐) the Repository
• Fork the Repository and create a new branch for any updates/changes/issue you are working on.
• Start Coding and do changes.
• Commit your changes
• Create a Pull Request which will be reviewed and suggestions would be added to improve it.
• Add Screenshots and updated website links to help us understand what changes is all about.

Contributing is fun🧡

We welcome all contributions and suggestions! Whether it's a new feature, design improvement, or a bug fix - your voice matters 💜

Your insights are invaluable to us. Reach out to us team for any inquiries, feedback, or concerns.

🙏 Acknowledgments

• Thanks to all contributors of this project
• Special shoutout to GirlScript Summer of Code (GSSoC’25) for the amazing community and support!
• Built with dedication, collaboration, and lots of chai

📞 Contact

• GitHub Issues: Report bugs or request features
• Email: Contact the maintainers for collaboration opportunities

Feel free to reach out with any questions or feedback!

🤝How to Contribute

We love contributions from the community! Whether it's a bug report, a new feature, or a documentation improvement, we appreciate your help.

How to Contribute

1. Fork the repository and create a new branch for your changes.
2. Make your changes and ensure everything is working as expected.
3. Submit a pull request with a clear description of your changes.

Found a Bug?

• Check the issue tracker to see if the bug has already been reported.
• If not, open a new issue and provide as much detail as possible.

Have a Feature Idea?

• We'd love to hear it! Open an issue to discuss your idea.

🤝 Contributing

We welcome contributions from developers of all skill levels! Here are some ways you can contribute:

Ways to Contribute

• 🐛 Bug fixes - Help us identify and fix bugs
• ✨ New features - Suggest and implement new functionality
• 📚 Documentation - Improve our docs and guides
• 🎨 UI/UX improvements - Make the platform more user-friendly
• 🔧 Performance optimizations - Help make AI-health-chatbot faster and more efficient
• 📱 Mobile responsiveness - Improve the mobile experience
• 🔒 Security enhancements - Help keep user data safe

Thank you to everyone who has made AI-health-chatbot better! 💚

📜 Code of Conduct

Please refer to the Code of Conduct for details on contributing guidelines and community standards.

🤝👤 Contribution Guidelines

We love our contributors! If you'd like to help, please check out our CONTRIBUTING.md file for guidelines.

Thank you once again to all our contributors who has contributed to AI-health-chatbot! Your efforts are truly appreciated. 💖👏

See the full list of contributors and their contributions on the GitHub Contributors Graph.

Show some by starring this awesome repository!

💡 Suggestions & Feedback

Feel free to open issues or discussions if you have any feedback, feature suggestions, or want to collaborate!

🙌 Show Your Support

If you find AI-health-chatbot project helpful, give it a star! ⭐ to support more such educational initiatives:

• ⭐ Starring the repository
• 🐦 Sharing on social media
• 💬 Telling your friends and colleagues
• 🤝 Contributing to the project

📄 License

This project is licensed under the MIT License - see the License file for details.

⭐ Stargazers

🍴 Forkers

🧑‍💻Project Admin:

Nayini Charitha Reddy

👨‍🏫Mentors – AI-health-chatbot (GSSoC'25)

Role	Name	GitHub Profile	LinkedIn Profile
Mentor 1	Anshi Agarwal	anshiagrawal22	anshiagrawal22

Give us a Star and let's make magic!

👨‍💻 Built with ❤️ by AI-health-chatbot Team

❤️ Nayini Charitha Reddy and Contributors ❤️

Open an Issue | 🌟 Star on GitHub

⬆️ Back to Top

Ready to show off your coding achievements? Get started with AI-health-chatbot today! 🚀