Skip to content

Cybersoulja/Shealan

Repository files navigation

Senior Health Companion

Green Heart Version Platform

A specialized health management application designed specifically for African American seniors, featuring a culturally sensitive approach to diabetes tracking and management.

📱 Overview

Senior Health Companion provides a mobile-first, accessible platform for seniors to:

  • Track blood glucose readings with a simple, large-format interface
  • View health trends with easy-to-understand visualizations
  • Access culturally relevant nutrition and health guidance
  • Use voice commands for hands-free operation
  • Get personalized recommendations based on their data

✨ Features

📊 Health Tracking

  • Simple blood glucose entry with meal context
  • Visual indicators for readings above/below target ranges
  • Historical data visualization with trend analysis
  • Weekly and monthly averages to track progress

🍽️ Nutrition Guidance

  • Culturally relevant meal planning
  • Traditional African American cuisine adaptations for health
  • Seasonal food recommendations
  • Personalized nutrition advice

🔊 Accessibility

  • Voice navigation for hands-free operation
  • Large text and buttons designed for seniors
  • High contrast colors for better visibility
  • Simple, consistent navigation patterns

📚 Health Education

  • Diabetes management information specific to African American communities
  • Myth vs. fact education
  • Exercise recommendations appropriate for seniors
  • Community resource connections

🩺 Prediabetes Features (Coming Soon)

  • Risk assessment based on established guidelines
  • Early intervention recommendations
  • Personalized prevention strategies
  • Progress tracking for risk factors

📸 Screenshots

(Screenshots will be displayed here)

🛠️ Technical Details

Built with:

  • Python & Streamlit for the user interface
  • PostgreSQL database for secure data storage
  • PlotLy for interactive data visualizations
  • SpeechRecognition & pyttsx3 for voice interface

For detailed development information, see DEVELOPMENT.md

🚀 Getting Started

Prerequisites

  • Python 3.11+
  • PostgreSQL database
  • Required Python packages (see Installation)

Installation

  1. Clone this repository
git clone <repository-url>
  1. Install required packages
pip install -r requirements.txt
  1. Set up environment variables
export DATABASE_URL=postgresql://username:password@localhost:5432/diabetes_tracker
  1. Run the application
streamlit run app.py --server.port 5000

🤝 Contributing

Contributions to improve Senior Health Companion are welcome! Please read our Contributing Guidelines before submitting pull requests.

📝 License

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

💚 Acknowledgments

  • Dedicated to the strength and wisdom of our seniors
  • Inspired by the need for culturally sensitive health technology
  • Thanks to the African American health advocates who provided guidance

About

This is a health tracker app specializing in diabetes prevention, diabetes health and blood sugar monitoring.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors