README.md

---
title: MedQA
emoji: 🏆
colorFrom: red
colorTo: yellow
sdk: streamlit
sdk_version: 1.45.1
app_file: app.py
pinned: false
license: mit
---
# Quantum Healthcare Navigator ⚕️🧠🔬

Welcome to the Quantum Healthcare Navigator, an AI-powered application designed for healthcare professionals. This Hugging Face Space demonstrates the integration of Large Language Models (LLMs), specialized medical information tools, and (simulated) quantum-inspired optimization for treatment suggestions.

## ✨ Features

*   **AI Consultation:** Interactive chat with an AI assistant.
*   **Medical Knowledge Access:** Tools for UMLS and BioPortal lookups.
*   **Quantum Treatment Optimizer:** (Simulated) Get suggestions for treatment plans based on patient data.
*   **User Authentication:** Secure login and signup.
*   **Session Management:** Chat history is saved per user session.
*   **PDF Reports:** Download consultation transcripts.
*   **Dockerized:** Easy to deploy and run locally.

## 📂 Project Structure
Use code with caution.
Markdown
quantum_healthcare_app/
├── app.py # Streamlit entrypoint
├── agent.py # LangChain agent setup
├── pages/ # Streamlit multipage views
│ ├── 1_Home.py
│ ├── 2_Consult.py
│ └── 3_Reports.py
├── tools/ # LangChain Tool wrappers
│ ├── init.py
│ ├── gemini_tool.py
│ ├── umls_tool.py
│ ├── bioportal_tool.py
│ └── quantum_tool.py
├── models/ # SQLModel definitions & DB init
│ ├── init.py
│ ├── db.py
│ ├── user.py
│ └── chat.py
├── services/ # Shared services (auth, logging, PDF)
│ ├── init.py
│ ├── auth.py
│ ├── logger.py
│ ├── metrics.py
│ └── pdf_report.py
├── clinical_nlp/ # Clinical‐NLP helpers
│ ├── init.py
│ └── umls_bioportal.py
├── quantum/ # Quantum optimizer stub
│ ├── init.py
│ └── optimizer.py
├── config/ # Configuration
│ └── settings.py
├── assets/ # Images, logos
│ ├── init.py
│ └── logo.png
├── Dockerfile
├── docker-compose.yml # For local development
├── requirements.txt
└── README.md
## ⚙️ Setup & Configuration

1.  **Clone the repository (if applicable) or create the files as listed.**
2.  **Create a `.env` file** in the root `quantum_healthcare_app/` directory based on `.env.example`. Populate it with your API keys and desired settings.
    ```env
    APP_TITLE="Quantum Healthcare Navigator"
    SECRET_KEY="your_very_secret_key"

    DATABASE_URL="sqlite:///./quantum_healthcare.db" # Default for HF Spaces

    OPENAI_API_KEY="sk-..."
    GEMINI_API_KEY="..."
    UMLS_API_KEY="..."
    BIOPORTAL_API_KEY="..."

    LOG_LEVEL="INFO"
    ```
3.  **Hugging Face Space Deployment:**
    *   Create a new Space on Hugging Face.
    *   Choose "Docker" as the Space SDK (or Streamlit and provide `requirements.txt`). Docker is recommended for this complexity.
    *   Upload your files.
    *   Go to "Settings" in your Space and add your `.env` variables as **Secrets**.
    *   The Space should build and run the `Dockerfile`.

## 🚀 Running Locally (using Docker)

1.  **Ensure Docker and Docker Compose are installed.**
2.  **Create and populate your `.env` file** as described above.
3.  **Build and run the application:**
    ```bash
    docker-compose up --build
    ```
4.  Open your browser and navigate to `http://localhost:8501`.

## 📝 Notes

*   The **Quantum Optimizer** is currently a stub. It simulates quantum processing but doesn't connect to actual quantum hardware.
*   **UMLS and BioPortal API** interactions are simplified. Real integration requires more robust error handling, authentication (e.g., UMLS Ticket Granting Tickets), and result parsing.
*   **Error handling and logging** are basic. Production systems would require more comprehensive strategies.
*   **Security:** While basic authentication is implemented, ensure all security best practices if deploying for wider use (e.g., HTTPS, input validation, dependency scanning).
*   This application is for **demonstration purposes only** and should not be used for actual medical decision-making.

---

"Built by the World's Greatest AI Engineer" 😉