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