Skip to content

maggyparra/watchdogs

Repository files navigation

Watch Dogs 🐕

Watch Dogs is a real-time AI-powered emergency intelligence platform that monitors X, verifies breaking incidents using Grok AI, and delivers clear, actionable alerts to first responders in under 30 seconds.

We turn social media chaos into verified emergency intelligence by:

  • Detecting incidents as they unfold
  • Clustering related posts into single events
  • Cross-referencing government alerts and news
  • Assigning transparent confidence scores
  • Displaying everything on a live map + feed dashboard

Built for police officers and first responders, Watch Dogs eliminates doomscrolling, reduces misinformation, and helps save lives when every second counts.

Run Locally

Prerequisites: Node.js

  1. Install dependencies:

    npm install
  2. Set up your X (Twitter) API key:

    • Get your Bearer Token from Twitter Developer Portal
    • Create a .env.local file in the root directory
    • Add your API key:
      VITE_X_API_KEY=your_bearer_token_here
      
  3. Run the app:

    npm run dev

Features

  • Real-time X (Twitter) Search: Searches X posts for real-time events
  • Engagement Analytics: Measures likes, retweets, replies, quotes, and views
  • TLDR Summaries: Automatically generates summaries from top posts
  • Media Links: Displays images and videos from X posts
  • Direct Post Links: Click through to view original X posts

X API Setup

To use this app, you'll need:

  1. A Twitter Developer account
  2. An API v2 Bearer Token
  3. Set the VITE_X_API_KEY environment variable with your Bearer Token

The app uses Twitter API v2's /tweets/search/recent endpoint to search for real-time events.

watchdogs

About

sentiment analysis for police officers

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors