🤖 Hotline Darons

Bot Telegram IA multimodal pour le support technique parental — propulsé par Gemini 2.5 Flash.

Fini les appels paniqués à 22h pour "la télé qui s'allume plus". Hotline Darons répond en quelques secondes, en français simple, avec une patience infinie. Il analyse les photos d'écran, comprend les messages vocaux, et escalade vers vous seulement quand c'est vraiment nécessaire.

---

🎯 Compétences démontrées

Domaine	Implémentation
LLM / Multimodal	Gemini 2.5 Flash — texte, image, audio natif
RAG familial	Embedding Google + cosine search sur knowledge base .md
Bot Telegram	Handlers async, gestion de session, file d'attente photo→question
Sécurité IA	Filtre PII (IBAN, CB, mots de passe) sur texte et images
Escalade intelligente	Détection de niveau de complexité → transfert à l'humain
Tests	38/38 tests pytest — session store, PII filter, escalade
DevOps	Docker Compose, variables d'environnement, SQLite persistant

---

Architecture

┌─────────────────────────────────────────────────────────┐
│                   Telegram (parents)                     │
│              📸 Photo  🎤 Vocal  ✍️ Texte               │
└───────────────────────┬─────────────────────────────────┘
                        │
                        ▼
┌─────────────────────────────────────────────────────────┐
│                    bot/main.py                           │
│  ┌─────────────┐  ┌──────────────┐  ┌───────────────┐  │
│  │session_store│  │  pii_filter  │  │  escalation   │  │
│  │  (SQLite)   │  │  (sécurité)  │  │  (→ Jerome)   │  │
│  └─────────────┘  └──────────────┘  └───────────────┘  │
└───────────────────────┬─────────────────────────────────┘
                        │
             ┌──────────┴──────────┐
             │                     │
             ▼                     ▼
┌────────────────────┐   ┌────────────────────┐
│    bot/rag.py      │   │  bot/ai_engine.py  │
│  Knowledge Base    │──▶│  Gemini 2.5 Flash  │
│  text-embedding    │   │  Multimodal        │
│  004 (Google)      │   │  JSON structuré    │
└────────────────────┘   └────────────────────┘

---

Quick Start

Prérequis

• Docker + Docker Compose
• Un token bot Telegram (via @BotFather)
• Une clé API Google AI (aistudio.google.com)
• Votre Telegram user ID (via @userinfobot)

Déploiement en 3 commandes

# 1. Cloner et configurer
cp .env.example .env
nano .env  # Remplir TELEGRAM_BOT_TOKEN, GEMINI_API_KEY, ESCALATION_CHAT_ID

# 2. Personnaliser la base de connaissances (optionnel mais recommandé)
nano knowledge/famille_jacq.md

# 3. Lancer
docker-compose up -d

Le bot est actif ! Envoyez /start depuis Telegram.

---

Configuration

Variables d'environnement (.env)

Variable	Description	Obligatoire
TELEGRAM_BOT_TOKEN	Token du bot Telegram (via @BotFather)	✅
GEMINI_API_KEY	Clé API Google AI Studio	✅
ESCALATION_CHAT_ID	Votre Telegram user ID (pour recevoir les alertes)	✅
KNOWLEDGE_DIR	Chemin vers le dossier knowledge	Non (défaut: /app/knowledge)
DB_PATH	Chemin vers la base SQLite	Non (défaut: /app/data/hotline_darons.db)

Obtenir votre Telegram ID

Envoyez /start à @userinfobot sur Telegram — il vous donne votre ID numérique.

---

Personnalisation de la Knowledge Base

Éditez knowledge/famille_jacq.md pour adapter le bot à votre famille :

## Télévision
- Modèle : Samsung UE55TU7125
- Box IPTV : Freebox Player
...

Le bot recharge automatiquement la base au démarrage. Voir knowledge/README.md pour le guide complet.

---

Fonctionnalités

Fonctionnalité	Description
📸 Photo d'écran	Analyse l'image + attend votre description vocale/texte
🎤 Message vocal	Transcrit et analyse l'audio directement (Gemini natif)
✍️ Texte	Répond aux questions écrites
🔒 Filtre PII	Bloque automatiquement les données bancaires / mots de passe
📚 RAG familial	Utilise la config de votre famille pour des réponses précises
🚨 Escalade	Vous alerte sur Telegram si le problème dépasse le niveau 1
💾 Contexte SQLite	Lie une photo à la question qui suit (jusqu'à 5 min)

---

Développement

Lancer en local (sans Docker)

# Installer les dépendances
pip install -r requirements.txt

# Configurer
cp .env.example .env && nano .env

# Lancer
python -m bot.main

Tests

pytest tests/ -v

---

Sécurité

• ✅ Zéro rétention : les photos sont supprimées après utilisation (5 min max)
• ✅ Filtre PII : détection d'IBAN, numéros de CB, mots de passe sur les images et dans le texte
• ✅ Pas de conseils bancaires : escalade systématique pour tout ce qui touche aux finances
• ✅ Secrets en env vars : aucun secret dans le code ou les fichiers versionnés

---

Roadmap

• Support WhatsApp (Twilio / Meta API)
• Interface d'administration web pour mettre à jour la knowledge base
• Résumé hebdomadaire des problèmes résolus
• Support multi-familles (configuration par utilisateur autorisé)
• Intégration Mem0 pour une mémoire long-terme par utilisateur
• Monitoring / alertes (Uptime Robot, Sentry)

---

Licence

Projet personnel — utilisation libre dans un contexte familial.