{"id":19744834,"url":"https://github.com/manas1331/pesu_io_project","last_synced_at":"2026-04-14T23:33:36.545Z","repository":{"id":261981565,"uuid":"885890477","full_name":"manas1331/PESU_IO_Project","owner":"manas1331","description":"This is a general health chatbot which is built using Gemini model and it answers all health related queries asked by the user. Built using the concept of RAG, embeddings and LLM.","archived":false,"fork":false,"pushed_at":"2025-06-11T07:03:23.000Z","size":2261,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-21T06:03:54.469Z","etag":null,"topics":["chatbot","gemini","health","healthcare","llm","rag","streamlit"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/manas1331.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-11-09T16:59:06.000Z","updated_at":"2025-06-11T07:03:27.000Z","dependencies_parsed_at":"2024-11-09T18:17:40.975Z","dependency_job_id":"4bcaf5ae-966c-4cdc-a09a-12138ce5ccec","html_url":"https://github.com/manas1331/PESU_IO_Project","commit_stats":null,"previous_names":["manas1331/pesu_io_project"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/manas1331/PESU_IO_Project","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manas1331%2FPESU_IO_Project","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manas1331%2FPESU_IO_Project/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manas1331%2FPESU_IO_Project/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manas1331%2FPESU_IO_Project/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/manas1331","download_url":"https://codeload.github.com/manas1331/PESU_IO_Project/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manas1331%2FPESU_IO_Project/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279018306,"owners_count":26086334,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-14T02:00:06.444Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chatbot","gemini","health","healthcare","llm","rag","streamlit"],"created_at":"2024-11-12T02:00:59.965Z","updated_at":"2025-10-14T08:11:04.700Z","avatar_url":"https://github.com/manas1331.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PESU IO Course Project: Health Assistant Bot\n\n## Overview\nThis project is a Health Assistant Bot built using Google's Gemini model. It is part of the **PES University** (PESU) IO course. The bot provides assistance in health-related topics, offering actionable steps, health tips,location based services and factual information based on user queries. It also features a **Chatbot** page and an **FAQ** page displaying frequently asked questions related to health and wellness.**(Note this is not a replacement to a physician.)**\n\n### Features:\n- **Chatbot**: The chatbot interacts with users, answering health-related queries using the Gemini model. \n- **FAQ Page**: A page that displays frequently asked questions along with the bot’s responses.\n- **Health Tips**: Provides general health advice like hydration, diet, exercise, and mental well-being.\n- **Location-Based Services**: The bot can extract coordinates from user queries and help with location-based searches (e.g., nearby hospitals).\n\n## Installation\n\nTo set up the project on your local machine, follow these steps:\n\n### Prerequisites:\n- Python 3.x\n- Streamlit\n- `google-generativeai` library (for interacting with the Gemini model)\n- `llama-index` (for prompt management)\n\n### Step-by-Step Setup:\n\n1. Clone the repository:\n    ```bash\n    git clone https://github.com/\u003cyour-github-username\u003e/health-assistant-bot.git\n    cd health-assistant-bot\n    ```\n\n2. Install the required Python libraries:\n    ```bash\n    pip install -r requirements.txt\n    ```\n\n3. Set up your **Google Gemini API Key**:\n    - Create a project in the Google Cloud Console.\n    - Enable the Gemini API.\n    - Create an API key and store it in a safe place.\n    - Replace `\"YOUR_API_KEY\"` in the code with your actual API key.\n\n4. Run the Streamlit app:\n    ```bash\n    streamlit run home.py\n    ```\n\n5. Visit the app in your browser at `http://localhost:8501`.\n\n## Usage\n\nOnce the application is running, you can interact with the bot through the following pages:\n\n1. **Chatbot**: \n   - Ask health-related questions (e.g., \"How can I improve my diet?\" or \"What are some exercises for back pain?\").\n   - The bot will provide an AI-generated response using the Gemini model.\n\n2. **FAQ**:\n   - Common health queries will be displayed on the FAQ page, where users can find answers to frequently asked questions such as:\n     - \"How can I stay hydrated?\"\n     - \"What foods are good for immunity?\"\n     - \"How often should I exercise?\"\n\n3. **Location-Based Health Services**:\n   - You can provide a query with coordinates (e.g., \"(12.9716, 77.5946)\") to find nearby hospitals or health facilities.\n\n## Code Structure\n\n- `app.py`: Main Streamlit app for running the chatbot and FAQ pages.\n- `chatbot.py`: Handles the chatbot interactions and responses.\n- `faq.py`: Displays the FAQ section with predefined health-related questions and answers.\n- `home.py`: Helper functions for generating responses and handling user input.\n\n## Technologies Used\n\n- **Streamlit**: For building the interactive web application.\n- **Google Gemini**: For natural language processing and generating health-related responses.\n- **Python**: For backend functionality.\n- **Regular Expressions**: For extracting coordinates from user queries.\n\n## Contributing\n\n1. Fork the repository.\n2. Create a new branch for your feature or bug fix.\n3. Commit your changes.\n4. Push to your forked repository.\n5. Open a pull request.\n\n## License\n\nThis project is licensed under the MIT License.\n\n## Acknowledgments\n\n- Thanks to **Google Gemini** for providing the powerful generative model used in this project.\n- Special thanks to **PES University(PESU I/O)** for providing the opportunity to work on this project.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanas1331%2Fpesu_io_project","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmanas1331%2Fpesu_io_project","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanas1331%2Fpesu_io_project/lists"}