HealthBuddy is an open-source project designed to provide users with a centralized platform for accessing detailed health-related information, including symptoms, precautions, medicines, and nearby hospital details. The project also features a personalized health report generation system.
In the realm of healthcare, obtaining comprehensive and easily accessible health-related information can be a challenging task. Recognizing this gap, HealthBuddy was developed as a solution to address the following real-world problems:
-
Fragmented Health Information: Vital health information is often scattered across various sources, making it cumbersome for individuals to gather complete details about their health concerns.
-
Lack of Personalized Health Insights: Many individuals struggle to receive personalized health insights and reports, tailored to their specific symptoms and conditions.
-
Difficulty in Locating Healthcare Facilities: Locating nearby hospitals and understanding their services can be challenging, especially during emergencies.
HealthBuddy bridges these gaps by providing a unified platform where users can seamlessly access detailed health information, receive personalized reports, and easily locate nearby healthcare facilities, thereby empowering individuals to make informed decisions about their well-being.
-
Symptom Analysis: Users can input symptoms to receive detailed reports about possible diseases along with precautions.
-
Hospital Locator: Find nearby hospitals with detailed information such as address, latitude, longitude, and distance.
-
Personalized Health Reports: Generate customized health reports based on user responses to specific questions, utilizing generative AI models.
- Frontend: Express, EJS pages
- Backend: API calls, Generative AI models (OpenAI, Google Gemini)
-
Installation:
npm install
-
Installation:
node index.js
-
Create a .env file
-
Open in Browser
-
User Registration:
- Provide health details and general information.
-
Symptom Analysis:
- Enter symptoms and click the analysis button for disease reports and precautions.
-
Personalized Reports:
- Answer a set of questions to generate a personalized health report.
-
Demo:
- Watch a demo of HealthBuddy in action on YouTube.
HealthBuddy welcomes and encourages contributions from the open-source community. Here's a guide on how you can contribute to the project:
-
Fork the Repository:
- Click on the "Fork" button on the top right of the HealthBuddy repository to create your fork.
-
Clone Your Fork:
- Clone the forked repository to your local machine using the following command:
git clone https://github.com/anirudh12032008/HealthBuddy.git
- Clone the forked repository to your local machine using the following command:
-
Create a Branch:
- Create a new branch for your contribution:
git checkout -b feature/your-feature-name
- Create a new branch for your contribution:
-
Code Away:
- Implement your changes or add new features.
-
Commit Changes:
- Commit your changes with clear and concise messages:
git commit -m "Add your meaningful commit message here"
- Commit your changes with clear and concise messages:
-
Push Changes:
- Push your changes to your fork on GitHub:
git push origin feature/your-feature-name
- Push your changes to your fork on GitHub:
-
Create a Pull Request:
- Navigate to the HealthBuddy repository on GitHub.
- Click on the "New Pull Request" button.
- Select the branch you just pushed and set up the pull request.
-
Describe Your Changes:
- Provide a clear and detailed description of your changes in the pull request.
-
Review Process:
- The maintainers will review your contribution and may provide feedback or request modifications.
-
Merge:
- Once approved, your pull request will be merged into the main branch.
- Follow the existing code style and guidelines used in the project.
- Check the project issues for tasks that need attention.
- If you plan to work on an existing issue, comment on it to let others know.
Thank you for considering contributing to HealthBuddy! Your efforts help make this project better for everyone. If you have any questions or need assistance, feel free to reach out to the project maintainers.
This project is licensed under the MIT License.
For any inquiries or suggestions, feel free to contact the project maintainers:
- Anirudh Sahu - GitHub Profile
- Project Issues