🛡️ ZeroTRUST AI4Bharat

AI-Powered Fake News Detection & Claim Verification System

⚠️ IMPORTANT: Security First

🔐 This repository contains NO real credentials. All sensitive data uses placeholders.
📖 New users: Read SETUP_SECRETS_GUIDE.md to configure your own credentials.

Before contributing or committing:

✅ Read SECURITY_README.md
✅ Check DELETE_BEFORE_COMMIT.md
✅ Never commit .env files with real credentials

🚀 What is ZeroTRUST?

ZeroTRUST is an advanced AI-powered platform that helps combat misinformation by:

🔍 Automated Fact-Checking: Analyzes claims against multiple trustworthy sources
🤖 Multi-Agent AI System: Uses specialized AI agents (Research, News, Scientific, Social Media)
🎥 Media Analysis: Detects deepfakes, manipulated images, and audio
📊 Real-time Verification: Provides credibility scores and evidence trails
🌐 Multi-Platform: Web portal, browser extension, and API access

🏗️ Architecture

┌─────────────────────────────────────────────────────────────┐
│                    User Interfaces                          │
│  Web Portal  │  Browser Extension  │  Mobile App (Future)  │
└─────────────────┬───────────────────────────────────────────┘
                  │
                  ▼
┌─────────────────────────────────────────────────────────────┐
│                   API Gateway (Node.js)                      │
│  Authentication │ Rate Limiting │ Request Routing            │
└─────────────┬───────────────────────────────┬───────────────┘
              │                               │
              ▼                               ▼
┌─────────────────────────────┐   ┌──────────────────────────┐
│  Verification Engine (Python)│   │  Media Analysis (Python) │
│  ┌───────────────────────┐  │   │  ┌──────────────────┐   │
│  │ Manager Agent (LLM)   │  │   │  │ Image Analysis   │   │
│  │ ├─ Research Agent     │  │   │  │ Video Analysis   │   │
│  │ ├─ News Agent         │  │   │  │ Audio Analysis   │   │
│  │ ├─ Scientific Agent   │  │   │  │ Text Extraction  │   │
│  │ └─ Social Media Agent │  │   │  └──────────────────┘   │
│  └───────────────────────┘  │   └──────────────────────────┘
└─────────────┬───────────────┘
              │
              ▼
┌─────────────────────────────────────────────────────────────┐
│                     AWS Services                             │
│  Bedrock (LLM) │ S3 │ Lambda │ DynamoDB │ CloudWatch        │
└─────────────────────────────────────────────────────────────┘

✨ Features

Core Capabilities

✅ Multi-Source Verification: Checks claims against news APIs, academic papers, fact-check databases
✅ AI Agent Orchestration: Manager agent coordinates specialized agents for comprehensive analysis
✅ Media Forensics: Detects manipulated images, deepfake videos, and synthetic audio
✅ Evidence Tracking: Provides source citations and confidence scores
✅ Real-time Analysis: Fast processing with caching for repeated queries
✅ User Authentication: Secure JWT-based auth system
✅ Browser Extension: Verify claims directly while browsing

Technical Features

🔄 Scalable Architecture: Microservices-based design
📊 Comprehensive Logging: CloudWatch integration for monitoring
🔐 Security First: No hardcoded credentials, JWT authentication
🐳 Docker Support: Easy deployment with Docker Compose
🧪 Extensive Testing: Unit, integration, and E2E tests with Playwright
🌐 AWS Integration: Leverages Bedrock, S3, Lambda, DynamoDB

🚀 Quick Start

Prerequisites

Node.js 18+ and npm
Python 3.11+
Docker & Docker Compose (optional)
AWS Account with Bedrock access
PostgreSQL database (or Supabase free tier)

1. Clone Repository

git clone https://github.com/your-org/ZeroTRUST-AI4Bharat.git
cd ZeroTRUST-AI4Bharat

2. Configure Credentials

⚠️ IMPORTANT: Follow the complete setup guide:

# Read the setup guide
cat SETUP_SECRETS_GUIDE.md

# Copy environment templates
cp apps/api-gateway/.env.example apps/api-gateway/.env
cp apps/web-portal/.env.example apps/web-portal/.env

# Edit with your credentials
nano apps/api-gateway/.env

Required credentials:

AWS Access Key ID & Secret
Database connection string (PostgreSQL/Supabase)
JWT secret (generate with openssl rand -hex 64)

See detailed instructions: SETUP_SECRETS_GUIDE.md

3. Install Dependencies

# API Gateway
cd apps/api-gateway
npm install

# Web Portal
cd ../web-portal
npm install

# Verification Engine
cd ../verification-engine
python -m venv .venv
.venv\Scripts\Activate.ps1  # Windows
source .venv/bin/activate    # Linux/Mac
pip install -r requirements.txt

4. Run Services

Option A: Using Docker Compose (Recommended)

docker-compose up

Option B: Manual Start

# Terminal 1: API Gateway
cd apps/api-gateway
npm run dev

# Terminal 2: Verification Engine
cd apps/verification-engine
uvicorn src.main:app --reload --port 8000

# Terminal 3: Web Portal
cd apps/web-portal
npm run dev

# Terminal 4: Media Analysis
cd apps/media-analysis
uvicorn src.main:app --reload --port 8001

5. Access the Application

Web Portal: http://localhost:5173
API Gateway: http://localhost:8000
API Docs: http://localhost:8000/docs

🔧 Setup & Configuration

Environment Setup

Guide	Description
SETUP_SECRETS_GUIDE.md	START HERE - Complete credential setup guide
SECURITY_README.md	Security best practices and verification
DELETE_BEFORE_COMMIT.md	Pre-commit checklist

AWS Setup

Step	Guide	Description
1	01-iam-setup.md	IAM user and permissions
2	02-bedrock-setup.md	Enable Bedrock models
3	03-s3-setup.md	S3 bucket for media
4	04-dynamodb-setup.md	DynamoDB tables
5	05-cloudwatch-setup.md	CloudWatch logging
6	06-lambda-setup.md	Lambda functions
7	07-media-services-setup.md	Media analysis services

Quick References

Free Tier Guide: QUICKSTART_FREE_TIER.md
AWS Migration: AWS_MIGRATION_GUIDE.md
Testing Guide: TESTING_GUIDE.md

📚 Documentation

For Developers

Architecture Analysis: COMPREHENSIVE_ARCHITECTURE_ANALYSIS.md
Implementation Status: IMPLEMENTATION_STATUS.md
Development Plan: DEVELOPMENT_PLAN.md
Testing Guide: E2E_TESTING_GUIDE.md

For DevOps

AWS Services Analysis: AWS_SERVICES_USAGE_ANALYSIS.md
Free Tier Optimization: FREE_TIER_OPTIMIZATION.md
Deployment Steps: STEP_4_ECS_DEPLOYMENT.md

🛠️ Technology Stack

Frontend

React + TypeScript + Vite
TailwindCSS for styling
Axios for API calls
Browser Extension (Vanilla JS)

Backend

Node.js + Express (API Gateway)
Python + FastAPI (Verification Engine & Media Analysis)
PostgreSQL (Database)
Redis (Caching)

AI & ML

AWS Bedrock (LLM inference)
- Amazon Nova models
- Mistral Pixtral
LangChain (Agent orchestration)
Custom AI Agents (Research, News, Scientific, Social)

AWS Services

Bedrock: LLM hosting
S3: Media storage
Lambda: Serverless functions
DynamoDB: NoSQL cache
CloudWatch: Logging & monitoring
Rekognition: Image analysis
Textract: Text extraction
Transcribe: Audio transcription

DevOps

Docker & Docker Compose
Playwright (E2E testing)
Pytest (Python testing)
Jest (JavaScript testing)

🤝 Contributing

