README.md

metadata

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.

   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:

   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" 😉