HugoSchtr / Annopy

Application web développée avec le framework python Flask permettant à une communauté de crowdsourcer des images en les annotant.

Annopy

Annopy est une application web développée avec le framework python Flask, mettant à disposition une plateforme de production participative (crowdsourcing) dans le but d'annoter des images.

Chaque utilisateur-ice peut créer une collection, contenant des images importées à partir d'un manifest IIIF ou d'un album Flickr, et annoter les images des différentes collections existantes.

Les annotations sont générées et gérées avec la librairie JavaScript Annotorious, version 2.3.3.

Cette plateforme collaborative a été créée par Hugo Scheithauer dans le cadre du Master 2 "Technologies appliquées à l'histoire" de l'Ecole nationale des chartes.

Workflow du crowdsourcing

Le workflow de crowdsourcing a été conçue de la manière suivante :

1. Un-e utilisateur-ice crée une collection, en indiquant le nom du projet, une courte description, une catégorie et en important des images depuis un serveur extérieur. L'utilisateur-ice peut choisir d'importer des images depuis deux sources différents :

   • Un manifest IIIF
   • Un album Flickr

2. Une fois la collection créée, les utilisateurs peuvent commencer à annoter la collection.

3. Il est possible de récupérer les données d'une image (metadonnées et annotations), ou d'une collection (metadonnées, images, annotations) à tout moment au format JSON via l'API.

Fonctionnalités

Utilisateurs non connectés

Les utilisateurs non connectées peuvent :

• Naviguer à travers les collections déjà créées.

• Accéder à une collection et consulter ses metadonnées, ainsi que connaître le nombre d'images à annoter, sans pouvoir les consulter ni les annoter.

• Faire une recherche dans les collections.

• Accéder à la page de la communauté, montrant les membres de la plateforme.

• S'inscrire.

Utilisateurs connectés

Les utilisateurs connectés peuvent :

• Avoir accès aux fonctionnalités des utilisateurs non connectés.

• Avoir accès à leur profil utilisateur

  • Modifier leur compte utilisateur
  • Modifier leur mot de passe

• Créer une nouvelle collection pour commencer un projet de crowdsourcing. Il est possible de créer une collection avec :

  • Un manifest IIIF. Dans ce cas, un lien vers un manifest IIIF valide est nécessaire.
  • Avec l'API de Flickr. Dans ce cas, une Flickr API key, ainsi que l'ID de l'album Flickr duquel on veut récupérer les images, ainsi que l'ID de l'utilisateur-ice qui a créé l'album sont nécessaires

• Créer une nouvelle catégorie si besoin.

• Annoter les images d'une collection. Attention, un-e utilisateur-ice ne peut annoter qu'une seule fois une image. Une fois les annotations envoyées, l'utilisateur-ice ne pourra plus avoir accès à l'image. Voir dans le wiki un exemple d'annotation dans le viewer de l'application.

• Modifier (nom, description) une collection.

• Supprimer une collection.

• Récupérer via l'API les données d'une image d'une collection, ou d'une collection entière.

• Faire une recherche dans les collections avec l'API.

Démonstration

Des collections de démonstration ont été créées pour montrer ce qu'il est possible de faire avec l'application. Vous pouvez annoter les images de ces collections en créant un compte utilisateur, ou créer votre propre collection.

Spécificités techniques

Cette application a été développée avec Python3 et le framework d'application web Flask. Le design de l'application a été réalisé avec le framework Bootstrap.

Structure de l'application

Vous pouvez consulter l'arbre du dossier de l'application dans le wiki.

Installation

Linux (Ubuntu/Debian)

• Cloner ce repository git en local : git clone https://github.com/HugoSchtr/Annopy

• Installer un environnement virtuel avec Python3 :

  • Assurez-vous que votre version de Python est 3.x : python3 --version
  • Créer un environnement virtuel dans le repository cloné, ou ailleurs en local : virtualenv -p python3 [NOM DE VOTRE ENVIRONNEMENT VIRTUEL]

• Ouvrez un terminal et naviguer jusque dans le dossier courrant de votre environnement virtuel pour le sourcer : source env/bin/activate

• Assurez-vous que vous êtes dans le repository cloné, installer les librairies python de requirements.txt : pip install -r requirements.txt

• Lancez l'application : python3 run.py

Pour relancer l'application plus tard, il suffira de sourcer l'environnement virtuel et de lancer l'application.