Skip to content

README.md

Latest commit

 

History

History
55 lines (42 loc) · 2.02 KB

README.md

File metadata and controls

55 lines (42 loc) · 2.02 KB

🏥 Health Assistant Dashboard

A Streamlit-based web application for tracking health symptoms, analyzing severity, and consulting with a safety-focused AI assistant.

🚀 Features

  • Symptom Logging: Log symptoms and track health history.
  • Severity Dashboard: Real-time visualization of symptom severity (Low/Medium/High).
  • AI Consultation: Chat with an AI assistant powered by OpenRouter (Llama 3.1).
  • Medical Safety: Built-in guardrails to prevent definitive diagnoses and ensure professional consultation suggestions.

🛠️ Local Deployment

1. Prerequisites

Ensure you have Python 3.8+ installed on your system.

2. Clone or Copy Files

Make sure the following files are in your project directory:

  • app.py: The main UI.
  • logic.py: The core logic and API integration.
  • requirements.txt: Project dependencies.

3. Install Dependencies

Open your terminal in the project directory and run:

pip install -r requirements.txt

4. Configure OpenRouter API Key

The application requires an OpenRouter API key for the AI Consultation tab.

  1. Open logic.py.
  2. Locate the following line (around line 7): 
    OPENROUTER_API_KEY = "sk-or-v1-..."
  3. Replace the placeholder string with your actual OpenRouter API Key.
  4. Save the file.

5. Run the Application

Start the Streamlit server with:

python -m streamlit run app.py

The app will automatically open in your default browser at http://localhost:8501.

⚠️ Important Disclaimer

This application is for informational purposes only. It is not a substitute for professional medical advice, diagnosis, or treatment. Always seek the advice of your physician or other qualified health provider with any questions you may have regarding a medical condition.

📦 Tech Stack