DocsInstallation

Installation

Guide complet pour installer et configurer THOR sur votre machine.

Prérequis

Python
3.9 ou supérieur
Node.js
18 ou supérieur
Git
Dernière version
FFmpeg
Optionnel (pour Whisper)

Étapes d'installation

1

Cloner le dépôt

Clonez le projet depuis GitHub :

Terminal
git clone https://github.com/THOR-EPITECH/THOR.git
cd THOR
2

Configurer l'environnement Python

Créez et activez un environnement virtuel :

Terminal
python3 -m venv venv
source venv/bin/activate  # Linux/macOS
# ou
venv\Scripts\activate    # Windows

Installez les dépendances :

Terminal
pip install -r requirements.txt
3

Télécharger le modèle spaCy

Le modèle français de spaCy est nécessaire pour le NLP :

Terminal
python -m spacy download fr_core_news_md
4

Générer les datasets

Les scripts de génération préparent les données pour le pathfinding :

Terminal
# Générer le graphe des liaisons avec temps réels
python3 scripts/generate_enhanced_graph.py

# Générer les tracés géographiques des voies
python3 scripts/generate_railway_shapes.py
5

Lancer le backend Flask

Démarrez l'API Python avec préchargement des modèles :

Terminal
python3 api/app.py --preload

Note

L'option --preload charge Whisper au démarrage pour des réponses plus rapides.

6

Lancer le frontend Next.js

Dans un nouveau terminal, installez et lancez le frontend :

Terminal
cd web
npm install
npm run dev

L'application sera accessible sur http://localhost:3000

Vérification

Pour vérifier que tout fonctionne, testez l'API health check :

curl http://localhost:8000/api/health

Vous devriez recevoir une réponse JSON avec le statut "ok" et les modèles chargés.