pritamdeka commited on
Commit
6eb5037
·
verified ·
1 Parent(s): 3358886

Update readme.md

Browse files
Files changed (1) hide show
  1. readme.md +32 -14
readme.md CHANGED
@@ -1,23 +1,41 @@
1
- # Biomedical Fact-Checking App (Hugging Face Spaces)
2
 
3
- This app:
4
- - Extracts key scientific claims from a news article,
5
- - Finds PubMed abstracts,
6
- - Checks for support/contradiction/neutral stance using advanced NLI,
7
- - Summarizes all evidence for each claim in plain English using an open-source LLM (Gemma-3B, fully local).
8
 
9
- ## How to use
10
 
11
- 1. **Add your `gemma-3b-it-Q4_K_M.gguf` (or smaller) to the repo root.**
12
- - Download from https://huggingface.co/unsloth/gemma-3n-E4B-it-GGUF.
13
- - Only Q4_K_M or Q4 quantizations will work on Spaces CPU.
 
14
 
15
- 2. **Deploy on Hugging Face Spaces** (SDK, CPU runtime).
16
 
17
- 3. **Enter a news URL, see the extracted claims, evidence, and summary verdicts!**
 
 
 
 
 
 
18
 
19
- **No OpenAI or cloud dependencies. All runs on CPU.**
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
20
 
21
  ---
22
 
23
- **Note:** First summarization may take 10–30s to load LLM, then faster.
 
1
+ # Biomedical News Fact-Checker & Research Evidence Finder
2
 
3
+ This app helps you understand if the scientific claims in health or biomedical news articles are supported by real research.
 
 
 
 
4
 
5
+ ## What does this app do?
6
 
7
+ - **Extracts key scientific claims** from a news article.
8
+ - **Finds the most relevant PubMed biomedical research papers** for each claim.
9
+ - **Checks which sentences in those papers support, contradict, or are neutral** to each claim (color-coded: green=support, red=contradict, gray=neutral).
10
+ - **Gives you a simple, plain-English summary** of the overall evidence for each claim.
11
 
12
+ ## How do I use it?
13
 
14
+ 1. **Paste the link to any health or biomedical news article** (for example, from Medical News Today or similar sites).
15
+ 2. **Click the submit/run button.**
16
+ 3. **Wait for the results** (this may take a minute, especially the first time you use the app).
17
+ 4. For each main claim in the article, you’ll see:
18
+ - A short summary verdict in plain language.
19
+ - A list of color-coded evidence sentences from research papers.
20
+ - The titles of the most relevant PubMed articles.
21
 
22
+ ## Who is this for?
23
+
24
+ - Curious readers, students, journalists, researchers, or anyone who wants to check if a news story’s science is backed up by real research.
25
+
26
+ ## What is special about this app?
27
+
28
+ - **No account, no sign-up, no private info required.**
29
+ - **No paid or cloud AI services:** Everything runs here using open-source AI.
30
+ - **Designed for health/biomedical news, but can work on most science articles.**
31
+
32
+ ## Try it out!
33
+
34
+ **Sample article you can use:**
35
+ https://www.medicalnewstoday.com/articles/omicron-what-do-we-know-about-the-stealth-variant
36
+
37
+ Paste this link in the app to see how it works!
38
 
39
  ---
40
 
41
+ Questions or feedback? You can find the code on Hugging Face Spaces.