Tutoriel Arkindex – pictorIA
Tutoriel réalisé par Pierre Husson, Fantin Le Ber et Mathieu Taybi.
Présentation :
Arkindex est une plateforme open-source développée par l’entreprise Teklia consacrée au traitement et à l’analyse des images à l’aide d’outils d’intelligence artificielle. PictorIA possède une instance de la plateforme Arkindex, hebergée sur les serveurs d’Huma-Num : https://pictoria-doc.huma-num.fr/
À l’issue de ce tutoriel, si vous rencontrez d’autres difficultés pour utiliser la plateforme, n’hésitez pas à entrer en contact avec les membres du consortium PictorIA ou à formuler une demande sur le forum d’assistance, disponible à l’adresse suivante : https://support.teklia.com/
Nous vous invitons également de remplir le formulaire suivant au moment de la création de compte, pour nous permettre de savoir qui utilise sur la plateforme : https://forms.gle/UNFx5oRtt7s7Y5fE7 .
1. Création du compte
Pour créer un compte, rendez-vous sur l’instance PictorIA d’Arkindex (https://pictoria-doc.huma-num.fr/) puis sur la page REGISTER.

Remplissez les informations demandées. Pour terminer votre inscription, cliquez sur le lien de confirmation qui vous sera envoyé par e-mail. Vous pouvez vous connecter à votre compte à l’aide de la page LOG IN.
2. Création d’un projet
Pour créer un projet, appuyez sur le bouton NEW PROJECT en haut à droite.

Dans la page New project, indiquez le titre et une description si vous le souhaitez, puis appuyez sur CREATE. (Si vous voulez ajouter des membres à votre projet, consultez la section 7.A “Ajouter des membres” de ce tutoriel).

3. Importer des images
Pour importer des images dans votre projet, ouvrez le menu Import / Export en haut à droite de la page de votre projet, puis cliquez sur Import files.

Appuyez sur SELECT FILES pour importer des images depuis votre ordinateur

Les images sont ensuite préparées pour l’importation et un manifeste IIIF est créé pour chaque image.

Des paramètres avancés sont disponibles, il n’est pas recommandé de les modifier, vous pouvez consulter la documentation de Teklia à ce propos : https://doc.arkindex.org/project/element et https://doc.arkindex.org/project/type
Une fois que toutes les images sont préparées, appuyez sur IMPORT en bas de la page.

Le processus d’importation est lancé.

Une fois le processus terminé, vous pouvez consulter vos images dans le menu ACTIONS puis en appuyant sur View element .

Les images ont été importées dans un nouveau dossier dans votre projet. Vous pouvez renommer ce dossier à l’aide du crayon à droite du nom (Folder : Import images…).

4. Lancer un processus de traitement
Pour lancer un processus de traitement, rendez-vous dans le dossier contenant les images que vous avez importées. Dans le menu Processes en haut à droite, cliquer sur Create inference process.

A. Sélectionner les images à traiter
La page Filter process elements s’affiche, pour sélectionner toutes les images du dossier, cochez la case Load children. Cette action permet d’appliquer les traitements aux enfants du dossier sélectionné. Toutes les images seront listées en dessous. Vous pouvez également les filtrer par nom ou par type.
Appuyez ensuite sur CONFIGURE WORKERS pour choisir les modèles qui traiteront les images.

B. Ajouter un worker
Sur la page Configure process (image 13), vous pouvez :
- choisir un Template, c’est-à-dire une chaîne de traitement déjà configurée
- créer votre propre chaîne de traitement en sélectionnant un worker
Dans Arkindex, un worker est un outil qui contient un algorithme ou un modèle d’intelligence artificielle qui sera appliqué aux images (consulter la documentation pour plus d’informations : https://doc.arkindex.org/workers/)

Les workers pour lesquels vous disposez des droits d’utilisation sont proposés dans le menu à gauche de la fenêtre Add worker versions to your process (voir ci-dessous). Pour ajouter le worker que vous avez sélectionné, appuyez sur ADD TO PROCESS puis sur DONE pour sortir de la fenêtre.
L’utilisation de certains workers est payante (ChatGPT, Gemini,…).
Pour obtenir l’accès à d’autres worker, contactez l’administrateur de votre instance.
Ces workers sont décrits par des tags indiquant leur type d’utilisation : https://doc.arkindex.org/workers/advanced/#worker-types.
Teklia propose quelques exemples d’utilisation des workers : https://notes.teklia.com/p1y9aSDCTpa83qWr6TPFyw#
Nous vous invitons à vous adresser à un expert chez PictorIA ou chez Teklia pour connaître les workers les plus adaptés à votre corpus et à votre projet. Nous utiliserons pour ce tutoriel deux workers YOLO segmenter pré-entraînés : le premier pour identifier les photographies dans des pages d’albums, le second pour identifier les personnes dans ces photographies.

C. Configurer le Worker
Une fois que vous avez ajouté un worker à la chaîne de traitement, vous pouvez le configurer (image 15). Si un ⚠️ s’affiche à côté d’un des paramètres, vous devez préciser des paramètres avant de pouvoir utiliser ce worker. Voici les paramètres :
- Model Version : pour choisir la version pré-entraîné du modèle contenu dans le worker
- GPU : si le modèle nécessite d’utiliser beaucoup de puissance de calcul et donc un GPU (processeur graphique, ou graphics processing unit). Pour les modèles comme les LLM qui nécessitent impérativement son utilisation, la case est déjà cochée.
- Configuration : pour indiquer des paramètres à prendre en compte par le modèle lors du traitement (le prompt, des classes à appliquer…)

Si le worker nécessite de choisir une version du modèle, appuyez sur le +. Une fenêtre s’affiche avec la liste des versions à gauche. Appuyez sur USE pour sélectionner un modèle.

D. Précision sur la chronologie des traitements
Vous pouvez paramétrer une succession de traitements. Cependant, cela ne définit qu’un ordre d’exécution des tâches, sans changer l’élément concerné par les actions. Ainsi, le second worker ne traite pas le résultat produit par le premier worker dont il est dépendant, mais s’applique sur l’élément sélectionné à l’origine de la chaîne de traitement (la page par exemple).
Ici le worker YOLO avec pour modèle World Person succède au traitement du worker YOLO avec pour modèle Hikaria sans s’appliquer aux photographies identifiées par le premier. Le processus se déroule ainsi :
- Le worker YOLO Hikaria identifie une photographie dans un album et la segmente.
- Le worker YOLO World person identifie les personnes dans la page d’album (et non dans la photographie déjà segmentée).
Pour que le second worker s’applique aux photographies segmentées par le premier, il aurait fallu lancer un nouveau processus de traitement (étape 4) et l’appliquer uniquement sur les éléments “photography”.
Une fois le processus de traitement configuré, appuyez sur RUN PROCESS pour le lancer.

Une page s’ouvre présentant l’évolution du processus. Lorsque tous les traitements sont terminés, ils s’affichent en vert.

5. Consulter les résultats
Une fois le processus de traitement terminé, vous pouvez ensuite consulter les éléments en cliquant sur le menu ACTIONS puis View element.

Vous pouvez consulter les résultats du traitement en cliquant sur une image. En fonction des workers utilisés, ils s’afficheront dans les différents panneaux entourant l’image.

Sur l’image ci-dessus on peut voir que le premier worker YOLO HikarIA a identifié la photographie dans l’album, le second worker YOLO World person a identifié les personnes présentes.
6. Export des données
Dans la page du dossier des images, vous pouvez exporter les données dans le menu Import / Export.

Appuyez ensuite sur START EXPORT. Une fois l’export terminé, cliquez sur le bouton de téléchargement.


7. Étapes optionnelles
A. Ajouter des membres au projet
Pour ajouter des membres à votre projet, allez sur la page Project puis rendez vous dans les paramètres du projet en cliquant sur Project information (dans le menu Project en haut à droite) ou en cliquant sur le crayon à côté du nom de votre projet en haut à gauche.

Dans l’onglet Members, vous pouvez ajouter des utilisateurs (user) ou des groupes (image 25). Pour un utilisateur, indiquez l’adresse mail du compte Arkindex de votre collaborateur. Vous pouvez configurer son rôle :
- l’administrateur (administrator) a tous les droits sur le projet
- le contributeur (contributor) n’a pas accès à tous les droits, notamment l’ajout de membres,… Il peut effectuer des traitements sur les images.
- l’invité (guest) peut seulement consulter le projet mais ne peut rien éditer
Consulter la documentation pour en apprendre plus sur les droits de chaque rôle: https://doc.arkindex.org/users/rights/

B. Exporter les images vers Callico pour les annoter
Pour l’utilisation de Callico, un tutoriel dédié sera bientôt en ligne.
Si vous souhaitez exporter les images vers Callico, l’outil d’annotation collaboratif de Teklia, afin de créer une campagne d’annotation des images, rendez-vous dans les informations du projet (Project information) pour récupérer l’identifiant du projet.

Copiez l’identifiant du projet (Project ID) et collez le dans Callico lors de la création de votre campagne d’annotation.

Enfin, si vous rencontrez d’autres difficultés pour utiliser la plateforme, n’hésitez pas à entrer en contact avec les membres du consortium PictorIA ou à formuler une demande sur le forum d’assistance, disponible à l’adresse suivante : https://support.teklia.com/
OpenEdition vous propose de citer ce billet de la manière suivante :
fleber (28 juillet 2025). Tutoriel Arkindex – pictorIA. Consortium-HN pictorIA. Consulté le 20 mai 2026 à l’adresse https://pictoria.hypotheses.org/4362

