leodirbusiness-alt/wa-dashboard

WA Dashboard is a self hosted tool that turns a busy WhatsApp study group into a readable dashboard. It connects to your WhatsApp account through WhatsApp Web, reads the messages in a group, and uses a free AI service called OpenRouter to pull out useful pieces of information such as deadlines with an urgency level, lessons grouped by topic, upcoming events with their dates, and warnings. It then builds a dark themed, mobile friendly web page that shows all of this in one place and refreshes itself automatically every four hours. The page is served on your local WiFi network so you can check it from your phone. A feature the README highlights is source verification. Every piece of extracted information links back to the exact WhatsApp message it came from, so instead of trusting the AI blindly, you can click through and see the original text yourself. To try it, you install the Python dependencies and run the main script, which either runs the full pipeline against a real WhatsApp group or, using sample data included in the project, just generates the dashboard so you can preview it without connecting a real account. The dashboard is then available in a browser at a local address. Dashboard features include a search box that filters everything in real time, lessons collapsed by subject, separate tabs for deadlines, lessons, events, and warnings, color coded urgency levels, and the source verification links. The project is written in Python and needs Python 3.10 or newer. It is built and tested for Windows, though the author notes it should be portable to Linux. It uses Playwright to automate WhatsApp Web scraping, OpenRouter's free tier for the AI extraction, plain HTML and JavaScript for the dashboard with no front end framework, and Windows Task Scheduler for the repeating updates. The code is organized into separate files for scraping, AI processing, dashboard generation, serving, and scheduling. The author lists future plans including processing images sent in the group, supporting more than one WhatsApp group at once, packaging the tool as a Docker container, and sending notifications to Telegram or Discord. The project is released under the MIT license.