Skip to content

Korags05/Healyks

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

41 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Healyks: AI-Powered Rural Healthcare Assistant

Healyks_Logo

๐ŸŒ Project Overview

Healyks is an innovative Android application designed to address healthcare access challenges in underserved communities. By leveraging AI technologies and mobile accessibility, the app provides comprehensive health support for rural and resource-limited areas.

๐Ÿš€ Key Features

1. AI-Powered Symptom Checker

  • Analyze symptoms using Google Gemini API
  • Provide personalized health recommendations

2. Medication Management

  • Create personalized medication reminders
  • Offline notification support
  • Easy scheduling and tracking

3. Health Education

  • Preventive health content
  • Simplified health information
  • Accessible on dashboard

4. Emergency First-Aid Guidance

  • Step-by-step emergency instructions
  • Offline access to critical information
  • Quick emergency service contact options

5. Periods and Ovulation Tracker

  • Menstrual cycle tracking
  • Next period prediction
  • Fertility window identification

๐Ÿ›  Technology Stack

  • Frontend: Android (Jetpack Compose)
  • Backend: Express.js
  • Database: MongoDB
  • AI Integration: Google Gemini API
  • Authentication: Firebase Authentication
  • Deployment: AWS EC2

๐ŸŒฑ Problem Statement

Addressing the lack of healthcare access in underserved communities by providing a comprehensive, user-friendly mobile health assistant.

๐Ÿ”ง Setup and Installation

Prerequisites

  • Android Studio
  • Firebase Account

Clone the Repository

git clone https://github.com/Korags05/Healyks.git
cd Healyks

Configure Firebase

  1. Add google-services.json to the app directory
  2. Set up Firebase Authentication
  3. Configure Gemini API credentials

Environment Configuration

  1. Create/Update local.properties file in the root directory with: properties BASE_URL = "http://ec2-13-232-188-167.ap-south-1.compute.amazonaws.com:5000/" FIREBASE_TOKEN = "your_firebase_server_key"

Build and Run

  1. Open the project in Android Studio
  2. Sync Gradle dependencies
  3. Run the application on an emulator or physical device

๐Ÿ“ฆ API Endpoints

  • Authentication
  • Symptom Analysis
  • Health Education
  • User details POST and GET

๐Ÿ”ฎ Future Roadmap

  • Multi-language support
  • Doctor and enterprise level dashboards
  • Community health forums
  • Advanced personalized health plans

๐Ÿ‘ฅ Contributing

We welcome contributions from developers, designers, healthcare professionals, and anyone passionate about improving healthcare access! Whether you're fixing bugs, adding features, improving documentation, or suggesting ideas, your help is valuable.

Quick Start

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'feat: add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Ways to Contribute

  • ๐Ÿ› Report bugs or suggest features via Issues
  • ๐Ÿ’ป Submit code improvements or new features
  • ๐Ÿ“– Improve documentation and add examples
  • ๐ŸŒ Add translations for regional languages
  • โœ… Write tests to improve code quality
  • ๐ŸŽจ Design UI/UX improvements

Please read our CONTRIBUTING.md for detailed guidelines on:

  • Development setup
  • Coding standards
  • Pull request process
  • Bug reporting
  • Feature requests

Code of Conduct

We're committed to providing a welcoming and inclusive environment. Please be respectful and constructive in all interactions.

๐Ÿ“ž Contact

Project Lead: Kunal Saha

๐Ÿ† Acknowledgements

  • Google for Gemini API
  • Firebase Authentication
  • Android Development Community

Screenshots

dashboard

ProfileDashboard

analyze1

analyze2

educationalItems1

FirstAid1

FirstAid2

PeriodTracker1

PeriodTracker2

PeriodTracker3

About

๐ŸŒ AI-Powered Healthcare for Underserved Communities | Android app with symptom analysis, periods and ovulation tracker, medication reminders, health education & emergency guidance | Built with Jetpack Compose & Google Gemini API | Open-Source

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages