AI-powered medical literature search across PubMed, ClinicalTrials.gov & Europe PMC
Medical Research is a web application designed for clinicians, oncologists, and medical researchers who need to quickly find, analyze, and synthesize scientific literature relevant to their patients.
Instead of manually searching multiple databases, copying results, and reading dozens of abstracts, Medical Research does it all in one click — powered by AI.
- Save hours of manual searching — simultaneously queries PubMed, ClinicalTrials.gov, and Europe PMC
- AI-powered analysis — every article is scored for relevance, evidence level, and article type
- Patient-specific results — attach a patient profile and get eligibility assessments for clinical trials
- Clinical synthesis — generates a structured evidence summary with therapeutic options and recommendations
- Multi-language — output in English, Italian, Spanish, French, or German
- Privacy-first — runs locally on your machine, your data stays with you
- Smart query planning — AI generates optimized search queries with MeSH terms for each database
- NCT ID detection — paste clinical trial IDs directly (e.g.,
NCT04497116) for instant lookup - Deduplication — automatically removes duplicate articles across databases
- Configurable results — choose 10, 20, 30, 50, 100, or all results
- Relevance scoring (0-100) for each article against your query
- Evidence level classification (L1 Meta-analysis → L5 Expert opinion)
- Article type detection (trial, review, meta-analysis, guideline, etc.)
- AI summaries of key findings in your chosen language
- Full-text analysis when available (via Europe PMC open access)
- Create patient profiles with diagnosis, mutations, treatments, and comorbidities
- Get eligibility assessments for clinical trials based on patient data
- Profiles are saved and reusable across searches
- Automated evidence-based synthesis report including:
- Key findings across all articles
- Therapeutic options with evidence levels
- Active clinical trials to consider
- Evidence gaps
- Clinical recommendations
- Suggested follow-up queries to deepen the research
- Interactive charts — relevance distribution, sources, evidence levels, eligibility
- Advanced filters — by source, evidence level, article type, eligibility, full-text, bookmarks
- Article notes & bookmarks — mark articles as important, reviewed, or dismissed
- Export — HTML report, RIS (Zotero/Mendeley), BibTeX (LaTeX)
- Search history with dashboard statistics
Choose the AI provider that best fits your needs:
| Provider | Best For | Cost |
|---|---|---|
| Claude (Anthropic) | Best accuracy and reasoning | Pay per use |
| OpenAI (GPT-4o) | Fast, widely available | Pay per use |
| Ollama (Local) | Privacy, no cost, medical models | Free (runs locally) |
Switch providers anytime from the Settings panel — no restart needed.
- Python 3.11+ — Download Python
- An AI provider (at least one):
- Claude API key, OR
- OpenAI API key, OR
- Ollama installed locally
git clone https://github.com/Pinperepette/Medical-Research.git
cd Medical-ResearchOr download and extract the ZIP file.
macOS / Linux:
python3 -m venv venv
source venv/bin/activateWindows:
python -m venv venv
venv\Scripts\activatepip install -r requirements.txtuvicorn app.main:app --host 0.0.0.0 --port 8000Go to http://localhost:8000
- Click the Settings button in the top bar
- Choose your provider (Claude, OpenAI, or Ollama)
- Enter your API key or configure your local model
- Click Test Connection to verify
- Click Save
That's it! You're ready to search.
- Go to console.anthropic.com
- Sign up or log in
- Go to API Keys → Create Key
- Copy the key (starts with
sk-ant-...) - Paste it in Settings → Claude → API Key
- Go to platform.openai.com
- Sign up or log in
- Go to API Keys → Create new secret key
- Copy the key (starts with
sk-...) - Paste it in Settings → OpenAI → API Key
Ollama lets you run AI models locally on your own machine — completely free and private. No data leaves your computer.
- Go to ollama.com and download for your OS
- Install and run it (it runs in the background)
Open a terminal and run:
# General purpose (fast, good quality)
ollama pull llama3
# Medical-specialized models (recommended for clinical use)
ollama pull medllama2
ollama pull OussamaELALLAM/MedExpertNote: Medical models may provide more accurate clinical assessments but are typically slower. General models like
llama3work well for most queries.
- Open Settings in the app
- Select Ollama
- Base URL:
http://localhost:11434(default) - Click the refresh button to see installed models
- Select your model and Save
Important: Ollama processes one request at a time. Analysis of many articles will take longer compared to cloud providers. This is normal.
- Be specific with queries — "EGFR exon 19 deletion NSCLC third-line after osimertinib" works better than "lung cancer treatment"
- Use patient profiles — adding patient details dramatically improves relevance scoring and enables eligibility assessment
- Paste NCT IDs — you can mix NCT IDs with free-text queries:
NCT04497116 NCT05071209 SETD2 thyroid cancer - Try suggested queries — after each search, the AI suggests follow-up queries to explore
- Export for your team — use the HTML report or citation export to share findings
- Backend: Python, FastAPI, SQLite
- Frontend: Vanilla HTML/CSS/JS, Chart.js
- AI: Anthropic Claude, OpenAI GPT, Ollama (local)
- Data Sources: PubMed (NCBI), ClinicalTrials.gov, Europe PMC
MIT License — free for personal and commercial use.
Built for clinicians, by developers who care about medical research.


