📖 Lutrin

📖 Lutrin est un projet solidaire né lors du marathon d'innovation Hacking Health Besançon 2025.

🏆 Lauréat du Hacking Health, le projet est désormais accompagné et suivi par Le Tube à Essais, une SCIC dédiée à l'incubation de projets innovants et solidaires.

Le concept

L'objectif est simple : rendre la lecture accessible à tous, en particulier aux personnes souffrant de handicaps moteurs ou visuels qui ne peuvent pas manipuler de livres papier.

Ce que fait Lutrin

Lutrin est une plateforme universelle qui transforme le texte en livre audio personnalisé en temps réel :

• Capture de livres physiques : Une simple webcam filme les pages d'un livre papier. L'IA reconnaît le texte et le lit instantanément avec une voix naturelle.
• Bibliothèque Numérique (ePub) : L'utilisateur peut importer ses propres fichiers ePub ou piocher dans une bibliothèque proposée par le serveur.
• Gestion Personnalisée : Chaque utilisateur dispose de son propre espace pour gérer sa collection de livres numériques et reprendre sa lecture audio là où il s'est arrêté.
• Interface Inclusive : Un contrôle ultra-épuré (gros boutons, navigation simplifiée) conçu pour pallier les déficiences visuelles ou le manque de précision motrice.

📄 Liens utiles

• Présentation du projet : Lien Canva
• Support technique : Utilisez les issues du dépôt GitHub.

🚀 Utilisation (Mode Utilisateur)

Si vous souhaitez utiliser le service sans installer de serveur, voici les accès directs :

🌐 Interface Web

Accédez à l'application de lecture directement via votre navigateur : 👉 https://lutrin.terium.org

📱 Application Android

Une application est disponible pour utiliser la caméra de votre téléphone comme scanner et l'envoyer au serveur.

• Télécharger l'APK : lutrin_apk/dist/lutrin.apk
• Fonctionnalités : Capture vidéo, streaming vers le serveur et interface de connexion simplifiée.

🛠️ Installation du Serveur (Mode Administrateur)

Cette section est destinée à l'hébergement de votre propre instance Lutrin.

📋 Prérequis

• Docker et Docker Compose
• Task (installé via make install)
• Git
• Certificats SSL (auto-signés ou officiels)

⚙️ Installation

1. Cloner le dépôt :

   git clone [https://github.com/afornerot/lutrin.git](https://github.com/afornerot/lutrin.git)
   cd lutrin

2. Installer les outils (Docker, Task) :

   make install

   Note : Après l'installation, déconnectez-vous et reconnectez-vous pour que les changements de groupe Docker prennent effet.

3. Générer les certificats SSL (requis pour le client HTTPS) : Placez-les dans lutrin_tools/certs/ :

   openssl req -x509 -newkey rsa:4096 -keyout lutrin_tools/certs/key.pem -out lutrin_tools/certs/cert.pem -days 365 -nodes -subj "/C=FR/ST=France/L=Paris/O=Lutrin/CN=localhost"

4. Démarrage :

   task build   # Construit les images et initialise la base de données
   task start   # Démarre tous les services en arrière-plan

🌍 Accès aux services locaux

• Client (HTTPS) : https://localhost:8000
• API (HTTP) : http://localhost:5000

---

🔧 Configuration et Administration

Gestion des utilisateurs

Lors du premier task build, un administrateur est créé. Vous pouvez en ajouter d'autres via le terminal :

• Ajouter un utilisateur : task add-user user=nom password=pass email=mail@mail.com role=USER
• Changer un mot de passe : task change-password user=nom password=nouveau_pass

🌍 Variables d'environnement

Toutes les variables sont définies dans le fichier .env à la racine du projet. Si vous souhaitez les modifier, ne modifiez pas .env : créez un fichier .env.local et surchargez-y uniquement les variables souhaitées.

⚠️ IMPORTANT : Créez systématiquement un fichier .env.local et modifiez-y les secrets (GROQ_TOKEN, MAILER_DSN, etc.). Le fichier .env contient des valeurs par défaut publiques et ne doit jamais contenir de vrais secrets.

Exemple de .env.local :

GROQ_TOKEN=votre_cle_api
COQUI_MODEL=tts_models/fr/mai/tacotron2-DDC
CLIENT_PORT=9000

Liste complète des variables

Variable	Description	Valeur par défaut
GROQ_TOKEN	Clé API Groq pour l'OCR (optionnel, vitesse accrue)	changeme
MAILER_DSN	Configuration d'envoi d'e-mails	sendmail://default
FRONT_URL	URL du frontend (utilisée dans les e-mails)	https://localhost:8000
COQUI_TTS_URL	URL du service Coqui TTS	http://coqui:5002
COQUI_MODEL	Modèle de synthèse vocale Coqui	tts_models/multilingual/multi-dataset/xtts_v2
FLASK_PORT	Port du serveur Flask	5000
UPLOAD_FOLDER	Dossier de stockage des fichiers uploadés	/data
DATABASE_PATH	Chemin vers la base de données SQLite	/data/database.db
CLIENT_PORT	Port d'écoute du frontend	8000
API_PORT	Port de l'API	5000
API_HOST	Hôte de l'API	api
PIPER_MODEL	Modèle TTS Piper (chemin relatif à lutrin_api/)	models/fr_FR-siwis-medium.onnx

Modèles Coqui disponibles

• tts_models/multilingual/multi-dataset/xtts_v2 (défaut)
• tts_models/fr/mai/tacotron2-DDC
• tts_models/fr/css10/vits

---

🏗️ Architecture Technique

Le projet est composé de trois services Docker :

1. api : Backend Flask (OCR, gestion utilisateur, logique).
2. client : Frontend web et proxy HTTPS.
3. coqui : Moteur de synthèse vocale (TTS).

lutrin/
├── lutrin_api/          # Backend API Flask
├── lutrin_client/       # Frontend (HTML/CSS/JS)
├── lutrin_coqui/        # Script de démarrage Coqui
├── lutrin_data/         # Données persistantes (base de données, modèles)
│   ├── api/
│   └── coqui/
├── lutrin_tools/        # Utilitaires et scripts
│   ├── task_scripts/    # Scripts pour les commandes task
│   └── certs/           # Certificats SSL (gitignorés)
├── lutrin_apk/          # Application Android (APK dans dist/)
├── docker-compose.yml   # Orchestration des services
├── Taskfile.yml         # Définition des commandes task
└── Makefile             # Installation des prérequis