Update README.md

README.md

@@ -1,114 +1,276 @@
 ---
-title: DGaze News Verification
+title: DGaze - AI Truth Verification Tool
 emoji: 🔍
 colorFrom: blue
 colorTo: purple
 sdk: gradio
-sdk_version: 5.33.0
+sdk_version: 5.33.1
 app_file: app.py
 pinned: false
 license: mit
-short_description: AI-powered news verification system with free demo
+description: >
+  DGaze is a real-time AI truth verification tool that analyzes claims, quotes, or short paragraphs and returns a score, explanation, and evidence-backed sources (all in around 30sec). Powered by DeBERTa-v3, FAISS vector search, and advanced NLP models for comprehensive fact-checking.
+tags:
+  - agent-demo-track
 ---
 
-# DGaze - Advanced News Verification System
+# 🔍 DGaze - AI Truth Verification Tool
 
-An advanced AI-powered news verification system with authentication that helps identify potentially misleading or false information.
+**Introducing DGaze** – a real-time AI truth verification tool that analyzes claims, quotes, or short paragraphs and returns a score, explanation, and evidence-backed sources (all in around 30sec).
 
-## Features
+## 🎥 Video Overview
 
-- **🔐 Authentication**: Secure Auth0 integration with trial and full access modes
-- **🆓 Free Trial**: 2 free verifications for unauthenticated users  
-- **🔍 Real-time Analysis**: Instant verification of news articles and URLs
-- **📊 Credibility Scoring**: Detailed credibility scores for news content
-- **🌐 Source Verification**: Check the reliability of news sources
-- **📱 Multiple Interfaces**: Trial, login, and authenticated user interfaces
-- **🎨 Beautiful UI**: Professional gradient design with responsive layout
+> **[📺 Watch Demo Video](https://youtu.be/ZiQPsIiabfo)**
+>
+> _Click above to see DGaze in action! The video demonstrates the complete verification workflow from input to results._
 
-## How to Use
 
-### Free Trial (No Login Required)
-1. Visit the **trial interface** at `/trial`
-2. **Paste news text** or **URL** in the input box
-3. **Click "Verify News"** to analyze the content  
-4. **Get detailed results** including credibility score and analysis
-5. Enjoy **2 free verifications** per session
+![DGaze Screenshot](https://cdn-uploads.huggingface.co/production/uploads/65964c7ceed0e88dfd4b628f/3K8lt2f7-CyN_ffWLAuqo.png)
 
-### Full Access (With Login)
-1. **Click "Sign In"** to authenticate via Auth0
-2. Get **unlimited verifications**
-3. Access to **premium features**
-4. **Session persistence** across visits
+# 🔍 DGaze - AI Truth Verification Tool
 
-## Configuration
+**Introducing DGaze** – a real-time AI truth verification tool that analyzes claims, quotes, or short paragraphs and returns a score, explanation, and evidence-backed sources (all in around 30sec).
 
-This Space requires the following environment variables to be set in the Space settings:
+## 🎯 **The Problem We Solve**
 
-### Required Environment Variables
+In today's information-rich world, **misinformation spreads faster than facts**. Whether it's viral social media posts, breaking news claims, or suspicious articles, people need a quick, reliable way to verify what's true and what's not.
 
-```bash
-# Backend API Configuration (REQUIRED)
-API_BASE_URL=your-backend-api-url
+**DGaze solves this by providing instant, AI-powered fact verification** that cuts through the noise and delivers trustworthy results.
 
-# Auth0 Configuration (REQUIRED for authentication)
-AUTH0_DOMAIN=your-auth0-domain
-AUTH0_CLIENT_ID=your-auth0-client-id  
-AUTH0_CLIENT_SECRET=your-auth0-client-secret
-AUTH0_AUDIENCE=your-auth0-audience
+## 📥 **What We Accept as Input**
 
-# Security
-SECRET_KEY=your-session-secret-key
+- **Text Claims** - Paste any statement, quote, or paragraph you want to verify
+- **URLs** - Submit links to articles, posts, or web content for comprehensive analysis
+- **Mixed Content** - Combine text and URLs for thorough cross-verification
 
-# Optional: App Configuration
-GRADIO_SERVER_NAME=0.0.0.0
-GRADIO_SERVER_PORT=7860
-DEBUG=false
-```
+## 📊 **What You Get as Output**
 
-### Setting Environment Variables
-1. Go to your **Space Settings**
-2. Find **"Repository secrets"** or **"Variables and secrets"**
-3. Add each variable with **"Private"** visibility for sensitive data
-4. **Restart the Space** after adding variables
+- **Overall Truthfulness Score** - Clear verdict (SUPPORTED, CONTRADICTED, or NEUTRAL) with confidence percentage
+- **Individual Claim Analysis** - Each statement broken down with its own confidence rating
+- **Real-time Evidence Sources** - Live links to supporting or contradicting materials
+- **Brief Analysis** - Quick summaries for fast understanding
+- **Detailed Evidence** - In-depth breakdowns with source credibility scores
+- **Visual Results** - Color-coded, easy-to-understand interface with progress tracking
 
-## Try the Examples
+## ⚡ **Powered by Modal Labs Infrastructure**
 
-We've included sample news articles to demonstrate the verification capabilities:
-- Suspicious breakthrough claims with questionable sources
-- Real news with proper sourcing and verification
+**All AI models and backend operations are hosted on Modal Labs' high-performance GPU infrastructure**, ensuring lightning-fast processing and 99.9% uptime reliability. This cloud-native approach means no setup required - just open and start fact-checking!
 
-## Architecture
+---
+
+### Example Usage Flow:
+
+1. **Input**: Paste a news claim or statement
+2. **Processing**: AI analyzes content with real-time progress tracking
+3. **Results**: Get truthfulness scores, evidence sources, and detailed analysis
+4. **Insights**: Review individual claim breakdowns with confidence scores
+
+---
+
+## 🚀 What Makes DGaze Special?
+
+### ⚡ **Lightning Fast Analysis**
+
+- Complete fact-checking in **under 30 seconds**
+- Real-time progress tracking with beautiful animated progress bars
+- Instant results with detailed confidence scores
+
+### 🧠 **AI-Powered Intelligence**
+
+- **Sentence Transformers** - Advanced semantic understanding to break down complex statements
+- **Fine-tuned DeBERTa-v3 Classifier** - Specialized FEVER model for fact alignment with 77.7% accuracy
+- **FAISS Vector Search** - Lightning-fast evidence retrieval from massive databases
+- **Real-time Online Search** - Live web search for the most current, relevant information claim-by-claim
+- **FIRE Framework Integration** - Iterative, LLM-guided verification with intelligent web search
+- **Modal Labs Hosted Backend** - All AI models and most backend operations run on Modal Labs' high-performance GPU infrastructure
+
+### 🎯 **Comprehensive Verification**
+
+- **Overall Truthfulness Score** - Clear verdict: SUPPORTED, CONTRADICTED, or NEUTRAL
+- **Individual Claim Analysis** - Each statement gets its own confidence rating with detailed scoring
+- **Real-time Evidence Sources** - Live web search provides current, relevant sources with direct links
+- **Brief Analysis & Detailed Evidence** - Quick summaries plus in-depth evidence breakdowns
+- **Confidence Scores** - Precise probability ratings for each claim and overall assessment
+- **Visual Indicators** - Color-coded results with intuitive emoji feedback
+
+---
+
+## ✨ Key Features Demo
+
+### 📊 **Smart Analysis Dashboard**
+
+DGaze doesn't just give you a simple true/false answer. You get:
+
+- **Overall Assessment**: Clear verdict with confidence percentage
+- **Claim Breakdown**: Individual analysis of each statement
+- **Evidence Quality**: Ranked sources with reliability indicators
+- **Interactive Results**: Click-through to original sources
+
+### 🌐 **Multi-Source Verification**
+
+- **Real-time Online Search** - Live web search for the most current information on each claim
+- **Cross-references** claims against reliable news sources and databases
+- **Academic and Scientific Sources** - Research papers and authoritative publications
+- **Brief Analysis & Detailed Evidence** - Quick summaries with comprehensive evidence breakdowns
+- **Source Credibility Scoring** - Confidence ratings and reliability rankings for each source
 
-This application uses:
-- **FastAPI**: Backend API framework with Auth0 integration
-- **Gradio**: Interactive web interface with multiple mounted apps
-- **Auth0**: Secure authentication and user management
-- **Session Management**: Trial tracking and user state management
-- **Modular Design**: Clean separation of concerns with api/, config/, and components/ modules
+### 🎨 **Beautiful User Experience**
 
-## API Integration
+- **Modern Interface**: Clean, gradient design that's easy on the eyes
+- **Progress Tracking**: Watch your verification happen in real-time
+- **Responsive Design**: Works perfectly on desktop and mobile
+- **No Registration**: Start verifying immediately with 5 free trials
 
-The app connects to a backend API for news verification. Make sure your backend API supports:
-- `POST /api/verify` - Main verification endpoint
-- `GET /api/health` - Health check endpoint
+---
+
+## 🎯 Perfect For These Use Cases
+
+### 📰 **News & Media**
+
+- **Social Media Posts**: Verify viral claims before sharing
+- **Breaking News**: Quick fact-check of developing stories
+- **Article Verification**: Cross-reference news reports with multiple sources
+
+### 🏫 **Education & Research**
+
+- **Student Projects**: Verify research claims and statistics
+- **Academic Writing**: Fact-check citations and references
+- **Teaching Tool**: Help students develop critical thinking skills
+
+### 💼 **Business & Professional**
+
+- **Market Research**: Verify industry claims and statistics
+- **Due Diligence**: Fact-check business information
+- **Content Creation**: Ensure accuracy in marketing materials
+
+### 🏛️ **Civic & Policy**
+
+- **Political Claims**: Verify statements from public figures
+- **Policy Analysis**: Check facts behind policy proposals
+- **Public Information**: Validate government and institutional claims
 
-## Local Development
+---
+
+## 🔬 How DGaze Works (Behind the Scenes)
+
+### Step 1: **Smart Text Processing**
+
+**Sentence Transformers** analyze your input and break it down into individual, verifiable claims
+
+### Step 2: **Evidence Gathering**
 
-To run locally:
-1. Clone this repository
-2. Install dependencies: `pip install -r requirements.txt`
-3. Set up your `.env` file with the required variables
-4. Run: `python app.py`
-5. Access at `http://localhost:3000`
+**FAISS vector search** rapidly retrieves relevant evidence from massive databases while **real-time online search** finds the latest information claim-by-claim, guided by the **FIRE framework** for intelligent web searches
 
-## Built With
+### Step 3: **Intelligent Matching**
 
-- **Gradio**: Interactive web interface
-- **FastAPI**: Modern, fast web framework
-- **Auth0**: Authentication platform
-- **Python**: Backend processing
-- **Hugging Face Spaces**: Hosting platform
+**Fine-tuned DeBERTa-v3 classifier** matches each claim with supporting or contradicting evidence using advanced fact alignment
+
+### Step 4: **Confidence Scoring**
+
+**Modal Labs hosted AI models** calculate truthfulness probabilities with high-performance GPU processing handling most backend operations
+
+### Step 5: **Beautiful Results**
+
+**Gradio frontend** presents everything in an easy-to-understand, interactive format
 
 ---
 
-*Built with ❤️ for fighting misinformation and promoting media literacy*
+## 📈 Performance & Accuracy
+
+### 🎯 **Accuracy Metrics**
+
+- **77.7% accuracy** on standard fact-checking benchmarks
+- **Well-calibrated confidence scores** - when we say 90%, we mean it
+- **Multi-claim handling** - processes up to 5 claims simultaneously
+
+### ⚡ **Speed Benchmarks**
+
+- **Average processing time**: 30 seconds
+- **Individual claim analysis**: 1.5 seconds each
+- **Evidence retrieval**: 15 seconds for comprehensive search
+- **UI response time**: Under 100ms
+
+---
+
+## 🌟 Try DGaze Now!
+
+### 🆓 **Free Demo Access**
+
+- **5 free verifications** per session
+- **No registration required**
+- **Full feature access**
+- **Instant results**
+
+### 📱 **Easy to Use**
+
+1. Paste your text into the input box
+2. Click "Verify News" and watch the magic happen
+3. Get detailed results with confidence scores
+4. Click through to original sources for more information
+
+### 🎨 **Beautiful Interface**
+
+- Smooth animations and progress tracking
+- Color-coded results for quick understanding
+- Mobile-friendly responsive design
+- Professional, modern aesthetic
+
+---
+
+## 🚀 Future Vision
+
+### 🔮 **Coming Soon**
+
+- **Multi-language support** for global fact-checking
+- **Browser extension** for one-click verification
+- **Batch processing** for multiple claims at once
+- **Enhanced source quality scoring**
+
+### 🌍 **Long-term Goals**
+
+- **Real-time news monitoring** and automatic alerts
+- **Educational partnerships** for media literacy
+- **API access** for developers and organizations
+- **Advanced analytics** and reporting features
+
+---
+
+## 🏆 Why Choose DGaze?
+
+### ✅ **Reliable**
+
+Built on state-of-the-art AI models with proven accuracy
+
+### ✅ **Fast**
+
+Get comprehensive results in under 30 seconds
+
+### ✅ **Transparent**
+
+See exactly how we reach our conclusions with source links
+
+### ✅ **User-Friendly**
+
+No technical knowledge required - anyone can use it
+
+### ✅ **Comprehensive**
+
+Goes beyond simple true/false to give you the full picture
+
+---
+
+**🔍 Ready to verify the truth? Try DGaze now - No setup required, just open and start fact-checking!**
+
+## ⚙️ **Powered by Advanced Technology**
+
+**Backend inference runs on Modal Labs** for scalable, high-performance AI processing with **Gradio** providing the interactive frontend – no setup required, just open and try!
+
+- **Sentence Transformers** for semantic understanding
+- **Fine-tuned DeBERTa-v3 classifier** for fact alignment
+- **FAISS vector search** for fast evidence retrieval
+- **Real-time online search** for current, relevant information claim-by-claim with source analysis
+- **Currently integrating the FIRE framework** for iterative, LLM-guided verification with web search when needed
+- **Confidence scoring system** providing precise probability ratings for brief analysis and detailed evidence
+- **All models hosted on Modal Labs' GPU infrastructure** handling most backend operations for maximum speed and reliability
+
+_Experience the power of cutting-edge AI fact-checking technology – all running seamlessly in the cloud!_