brat (brat rapid annotation tool) est une solution web dédiée à l'annotation textuelle, conçue pour offrir une expérience utilisateur fluide pour la création de délimitations de texte et l'établissement de relations entre entités. Initialement développé pour visualiser les données du défi partagé BioNLP'11, cet outil a été adopté par plus de 50 000 annotations créées par l'équipe Genia et divers groupes de recherche internationaux.

L'objectif principal de brat est de surmonter les limitations des outils d'annotation précédents, notamment la dispersion des configurations, l'éloignement visuel entre les annotations et le texte source, ainsi que la complexité de configuration pour les annotateurs.

Technologies et Architecture

Stack technique principal

• Affichage et édition textuels basés sur navigateur
• Association visuelle directe entre annotations et texte
• Gestion centralisée des données via serveur web

Architecture technique

• Interface utilisateur implémentée avec HTML5, CSS3 et JavaScript moderne
• Backend développé en Python avec serveur web intégré
• Stockage de données au format structuré

Prérequis Système

Avant de procéder à l'installation, vérifiez que votre environnement dispose des éléments suivants :

• Python 3.6 ou supérieur
• Serveur web (Apache2, Nginx ou le serveur intégré)
• Système de contrôle Git
• Permissions d'écriture dans le répertoire d'installation

Procédure d'Installation Détaillée

Étape 1: Récupération du code source

Exécutez la commande suivante dans votre terminal pour cloner le dépôt :

git clone https://github.com/nlplab/brat.git
cd brat

Étape 2: Installation des dépendances

Installez les packages Python requis :

python3 -m pip install -r requirements.txt

Étape 3: Configuration des permissions

Ajustez les droits d'accès pour le serveur web :

chmod -R u+rwx data/ work/
chmod -R g+rwx data/ work/

Étape 4: Configuration du serveur Apache

Créez une configuration virtuelle pour brat :

<VirtualHost *:80>
    ServerName annotation.votre-domaine.com
    DocumentRoot /chemin/vers/brat/brat
    
    <Directory "/chemin/vers/brat/brat">
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

Étape 5: Initialisation de l'application

Lancez le script d'installation pour créer les utilisateurs initiaux :

python3 install.py

Étape 6: Démarrage du service

Pour un test rapide, utilisez le serveur de développement intégré :

python3 standalone.py

Pour la production, configurez votre serveur web pour pointer vers le répertoire brat et redémarrez-le.

Accès à l'Interface

Ouvrez votre navigateur et accédez à l'URL configurée (par défaut : http://localhost:8001). Connectez-vous avec les identifianst créés lors de l'installation pour commencer vos projets d'annotation.

Dépannage Commun

Pour toute difficulté lors de l'installation, consultez le fichier README.md inclus dans le projet ou référez-vous au suivi de problèmes du dépôt GitHub pour obtenir de l'aide.