๐Ÿ›ก๏ธ TrustMeter

Your Real-Time Guardian Against Misinformation

AI-Powered Browser Extension for Truth & Transparency Across the Web

TrustMeter combines 5 AI models, and semantic caching to verify text, detect fake images, and score website credibility โ€” instantly.

๐Ÿค– Gemini AI ๐Ÿง  Vertex AI ๐Ÿ” Google Vision โœ… Fact Check API โšก Pinecone Cache โšก Firestore Cache

โš™๏ธ Multi-Layer AI Pipeline

Every verification request flows through multiple AI systems for maximum accuracy

๐Ÿ“

Input

Text/Image/URL

โ†’
โšก

Multi-Tier Cache

Pinecone + Firestore

โ†’
๐Ÿค–

Multi Tier Information Analysis Pipleine

Fact check API + Custom search + Vertex AI Model + Gemini and More

โ†’
๐ŸŽฏ

Final Score

Trust Rating

๐ŸŽฏ Our Mission

We believe truth should be accessible to everyone. TrustMeter brings enterprise-grade fact-checking, image verification, and credibility scoring right into your browser โ€” making safe and informed browsing effortless.

๐ŸŽฌ See TrustMeter in Action

๐Ÿ“ Text Verification

Instantly detect misleading claims using AI ensemble: Gemini AI, Vertex AI ML, and Google Fact Check.

๐Ÿ–ผ๏ธ Image Authenticity

Detect fake or AI-generated visuals using Google Cloud Vision and custom Vertex AI models.

๐ŸŒ Trust Score

Get instant credibility scores for any website using Firestore domain scoring and semantic evidence matching.

๐Ÿ’Ž Core Features

๐Ÿš€

Real-Time Analysis

Accurate verification powered by async parallel processing, Pinecone + Firestore caching, and concurrent API calls across all verification systems.

๐Ÿง 

Multi-Model AI Ensemble

Combines 6 systems: Gemini 2.5 Flash (primary reasoning), Vertex AI (ML classification), Google Vision API (image analysis), Fact Check API, Sentence Transformers (semantic matching), and Google Custom Search.

๐Ÿ”

Evidence-First Verification

Real-world corroboration > ML predictions. System prioritizes professional fact-checks and multi-source evidence.

๐Ÿ‘ฅ

Community-Driven Credibility

User feedback weighted by unique user counts and stored in Pinecone with 15-day auto-expiry. Firestore tracks domain reputation with rolling averages based on verification outcomes, hence making the system more accurate over time.

โšก

Caching

SHA-256 hash match โ†’ Semantic similarity โ†’ 'Known fake' database. Pinecone vectors expire after 15 days; scoring weighted by unique user confirmations of similar news.

๐ŸŒ

Dynamic Domain Scoring

Firestore-powered credibility database that updates in real-time. Domains earn reputation through verification results. High-trust sources (90%+ score, 100+ votes) receive confidence bonus.

๐Ÿ”„

Parallel Processing Pipeline

5-phase async architecture: Fact-check + metadata extraction โ†’ Vertex AI + corroboration โ†’ Multi-claim analysis โ†’ Ensemble scoring โ†’ Dual storage (Firestore + Pinecone).

๐Ÿ“Š

Adaptive Ensemble Logic

Weighted scoring system: Professional fact-checks override ML predictions. Evidence count scales confidence. Context-aware temporal validation.

๐Ÿ–ผ๏ธ

Multi-Modal Analysis

Separate image verification pipeline using Google Vision API for reverse image search, metadata extraction, Vertex AI image analysis with Gemini Fallback hence providing visual content analysis.

๐ŸŽฏ

Content Type Detection

Intelligent pre-filtering distinguishes factual claims from opinions, personal stories, satire, questions and promotional content. Returns "Not Applicable" for non-verifiable content types.

๐Ÿ”—

Semantic Query Expansion

Reformulating claims into alternate phrasings for comprehensive search coverage. Combined with keyword extraction for maximum evidence discovery.

โฑ๏ธ

Temporal Context Awareness

System evaluates claims against current date context. Distinguishes between timeless facts and time-sensitive events.

๐Ÿ”ง How It Works

1๏ธโƒฃ Detect

Extension monitors the webpage for text, images, and links that may need verification.

2๏ธโƒฃ Cache Check

The Cache is checked for similar content that was recently verified.

3๏ธโƒฃ Multi-Step Analysis

If not cached, run parallel analysis through Gemini, Vertex AI, Vision API, Fact Check API, Custom search corroboration and much more.

4๏ธโƒฃ Corroboration

Search trusted sources using Google Custom Search with dynamic keyword extraction via Gemini.

5๏ธโƒฃ Ensemble Scoring

Weighted combination: Gemini + Vertex AI + Fact Check + Custom search produces final verdict.

6๏ธโƒฃ Explain & Cache

Results displayed with transparent reasoning. Stored in Pinecone and Firestore for future queries.

๐ŸŒŸ Why It Matters

Misinformation affects daily decisions, from what we buy to what we believe. By putting AI-powered truth verification directly into your browser, TrustMeter builds a safer digital world where information is Trustworthy, Verifiable, and Transparent.

Why TrustMeter?

The misinformation crisis demands intelligent, real-time solutions

The Growing Crisis

In today's digital landscape, misinformation spreads faster than ever before. Deepfakes, manipulated images, and biased narratives are increasingly difficult to detect.

64%
of people struggle to identify fake news
3.2B
fake news articles shared annually
6x
faster spread rate for false information
60%
of deepfake images are undetected

โš ๏ธ Key Challenges

๐Ÿ“š

Information Overload

With billions of posts shared daily, manually fact-checking every claim is impossible for the average user.

๐ŸŽญ

Sophisticated Manipulation

AI-generated deepfakes and edited media are becoming indistinguishable from authentic content.

โšก

Speed of Misinformation

False information spreads 6 times faster than the truth on social media platforms.

๐ŸŽฏ

Targeted Deception

Algorithms amplify misleading content, creating echo chambers and reinforcing biases.

๐Ÿ”

Lack of Transparency

Users often lack context about source credibility and content authenticity.

โฑ๏ธ

Complex Verification

Traditional fact-checking is time-consuming and doesn't scale for real-time browsing.

๐Ÿ’ก Our Solution

TrustMeter brings enterprise-grade verification tools directly to your browser, empowering you to make informed decisions in real-time without the need for manual fact-checking.

Our system works like having a team of expert fact-checkers analyzing every piece of content you seeโ€”except it happens instantly. By combining multiple AI models with professional fact-checking databases and real-world evidence from credible sources, TrustMeter delivers accurate verdicts in seconds, not hours. The platform doesn't just tell you if something is misleading; it explains why with clear reasoning, provides links to supporting evidence, and shows you the credibility of the sources involved. As users interact with the system and verification results accumulate, TrustMeter continuously learns and improves, building a comprehensive reputation database for news sources and content patterns. Whether you're scrolling through social media, reading news articles, or encountering viral images, TrustMeter acts as your intelligent companionโ€”protecting you from misinformation while helping you understand the truth behind the headlines.

๐Ÿ—๏ธ System Architecture

Built on robust, scalable technology for reliable verification

๐Ÿ› ๏ธ Built With

TrustMeter combines cutting-edge AI technology with enterprise-grade infrastructure for reliable, real-time verification

๐ŸŽจ Frontend

Chrome Extension - Manifest V3 with content scripts, popup UI, background service workers, and real-time DOM analysis

โš™๏ธ Backend

Flask API - Async Python backend with ThreadPoolExecutor, parallel processing pipelines, and RESTful endpoints

๐Ÿค– AI & ML Models

Gemini 2.5 Flash (reasoning & structured analysis)
Vertex AI (custom text classification)
Google Vision API (image features verification)
Sentence Transformers (semantic embeddings)

๐Ÿ’พ Database Infrastructure

Pinecone - Vector database for semantic caching, similarity search, and 15-day auto-expiry
Firestore - NoSQL document store for domain reputation, user feedback, and metadata

๐Ÿ” Verification APIs

Google Fact Check Tools API - Professional fact-check aggregation
Google Custom Search API - Evidence corroboration and source discovery

๐Ÿ“ฆ Key Libraries

sentence-transformers - all-MiniLM-L6-v2 for text embeddings
google-generativeai - Gemini SDK
aiohttp - Async HTTP client
python-dotenv - Environment configuration

โšก Performance Optimization

LRU Caching - In-memory embedding cache (8192 items)
Async/Await - Concurrent API calls with asyncio.gather()

๐Ÿ”„ Data Flow

Step 1: Content Detection

Extension monitors webpage for text, images, and links. User triggers verification via context menu or button click.

Step 2: Cache Check

Pinecone semantic search and firestore queries for similar content. If found with similarity(cosine and verified fakes search) and user confirmation, return cached result.

Step 3: AI Analysis

If cache miss, trigger parallel processing: Gemini extracts metadata, Vertex AI classifies, Vision analyzes images.

Step 4: Fact Check

Google Fact Check API searches for professional fact-checker ratings and information. Gemini refines claim for better matching.

Step 5: Evidence Corroboration

Google Custom Search with dynamic keywords and summaries finds supporting/contradicting evidence from trusted domains.

Step 6: Domain Update

Firestore domain scores updated based on verification results. Weighted average by unique user votes.

Step 7: Cache Storage

Final result stored in Pinecone (vector) and Firestore (document) with 15-day TTL.

Step 8: Result Delivery

Findings sent back to extension and displayed in user-friendly overlay with explanation.

๐Ÿš€ Get Started

Install TrustMeter in minutes and start browsing with confidence

๐Ÿ“ฅ Installation Guide

1

Download the Extension

Click the button below to download the latest version of TrustMeter from GitHub.

2

Extract the ZIP File

Unzip the downloaded file. You'll find an /app folder containing all extension files.

3

Open Chrome Extensions

Navigate to chrome://extensions/ in your Chrome browser's address bar.

4

Enable Developer Mode

Toggle the Developer mode switch in the top-right corner of the extensions page.

5

Load the Extension

Click Load unpacked and select the /app folder you extracted earlier.

6

Start Verifying!

The TrustMeter icon will appear in your browser toolbar. Click it to activate verification on any webpage.

๐ŸŽฎ Quick Start Guide

1๏ธโƒฃ

Verify Text

Highlight any text on a webpage and right-click, then select "Verify with TrustMeter" to check for accuracy and bias using 5 AI models.

2๏ธโƒฃ

Check Images

Right-click on any image and choose "Check Image Authenticity" to detect manipulation or AI generation using Google Vision + Vertex AI.

3๏ธโƒฃ

Website Score

Click the TrustMeter icon in your toolbar to get an instant credibility score for the current website using Firestore domain scoring.

๐Ÿ› ๏ธ Troubleshooting

โŒ Extension Not Loading?

Ensure Developer mode is enabled in chrome://extensions/ and you've selected the correct /app folder.

โš ๏ธ Verification Not Working?

Check your internet connection and ensure the backend API is running. Try refreshing the webpage and check browser console for errors.

๐ŸŒ Slow Performance?

Clear your browser cache and disable other extensions temporarily. First-time checks are slower; subsequent checks use Pinecone cache.

๐Ÿ”‘ API Key Issues?

Verify all API keys are correctly set in your .env
FIREBASE_KEY_PATH, GOOGLE_API_KEY, GOOGLE_SEARCH_CX, GEMINI_API_KEY, PINECONE_API, FIRESTORE_CREDENTIALS_PATH, GOOGLE_APPLICATION_CREDENTIALS, PROJECT_ID, IMG_ENDPOINT_ID, TEXT_ENDPOINT_ID, LOCATION, GOOGLE_VISION_AI_CLIENT_SECRET, GOOGLE_VISION_AI_CLIENT_ID, APP_SECRET_KEY

๐Ÿ’พ Cache Not Working?

Check Pinecone index status and ensure Firestore rules allow read/write. Run cleanup_expired() if cache is stale.

๐Ÿ“Š Inaccurate Results?

Provide feedback through the extension to improve accuracy. System learns from unique user votes and updates domain scores.

๐Ÿ“š Project Information

๐Ÿ’ป GitHub Repository

Open source on GitHub. Contributions, issues, and stars welcome!

github.com/akshaynair5/H2S_hackathon

โญ Star on GitHub

๐Ÿ‘ฅ Team IPV3

Built for the GenAI Hackathon by passionate developers committed to fighting misinformation with cutting-edge AI.

Contributors: Akshay Nair, Gokul Krishna and Sarath Rajendran.

๐Ÿ“ž Support & Contact

Need help? Have suggestions? Found a bug?

  • Open an issue on GitHub
  • Check documentation in README

๐Ÿ”ง Tech Stack Details

Core Technologies

Backend

Python 3.8+ Google Cloud SDK Flask

AI/ML

Gemini AI Vertex AI Google Vision Transformers

Databases

Pinecone Firestore Vector DB

APIs

Fact Check API Custom Search REST

๐Ÿ”‘ API Setup Guide

Get your API keys and configure TrustMeter in minutes
Only if you wanted to run server locally

๐Ÿ“‹ Prerequisites

TrustMeter uses several AI services to provide accurate verification. You'll need to create accounts and obtain API keys from Google Cloud Platform and Pinecone. Most services offer free tiers that are sufficient for personal use.

๐Ÿ—๏ธ Required API Keys

๐Ÿค–

1. Gemini API Key

Service: Google Gemini AI

Cost: Free tier available (60 requests/minute)

Steps:
1. Visit Google AI Studio
2. Sign in with your Google account
3. Click "Get API Key" โ†’ "Create API Key"
4. Copy the generated key

๐Ÿ“Š

2. Pinecone API Key

Service: Pinecone Vector Database

Cost: Free tier (100K vectors)

Steps:
1. Visit Pinecone.io
2. Sign up for a free account
3. Go to "API Keys" in the console
4. Create a new index (dimension: 384, metric: cosine)
5. Copy your API key and index name

โ˜๏ธ

3. Google Cloud API Key

Services: Vision API, Custom Search

Cost: $300 free credit for new users

Steps:
1. Visit Google Cloud Console
2. Create a new project
3. Enable these APIs: Vision API, Custom Search API
4. Go to "Credentials" โ†’ "Create Credentials" โ†’ "API Key"
5. Copy the API key

๐Ÿง 

4. Vertex AI Credentials

Service: Google Vertex AI ML

Cost: Included in Google Cloud free tier

Steps:
1. In Google Cloud Console, enable Vertex AI API
2. Go to "IAM & Admin" โ†’ "Service Accounts"
3. Create service account with "Vertex AI User" role
4. Create JSON key and download it
5. Note your Project ID

โœ…

5. Fact Check API Key

Service: Google Fact Check Tools API

Cost: Free (no quota limits)

Steps:
1. In Google Cloud Console
2. Enable "Fact Check Tools API"
3. Use the same API key from step 3
4. No separate key needed

๐Ÿ”

6. Custom Search Setup

Service: Google Custom Search API

Cost: 100 queries/day free

Steps:
1. Visit Programmable Search Engine
2. Create new search engine
3. Set to search entire web
4. Copy your Search Engine ID
5. Use Google Cloud API key from step 3

๐Ÿ”ฅ

7. Firestore Setup

Service: Google Cloud Firestore

Cost: Free tier (1GB storage)

Steps:
1. Visit Firebase Console
2. Add Firebase to your Google Cloud project
3. Enable Firestore Database
4. Use the same service account JSON from step 4
5. Note your Project ID

๐Ÿงฉ Generate Your .env File

Fill in your credentials below โ€” TrustMeter will create a complete .env file template for you.

1

Firebase Key Path

2

Google Cloud Configuration

3

Gemini AI Configuration

4

Pinecone Vector Database

5

Firestore & Credential Paths

6

Vertex AI & Vision Configuration

7

Vision AI Credentials

8

Application Secret

๐Ÿ› ๏ธ Common Issues

โŒ "API Key Invalid" Error

Double-check that you've enabled the correct APIs in Google Cloud Console and that your keys have no extra spaces.

โš ๏ธ "Quota Exceeded" Error

You may have hit the free tier limit. Check your usage in the respective consoles or upgrade to a paid plan.

๐Ÿ”’ "Permission Denied" Error

Ensure your service account has the correct roles: Vertex AI User, Firestore User, and Storage Object Viewer.

๐Ÿ“ "Service Account JSON Not Found"

Make sure service-account.json is in your project root directory, not in a subdirectory.