Skip to content

Commit 7fd0e11

Browse files
Update README.md
1 parent b8c202a commit 7fd0e11

File tree

1 file changed

+31
-35
lines changed

1 file changed

+31
-35
lines changed

README.md

Lines changed: 31 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# 📘 InformaTruth: AI-Driven News Authenticity Analyzer
1+
# InformaTruth: AI-Driven News Authenticity Analyzer
22
InformaTruth is an end-to-end AI-powered multi-agent fact-checking system that automatically verifies news articles, PDFs, and web content. It leverages RoBERTa fine-tuning, LangGraph orchestration, RAG pipelines, and fallback retrieval agents to deliver reliable, context-aware verification. The system features a modular multi-agent architecture including Planner, Retriever, Generator, Memory, and Fallback Agents, integrating diverse tools for comprehensive reasoning.
33

44
It achieves ~70% accuracy and F1 ~69% on the LIAR dataset, with 95% query coverage and ~60% improved reliability through intelligent tool routing and memory integration. Designed for real-world deployment, InformaTruth includes a Flask-based responsive UI, FastAPI endpoints, Dockerized containers, and a CI/CD pipeline, enabling enterprise-grade automated fact verification at scale.
@@ -7,13 +7,13 @@ It achieves ~70% accuracy and F1 ~69% on the LIAR dataset, with 95% query covera
77

88
---
99

10-
## 🚀 Live Demo
10+
## Live Demo
1111

12-
🖥️ **Try it now**: [InformaTruth — Fake News Detection AI App](https://informatruth.onrender.com)
12+
**Try it now**: [InformaTruth — Fake News Detection AI App](https://informatruth.onrender.com)
1313

1414
---
1515

16-
## ⚙️ Tech Stack
16+
## Tech Stack
1717
| **Category** | **Technology/Resource** |
1818
| --------------------------- | ------------------------------------------------------------------------------------------------------ |
1919
| **Core Framework** | PyTorch, Transformers, HuggingFace |
@@ -38,47 +38,47 @@ It achieves ~70% accuracy and F1 ~69% on the LIAR dataset, with 95% query covera
3838

3939
---
4040

41-
## Key Features
41+
## Key Features
4242

43-
* **🔄 Multi-Format Input Support**
43+
* **Multi-Format Input Support**
4444
Accepts raw **text**, **web URLs**, and **PDF documents** with automated preprocessing for each type.
4545

46-
* **🧠 Full NLP Pipeline**
46+
* **Full NLP Pipeline**
4747
Integrates summarization (optional), **fake news classification** (RoBERTa), and **natural language explanation** (FLAN-T5).
4848

49-
* **🧱 Modular Agent-Based Architecture**
49+
* **Modular Agent-Based Architecture**
5050
Built using **LangGraph** with modular agents: `Planner`, `Tool Router`, `Executor`, `Explanation Agent`, and `Fallback Agent`.
5151

52-
* **📜 Explanation Generation**
52+
* **Explanation Generation**
5353
Uses **FLAN-T5** to generate human-readable, zero-shot rationales for model predictions.
5454

55-
* **🧪 Tool-Augmented & Fallback Logic**
55+
* **Tool-Augmented & Fallback Logic**
5656
Dynamically queries **DuckDuckGo** when local context is insufficient, enabling robust fallback handling.
5757

58-
* **🧼 Clean, Modular Codebase with Logging**
58+
* **Clean, Modular Codebase with Logging**
5959
Structured using clean architecture principles, agent separation, and informative logging.
6060

61-
* **🌐 Flask with Web UI**
61+
* **Flask with Web UI**
6262
User-friendly, interactive, and responsive frontend for input, output, and visual explanations.
6363

64-
* **🐳 Dockerized for Deployment**
64+
* **Dockerized for Deployment**
6565
Fully containerized setup with `Dockerfile` and `requirements.txt` for seamless deployment.
6666

67-
* **⚙️ CI/CD with GitHub Actions**
67+
* **CI/CD with GitHub Actions**
6868
Automated pipelines for testing, linting, and Docker build validation to ensure code quality and production-readiness.
6969

7070
---
7171

72-
## 📦 Project File Structure
72+
## Project File Structure
7373

7474
```bash
7575
InformaTruth/
7676
77-
├── .github/ # GitHub Actions
77+
├── .github/ # GitHub Actions
7878
│ └── workflows/
7979
│ └── main.yml
8080
81-
├── agents/ # Modular agents (planner, executor, etc.)
81+
├── agents/ # Modular agents (planner, executor, etc.)
8282
│ ├── executor.py
8383
│ ├── fallback_search.py
8484
│ ├── input_handler.py
@@ -159,7 +159,7 @@ InformaTruth/
159159

160160
---
161161

162-
## 🧱 System Architecture
162+
## System Architecture
163163
```mermaid
164164
graph TD
165165
A[User Input] --> B{Input Type}
@@ -191,7 +191,7 @@ graph TD
191191

192192
---
193193

194-
## 📊 Model Performance
194+
## Model Performance
195195
| Epoch | Train Loss | Val Loss | Accuracy | F1 | Precision | Recall |
196196
|-------|------------|----------|----------|--------|-----------|---------|
197197
| 1 | 0.6353 | 0.6205 | 0.6557 | 0.6601 | 0.6663 | 0.6557 |
@@ -204,7 +204,7 @@ graph TD
204204
205205
---
206206

207-
## 🐳 Docker Instructions
207+
## Docker Instructions
208208
### Step 1: Build Docker image
209209
```bash
210210
docker build -t informa-truth-app .
@@ -217,7 +217,7 @@ docker run -p 8501:8501 informa-truth-app
217217

218218
---
219219

220-
## ⚙️ CI/CD Pipeline (GitHub Actions)
220+
## CI/CD Pipeline (GitHub Actions)
221221
The CI/CD pipeline automates code checks, Docker image building, and Streamlit app validation.
222222

223223
### Sample Workflow
@@ -250,20 +250,16 @@ jobs:
250250
251251
---
252252
253-
## 🌐 Real-World Use Case
254-
* Journalists and media watchdogs
255-
* Educators and students
256-
* Concerned citizens and digital media consumers
257-
* Social media platforms for content moderation
253+
## **Developed By**
258254
259-
---
260-
261-
## 👤 Author
262255
**Md Emon Hasan**
263-
264-
🔗 [GitHub](https://github.com/Md-Emon-Hasan)
265-
🔗 [LinkedIn](https://www.linkedin.com/in/md-emon-hasan-695483237/)
266-
🔗 [Facebook](https://www.facebook.com/mdemon.hasan2001/)
267-
🔗 [WhatsApp](https://wa.me/8801834363533)
256+
257+
**WhatsApp:** [+8801834363533](https://wa.me/8801834363533)
258+
**GitHub:** [Md-Emon-Hasan](https://github.com/Md-Emon-Hasan)
259+
**LinkedIn:** [Md Emon Hasan](https://www.linkedin.com/in/md-emon-hasan-695483237/)
260+
**Facebook:** [Md Emon Hasan](https://www.facebook.com/mdemon.hasan2001/)
261+
262+
---
268263
269-
---
264+
## License
265+
MIT License. Free to use with credit.

0 commit comments

Comments
 (0)