Update README.md
Browse files
README.md
CHANGED
|
@@ -10,14 +10,121 @@ pinned: false
|
|
| 10 |
short_description: Research
|
| 11 |
---
|
| 12 |
|
| 13 |
-
|
|
|
|
| 14 |
|
| 15 |
-
|
| 16 |
-
-
|
| 17 |
-
|
| 18 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 19 |
|
| 20 |
-
**Run locally:**
|
| 21 |
-
```bash
|
| 22 |
-
pip install -r requirements.txt
|
| 23 |
-
streamlit run app.py
|
|
|
|
| 10 |
short_description: Research
|
| 11 |
---
|
| 12 |
|
| 13 |
+
MedGenesis AI 🧬
|
| 14 |
+
Unified Biomedical Research Assistant—AI, Literature, Safety & Knowledge Graphs
|
| 15 |
|
| 16 |
+
🚀 Overview
|
| 17 |
+
MedGenesis AI is the next-generation biomedical research assistant that unifies PubMed, arXiv, UMLS, OpenFDA, and advanced AI (OpenAI GPT-4o) into one seamless platform.
|
| 18 |
+
Discover, synthesize, and visualize research, drugs, concepts, and safety—all in a single app.
|
| 19 |
+
|
| 20 |
+
Semantic search across top biomedical databases
|
| 21 |
+
|
| 22 |
+
UMLS concept mapping and standardization
|
| 23 |
+
|
| 24 |
+
Drug safety insights powered by OpenFDA
|
| 25 |
+
|
| 26 |
+
AI-powered summaries and follow-up Q&A
|
| 27 |
+
|
| 28 |
+
Interactive knowledge graph for instant relationship exploration
|
| 29 |
+
|
| 30 |
+
Export results as PDF or CSV
|
| 31 |
+
|
| 32 |
+
Workspace to save and revisit your research sessions
|
| 33 |
+
|
| 34 |
+
✨ Key Features
|
| 35 |
+
Unified Search: Find and aggregate results from PubMed and arXiv, ranked by semantic similarity.
|
| 36 |
+
|
| 37 |
+
Biomedical Concept Augmentation: Map results to UMLS concepts for standardized knowledge.
|
| 38 |
+
|
| 39 |
+
Drug & Safety Insights: Connect literature with latest FDA safety data.
|
| 40 |
+
|
| 41 |
+
AI-Powered Synthesis: Summarize, answer questions, and suggest next research steps using GPT-4o.
|
| 42 |
+
|
| 43 |
+
Knowledge Graph: Visual, interactive network of papers, drugs, and concepts.
|
| 44 |
+
|
| 45 |
+
Export & Workspace: Download data, save sessions, and organize your findings.
|
| 46 |
+
|
| 47 |
+
🖥️ Live Demo
|
| 48 |
+
Try the app on Hugging Face Spaces
|
| 49 |
+
|
| 50 |
+
🐳 Docker-Based Deployment
|
| 51 |
+
MedGenesis AI uses a Dockerfile for guaranteed reproducibility and robust dependency management.
|
| 52 |
+
|
| 53 |
+
Run Locally:
|
| 54 |
+
bash
|
| 55 |
+
Copy code
|
| 56 |
+
git clone https://huggingface.co/spaces/YOUR_SPACE_URL
|
| 57 |
+
cd YOUR_REPO
|
| 58 |
+
docker build -t medgenesis-ai .
|
| 59 |
+
docker run -p 7860:7860 medgenesis-ai
|
| 60 |
+
Then open http://localhost:7860 in your browser.
|
| 61 |
+
|
| 62 |
+
On Hugging Face Spaces:
|
| 63 |
+
Make sure your Dockerfile, requirements.txt, and app.py are present in your repo root.
|
| 64 |
+
|
| 65 |
+
Push all code to your Space.
|
| 66 |
+
|
| 67 |
+
In the Space settings, select "Docker" as the runtime.
|
| 68 |
+
|
| 69 |
+
Your Space will build and launch automatically.
|
| 70 |
+
|
| 71 |
+
⚡ Quick Start (Streamlit UI)
|
| 72 |
+
Enter a biomedical research question.
|
| 73 |
+
|
| 74 |
+
Click Run Search to query all sources.
|
| 75 |
+
|
| 76 |
+
Explore:
|
| 77 |
+
|
| 78 |
+
Results: Detailed, AI-synthesized findings.
|
| 79 |
+
|
| 80 |
+
Knowledge Graph: Interactive visualization.
|
| 81 |
+
|
| 82 |
+
Visualizations: Year histogram and more.
|
| 83 |
+
|
| 84 |
+
Download results or save to your workspace.
|
| 85 |
+
|
| 86 |
+
Ask follow-up questions with the integrated AI assistant.
|
| 87 |
+
|
| 88 |
+
🛠️ Customization
|
| 89 |
+
Add new data sources by extending mcp/ utilities.
|
| 90 |
+
|
| 91 |
+
Update color/theme in .streamlit/config.toml.
|
| 92 |
+
|
| 93 |
+
Want to run in SDK mode? Simply remove the Dockerfile and deploy with requirements.txt as usual.
|
| 94 |
+
|
| 95 |
+
Use the built-in workspace to organize your research projects.
|
| 96 |
+
|
| 97 |
+
🤝 Contributing
|
| 98 |
+
Pull requests, bug reports, and feature suggestions are welcome!
|
| 99 |
+
For large features, open an issue first to discuss your ideas.
|
| 100 |
+
|
| 101 |
+
🧑💻 Author
|
| 102 |
+
Oluwafemi Idiakhoa
|
| 103 |
+
|
| 104 |
+
📝 License
|
| 105 |
+
MIT License
|
| 106 |
+
|
| 107 |
+
❤️ Acknowledgments
|
| 108 |
+
Hugging Face Spaces
|
| 109 |
+
|
| 110 |
+
PubMed, arXiv, OpenFDA, UMLS
|
| 111 |
+
|
| 112 |
+
OpenAI GPT-4o
|
| 113 |
+
|
| 114 |
+
The open-source biomedical AI community
|
| 115 |
+
|
| 116 |
+
🔗 Links
|
| 117 |
+
MedGenesis AI Space
|
| 118 |
+
|
| 119 |
+
OpenFDA
|
| 120 |
+
|
| 121 |
+
UMLS
|
| 122 |
+
|
| 123 |
+
arXiv
|
| 124 |
+
|
| 125 |
+
PubMed
|
| 126 |
+
|
| 127 |
+
Note on Docker
|
| 128 |
+
If you’re using Docker, all dependencies (including Jinja2, pyvis) are installed as specified in the Dockerfile and requirements.txt—no extra setup needed.
|
| 129 |
+
If deploying with Hugging Face SDK mode, ensure your requirements.txt matches your dependencies.
|
| 130 |
|
|
|
|
|
|
|
|
|
|
|
|