We welcome contributions! Before contributing:

Read security guidelines: SECURITY_README.md
Never commit real credentials
Follow the development plan: DEVELOPMENT_PLAN.md
Run tests before submitting PRs

Development Workflow

# 1. Create a feature branch
git checkout -b feature/your-feature-name

# 2. Make your changes

# 3. Run tests
npm test                    # Frontend tests
pytest                      # Python tests
npm run test:e2e           # E2E tests

# 4. Verify no secrets
git diff --staged | grep -iE "AKIA|secret_access_key"
# Should return nothing!

# 5. Commit and push
git add .
git commit -m "feat: your feature description"
git push origin feature/your-feature-name

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

AI4Bharat for the initiative
AWS for Bedrock and infrastructure services
Open-source community for amazing tools and libraries

📞 Support & Contact

Documentation: Start with SETUP_SECRETS_GUIDE.md
Issues: Please use GitHub Issues
Security: For security vulnerabilities, please email security@zerotrust-ai4bharat.org

⭐ Star History

If you find this project useful, please consider giving it a star! ⭐

Built with ❤️ by the ZeroTRUST AI4Bharat Team

Last Updated: March 3, 2026

Name		Name	Last commit message	Last commit date
apps		apps
aws-setup		aws-setup
frontend ai for bharat		frontend ai for bharat
lambda-functions/verify		lambda-functions/verify
scripts		scripts
tests/e2e		tests/e2e
.coverage		.coverage
.env.local.example		.env.local.example
.gitignore		.gitignore
ARCHITECTURE_COMPARISON.md		ARCHITECTURE_COMPARISON.md
AUTOMATED_TESTING_SUMMARY.md		AUTOMATED_TESTING_SUMMARY.md
AWS_AND_TEST_REQUIREMENTS.md		AWS_AND_TEST_REQUIREMENTS.md
AWS_DEPLOYMENT_STATUS_AND_CONTINUATION.md.resolved		AWS_DEPLOYMENT_STATUS_AND_CONTINUATION.md.resolved
AWS_MIGRATION_GUIDE.md		AWS_MIGRATION_GUIDE.md
AWS_SERVICES_USAGE_ANALYSIS.md		AWS_SERVICES_USAGE_ANALYSIS.md
COMPLETED_IMPLEMENTATION_SUMMARY.md		COMPLETED_IMPLEMENTATION_SUMMARY.md
COMPREHENSIVE_ARCHITECTURE_ANALYSIS.md		COMPREHENSIVE_ARCHITECTURE_ANALYSIS.md
DELETE_BEFORE_COMMIT.md		DELETE_BEFORE_COMMIT.md
DEPLOYMENT_STATUS_FINAL.md		DEPLOYMENT_STATUS_FINAL.md
DEVELOPMENT_PLAN.md		DEVELOPMENT_PLAN.md
E2E_TESTING_GUIDE.md		E2E_TESTING_GUIDE.md
END_TO_END_TESTING.md		END_TO_END_TESTING.md
FREE_TIER_OPTIMIZATION.md		FREE_TIER_OPTIMIZATION.md
IMPLEMENTATION_STATUS.md		IMPLEMENTATION_STATUS.md
PHASE_5_AMPLIFY_DEPLOYMENT_GUIDE.md		PHASE_5_AMPLIFY_DEPLOYMENT_GUIDE.md
PROJECT_PROGRESS_REPORT.md		PROJECT_PROGRESS_REPORT.md
QUICKSTART_FREE_TIER.md		QUICKSTART_FREE_TIER.md
QUICK_START_SECURITY.md		QUICK_START_SECURITY.md
QUICK_TEST_REFERENCE.md		QUICK_TEST_REFERENCE.md
README.md		README.md
SECURITY_CLEANUP_SUMMARY.md		SECURITY_CLEANUP_SUMMARY.md
SECURITY_README.md		SECURITY_README.md
SETUP_SECRETS_GUIDE.md		SETUP_SECRETS_GUIDE.md
STEP_1_ELASTICACHE_SETUP.md		STEP_1_ELASTICACHE_SETUP.md
STEP_2_RDS_SETUP.md		STEP_2_RDS_SETUP.md
STEP_3_DYNAMODB_SETUP.md		STEP_3_DYNAMODB_SETUP.md
STEP_4_ECS_DEPLOYMENT.md		STEP_4_ECS_DEPLOYMENT.md
STEP_5_LAMBDA_SETUP.md		STEP_5_LAMBDA_SETUP.md
STEP_6_API_GATEWAY_SETUP.md		STEP_6_API_GATEWAY_SETUP.md
TASK_1_CONFIGURATION_GUIDE.md		TASK_1_CONFIGURATION_GUIDE.md
TESTING_GUIDE.md		TESTING_GUIDE.md
TEST_ANALYSIS_REPORT.md		TEST_ANALYSIS_REPORT.md
TEST_BACKEND_API.ps1		TEST_BACKEND_API.ps1
ZeroTRUST AI4Bharat - AWS Deployment.md		ZeroTRUST AI4Bharat - AWS Deployment.md
ZeroTRUST AWS Deployment — Status & Cont.txt		ZeroTRUST AWS Deployment — Status & Cont.txt
alb_details.json		alb_details.json
api-gateway-task.json		api-gateway-task.json
backend_integration_guide.md		backend_integration_guide.md
bedrock_help.txt		bedrock_help.txt
build-logs-utf8.json		build-logs-utf8.json
build-logs.json		build-logs.json
buildspec.yml		buildspec.yml
cf.json		cf.json
cf_dist.json		cf_dist.json
check_bedrock.py		check_bedrock.py
check_env.ps1		check_env.ps1
check_media_billing.py		check_media_billing.py
cloudfront_deployment_guide.md		cloudfront_deployment_guide.md
codebuild-policy.json		codebuild-policy.json
codebuild-trust-policy.json		codebuild-trust-policy.json
cors.json		cors.json
deploy_frontend_d_drive.ps1		deploy_frontend_d_drive.ps1
deploy_frontend_s3.ps1		deploy_frontend_s3.ps1
deploy_phase3.ps1		deploy_phase3.ps1
deploy_phase4.ps1		deploy_phase4.ps1
diagnose_system.py		diagnose_system.py
dist.json		dist.json
docker-compose.yml		docker-compose.yml
ec2-trust-policy.json		ec2-trust-policy.json
ec2-userdata.sh		ec2-userdata.sh
ecs-task-policy.json		ecs-task-policy.json
ecs-trust-policy.json		ecs-trust-policy.json
lambda-trust-policy.json		lambda-trust-policy.json
listeners.json		listeners.json
media-analysis-task.json		media-analysis-task.json
media_test_output.txt		media_test_output.txt
package.json		package.json
playwright.config.ts		playwright.config.ts
quick_cors_fix.ps1		quick_cors_fix.ps1
run-claim-verification-tests.ps1		run-claim-verification-tests.ps1
target_groups.json		target_groups.json
task-def-cors.json		task-def-cors.json
test-verifications.ps1		test-verifications.ps1
test_api.py		test_api.py
test_claim_verification.py		test_claim_verification.py
test_cloudwatch.py		test_cloudwatch.py
test_dynamodb.py		test_dynamodb.py
test_local.py		test_local.py
tg.json		tg.json
tg_discovery.json		tg_discovery.json
tg_list.json		tg_list.json
update_cors_and_redeploy.ps1		update_cors_and_redeploy.ps1
upload_to_s3.py		upload_to_s3.py
verification-engine-task.json		verification-engine-task.json
verify-no-secrets.ps1		verify-no-secrets.ps1
verify_all_aws.py		verify_all_aws.py
verify_media_services.py		verify_media_services.py
zip_sources.py		zip_sources.py

Latest commit

History

Folders and files

Repository files navigation