ClinIQ is an evidence-first medical research discovery and summarization platform. It bridges the gap between raw medical literature (PubMed) and actionable clinical insights by using advanced AI and deterministic ranking algorithms.

• Intelligent Query Expansion: Automatically expands vague disease queries (e.g., "lung cancer") into comprehensive search terms covering treatments, clinical trials, and survival outcomes.
• Evidence Ranking Engine: A transparent scoring system that ranks papers based on publication recency, clinical intent, and relevance to the specific condition.
• Validated AI Summaries: Uses NVIDIA NIM (Llama 3.1 70B) to format complex research data into readable summaries.
• Hallucination Prevention: Features a built-in validation layer that rejects AI outputs if they mention papers or details not present in the original source data.
• Location-Aware Findings: Filters and prioritizes research relevant to specific geographic locations when provided.

• Framework: FastAPI (Python 3.12)
• AI Interface: NVIDIA NIM via AsyncOpenAI
• Data Source: PubMed E-Utils API
• Validation: Strict Pydantic-based data models

• Framework: React + Vite
• Styling: TailwindCSS
• Deployment: Vercel

• Python 3.12+
• Node.js 18+
• An NVIDIA NIM API Key

1. Navigate to the backend directory:

   cd backend

2. Create and activate a virtual environment:

   python -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. Install dependencies:

   pip install -r requirements.txt

4. Create a .env file:

   NVIDIA_NIM_API_KEY=your_key_here
   ALLOW_ORIGINS=http://localhost:5173

5. Run the server:

   uvicorn main:app --reload

1. Navigate to the frontend directory:

   cd frontend

2. Install dependencies:

   npm install

3. Create a .env file:

   VITE_API_URL=http://localhost:8000

4. Run the development server:

   npm run dev

1. Set the root directory to backend/.
2. Ensure NVIDIA_NIM_API_KEY and ALLOW_ORIGINS (your Vercel URL) are set in environment variables.
3. Railway will use the provided railway.json and runtime.txt for configuration.

1. Set the root directory to frontend/.
2. Add VITE_API_URL pointing to your Railway service.
3. Ensure the Build Command is npm run build and Output Directory is dist.

Distributed under the MIT License. See LICENSE for more information.