mgbam commited on
Commit
116042e
·
verified ·
1 Parent(s): 4484e38

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +116 -9
README.md CHANGED
@@ -10,14 +10,121 @@ pinned: false
10
  short_description: Research
11
  ---
12
 
13
- # 🧬 Ultimate AI-Powered Research MCP (Hugging Face Space)
 
14
 
15
- - 🔬 Unified search: arXiv, PubMed, UMLS, OpenFDA, OpenAI
16
- - 🧠 AI synthesis & Q&A: GPT-4o powered
17
- - 🩺 Biomedical enrichment: Drugs, CUIs, adverse events
18
- - 🚀 Plug-and-play: Add more APIs in minutes!
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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