Rodrigue-k/awa-bot-vbg

Awa — Chatbot WhatsApp alimenté par IA pour orienter les victimes de VBG au Togo vers les structures d'aide locales # Awa — Chatbot VBG Togo Awa est une assistante conversationnelle accessible via WhatsApp, conçue pour orienter les personnes victimes de violences basées sur le genre (VBG) au Togo vers les structures d'aide locales. Projet développé dans le cadre du **Hack4Peace 2026** — WANEP Togo & UNFPA. ## Table des matières - Problème adressé - Solution - Fonctionnalités - Stack technique - Contacts officiels intégrés - Installation rapide - Configuration (.env) - Lancement - Structure du projet - Équipe - Contribuer - Licence ## Problème adressé Au Togo, de nombreuses personnes victimes de VBG ne savent pas vers qui se tourner. La honte, la peur du jugement et la méconnaissance de leurs droits les poussent au silence. Les outils existants utilisaient des mots-clés rigides et ne comprenaient pas toujours le langage naturel. ## Solution Awa fonctionne directement via WhatsApp — sans installation ni inscription. L'utilisateur décrit sa situation en langage naturel ; Awa, grâce à l'IA, pose des questions pertinentes et oriente vers la ressource la plus appropriée. ## Fonctionnalités - Compréhension du langage naturel via Gemini 2.5 Flash - Flow conversationnel en étapes : écoute → localisation → orientation - Orientation vers les contacts officiels au Togo selon la région - Collecte anonyme de données (type de violence, région, horaire, ressource) - Mémoire conversationnelle persistante par utilisateur - Gestion des messages normaux et des messages cités WhatsApp ## Stack technique - Backend : Python + Flask - IA : Google Gemini 2.5 Flash (via API) - WhatsApp : Green API - Stockage : CSV anonymisé et JSON pour la persistance ## Contacts officiels intégrés - Ligne verte VBG : 8284 (gratuit) - Protection enfants : 1011 (gratuit) - Milieu scolaire : 8255 (gratuit) - WILDAF-Togo : +228 22 61 49 25 - Association AFE : +228 91 32 59 25 - One Stop Center : CMS Adidogomé, Lomé ## Installation rapide Prérequis : Python 3.10+. ```bash git clone github.com …