HealthGuard AI

HealthGuard is a full-stack, AI-powered health monitoring application. It allows users to securely track their symptoms, receive intelligent lifestyle enhancement plans, and scan medical reports to automatically extract and analyze data.

Architecture & Tech Stack

The architecture is split into three robust tiers:

1. Frontend: React (Vite) + TailwindCSS
2. Backend (API & Auth): Node.js + Express + MongoDB
3. AI Engine (OCR & Inference): Python + FastAPI + PyTesseract + Fireworks AI

The Node.js backend handles all standard authorization routing, and natively proxies AI requests seamlessly to the local Python FastAPI server to leverage Python's rich ecosystem for document parsing and OCR.

Getting Started

1. Prerequisites

• Node.js (v18+)
• Python (v3.10+)
• Tesseract OCR (e.g., brew install tesseract on Mac or apt-get install tesseract-ocr on Linux)
• MongoDB Database (Local or Atlas)
• Fireworks API Key

2. Environment Setup

Copy the .env.example files in each sub-directory to .env and fill in your credentials:

• Health_Gaurd-Frontend/.env
• Health_Gaurd-Backend/.env
• Server/.env

(Note: The Node.js backend features an Offline Mode. If MongoDB is unavailable or fails to connect, it will gracefully fall back to an in-memory database allowing you to easily test the AI features without a persistent database!)

3. Running the App

We've provided a simple bash script to boot the entire stack consistently:

chmod +x start.sh
./start.sh

This starts:

• React Frontend on port 5173
• Node.js Proxy on port 8080
• Python FastAPI on port 5500

Press Ctrl+C in the terminal to gracefully terminate all 3 apps simultaneously.