Skip to content

TheAgencyMGE/Healthwise-AI

Repository files navigation

HealthWise AI - Advanced Medical Assessment Platform

React TypeScript Tailwind CSS Vite

A revolutionary healthcare platform that combines early detection, provider connectivity, and personalized health insights through AI-powered medical analysis.

✨ Features

🔍 AI-Powered Symptom Checker

  • Advanced symptom analysis using Google Gemini AI
  • Comprehensive health assessments with personalized recommendations
  • Interactive symptom input with severity and duration tracking
  • Intelligent preliminary diagnosis suggestions

📊 Risk Assessment Tools

  • Personalized health risk evaluation
  • Early detection screening for common conditions
  • Lifestyle and demographic factor analysis
  • Preventive care recommendations

📋 Comprehensive Health Reports

  • Detailed health assessment summaries
  • Provider-ready medical reports
  • Historical health tracking
  • Actionable health insights

🏥 Provider Tools Integration

  • Healthcare provider dashboard
  • Patient data analysis tools
  • Assessment history tracking
  • Professional medical reporting

🎯 Personalized Health Insights

  • AI-driven health recommendations
  • Lifestyle modification suggestions
  • Preventive care planning
  • Health goal tracking

🚀 Getting Started

Prerequisites

  • Node.js (v18 or higher)
  • npm or yarn package manager
  • Google Gemini API key

Installation

  1. Clone the repository

    git clone https://github.com/TheAgencyMGE/vitalwise-ai-scan.git
    cd vitalwise-ai-scan
  2. Install dependencies

    npm install
  3. Set up environment variables Create a .env file in the root directory:

    VITE_GEMINI_API_KEY=your_gemini_api_key_here
  4. Start the development server

    npm run dev
  5. Open your browser Navigate to http://localhost:5173 to view the application.

🛠️ Technology Stack

  • Frontend Framework: React 18 with TypeScript
  • Build Tool: Vite
  • Styling: Tailwind CSS with shadcn/ui components
  • AI Integration: Google Gemini AI API
  • Icons: Lucide React
  • Routing: React Router DOM
  • State Management: React Hooks
  • Type Safety: TypeScript

📱 Key Pages & Components

Core Pages

  • Home: Landing page with feature overview and quick access
  • Symptom Checker: Interactive AI-powered symptom analysis
  • Risk Assessment: Comprehensive health risk evaluation
  • Health Report: Detailed assessment results and recommendations
  • Provider Tools: Healthcare professional dashboard

Reusable Components

  • Medical Card: Stylized cards for health information display
  • Medical Button: Healthcare-themed interactive buttons
  • 3D Heart: Animated heart component for visual appeal
  • Glass AI Checker: Modern glass-morphism symptom input interface

🔒 Privacy & Security

  • Data Protection: All health data is processed securely
  • HIPAA Compliance: Following healthcare data protection standards
  • No Data Storage: Assessments are processed in real-time without permanent storage
  • API Security: Environment-based API key management

⚠️ Medical Disclaimer

IMPORTANT: HealthWise AI is designed for informational and educational purposes only. This platform should not replace professional medical advice, diagnosis, or treatment. Always consult with qualified healthcare professionals for medical concerns. In case of emergency, contact emergency services immediately.

🚀 Deployment

The application can be deployed on various platforms:

  • Vercel: Optimized for React applications
  • Netlify: Easy deployment with environment variable support
  • AWS: Scalable cloud deployment
  • Docker: Containerized deployment option

🤝 Contributing

We welcome contributions to improve HealthWise AI! Please follow these steps:

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

📄 License

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

🆘 Support

For support and questions:

  • Create an issue on GitHub
  • Contact the development team
  • Review the documentation

Made with ❤️ by TheAgencyMGE

Empowering better health decisions through AI-powered medical insights.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages