WonderAI is an intelligent web-based platform designed to detect misinformation and analyze news credibility using advanced Artificial Intelligence.
This project was built specifically for the Octopus Hackathon (Global AI Hackathon) with the mission of creating a digital shield against the spread of hoaxes and fake news in the digital age.
In the modern digital era, information spreads faster than it can be verified. WonderAI bridges this gap by leveraging Generative AI and global fact-checking databases. The system Wonder AI Server provides users with:
- Real-time AI Analysis: Instantly analyzes text or URLs to detect logical fallacies, sarcasm, and potential misinformation patterns.
- Global Trending Insights: Monitors and displays trending hoaxes that have been debunked by international fact-checking organizations.
- 🔍 Instant Truth Analysis: Input any news text or URL to receive an immediate Verdict (Factual/Misinformation/Satire) along with a Confidence Score and logical explanation.
- 🌍 Trending Misinformation: Integrates live data from the Google Fact Check Tools API to showcase viral claims currently circulating globally.
- 📄 PDF Transparency Reports: Users can download a comprehensive "Guidelines & Ethics" PDF that explains how the AI works and its privacy policies, generated client-side.
- 🎨 Glassmorphism UI: A highly responsive, modern interface built with React and Framer Motion for a smooth user experience.
- 🛡️ Smart Rate Limiting: The backend intelligently handles API quotas, providing user-friendly feedback when AI services are busy.
- React.js (Vite): The core UI framework for high performance.
- Tailwind CSS (v4): Modern styling with a custom brand theme configuration.
- Framer Motion: Handles interactive animations (page transitions, hover effects, floating tooltips).
- Axios: Manages HTTP requests to the backend API.
- jsPDF: Generates transparency reports/guidelines in PDF format directly in the browser.
- Node.js & Express.js: RESTful API server architecture.
- Google Generative AI SDK: Connects to the Gemini 2.5 Flash model for text analysis.
- Google Fact Check Tools API: Fetches verified claim data from global publishers (Snopes, AFP, etc.).
- Dotenv: Manages secure environment variables.
Follow these steps to run the project locally.
- Node.js (v16 or newer)
- NPM (Node Package Manager)
- API Key from Google AI Studio (for Gemini)
- API Key from Google Cloud Console (for Fact Check Tools)
Navigate to the backend directory (where index.js is located):
- Install Dependencies:
npm install
- Configure Environment Variables:
Create a
.envfile in the root folder and add the following keys:
PORT=5000
GEMINI_API_KEY=Your_Google_Gemini_API_Key
GOOGLE_API_KEY=Your_Google_Cloud_API_Key
- Start the Server:
node index.js
*The server will run at http://localhost:5000*
Navigate to the frontend directory (where vite.config.js is located):
- Install Dependencies:
npm install
- Configure API Endpoint (Optional):
By default, the code points to the production backend (
https://wonder-ai-backend.vercel.app). To use your local backend, update the URL insrc/components/AnalyzeForm.jsxandsrc/components/TrendingSection.jsx:
// Change to:
const API_URL = "http://localhost:5000";- Run the Application:
npm run dev
*Open your browser and visit http://localhost:5173*
- Home Page Analysis:
- Click the "Get Started" button in the navigation bar to scroll to the analysis input.
- Paste a news article text or a URL into the box.
- Click "Analyze With AI".
- The result card will automatically scroll into view, showing the Verdict and Confidence Score.
- Trending Section:
- Scroll down to the "Trending Misinformation" section.
- Browse cards showing recent global hoaxes.
- Click on a card to see the Detailed Report (Claimant, Date, Evidence).
- Click "View Full Report" to visit the original fact-checker's website.
- Transparency & Ethics:
- Click the "Read Full Guidelines" button in the Disclaimer section.
- Read the operational ethics in the popup modal.
- Click "Download PDF" to save a copy of the guidelines.
WonderAI utilizes advanced Large Language Model (LLM) technology, which, while powerful, is not infallible.
- AI Hallucinations: The AI model may occasionally misinterpret context or produce inaccurate results.
- Manual Verification: Results from WonderAI should be treated as a "Second Opinion" or initial screening tool, not absolute truth.
- User Responsibility: We strongly encourage users to cross-reference critical information (Health, Politics, Safety) with official government sources or credible news outlets.
- Privacy: We employ a "Zero Storage Policy." User input text is processed in real-time and is never permanently stored on our servers.
This project is Open Source, created for educational purposes and the Octopus Hackathon. Feel free to submit Pull Requests or report issues via GitHub.
Credits:
- Designed & Developed by [Fatiya Labibah]
- Powered by Google Gemini API & Google Fact Check Tools
© 2025 WonderAI Project. All Rights Reserved.