kingvirus0/iroyincheck

AI fact-checking bot for Nigerian communities - WhatsApp, Telegram & Discord in Pidgin, Yoruba, Hausa, Igbo # ÌròyìnCheck **AI fact-checking bot for Nigerian communities** — stops misinformation in its tracks across **WhatsApp, Telegram, and Discord**, answering in the languages people actually speak: **Pidgin, Yoruba, Hausa, and Igbo**. `ìròyìn` (Yoruba: *news*) + `check`. Built for the messaging apps where fake news spreads fastest. --- ## Why Forwarded "viral" messages and voice notes are how misinformation moves through Nigerian WhatsApp groups, Telegram channels, and Discord servers — usually in local languages that global fact-checkers don't cover. ÌròyìnCheck meets people where they already talk: it detects suspicious claims in a chat and fact-checks them *in-thread*, with explanations in the user's own language. ## What it does | Platform | How it works | |---|---| | **WhatsApp** | Scans chat messages for claim-like patterns (words like *forward*, *viral*, *apparently*), replies in-thread with a verdict + local-language explanation. Baileys-based, auto-reconnect. | | **Telegram** | `/factcheck `, `/trending`, `/report`, language selection per chat, auto-checks suspicious messages. | | **Discord** | `!factcheck`, `!trending`, `!source`, `!stats`, server-wide language preference. | **Core engine (`src/core/`)** - `factCheckEngine.js` — keyword + context claim matching against a curated hoax database - `hoaxDatabase.js` — 50+ verified Nigerian misconceptions with `TRUE / FALSE / UNVERIFIED / MISLEADING` verdicts - `languageDetector.js` — detects Pidgin / Yoruba / Hausa / Igbo from message content - `responseFormatter.js` — local-language explanations, per-platform formatting **Graceful degradation** — when external fact-check APIs are unreachable, the local database keeps answering, so the bot never silently goes quiet. ## Repo layout ``` iroyincheck/ # multi-platform bot (WhatsApp + Telegram + Discord) ├── src/ │ ├── core/ # platform-agnostic fact-checking engine │ ├── bots/ # whatsappBot, telegramBot, di …