Ressources numériques en sciences humaines et sociales OpenEdition Nos plateformes OpenEdition Books OpenEdition Journals Hypothèses Calenda Bibliothèques OpenEdition Freemium Suivez-nous

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.

L'écran d'accueil d'arkindex, le bouton "Register", en haut à droite, est encadré en rouge.
Img 1 : Création du compte.

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.

L'écran d'Arkindex après connexion. Le bouton NEW PROJECT, en haut à droite, est entouré en rouge.
Img. 2 : Page Projects avec 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).

La page NEW PROJECT d'Arkindex
Img. 3 : Page New Project.

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.

L'écran du projet d'Arkindex, le menu déroulant Import/Export est encadré en rouge.
Img. 4 : Page du projet avec le bouton Import files dans le menu Import / Export en haut à droite.

Appuyez sur SELECT FILES pour importer des images depuis votre ordinateur

L'écran d'import d'images d'Arkindex, le bouton "select files", au milieu de l'écran, est encadré en rouge.
Img. 5 Page Import Files.

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

Ecran de préparation des images avant l'import.
Img. 6 : Préparation des images pour l’import.

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.

Une reprise de l'image précédente, zoomée sur le bouton "import", encadré en rouge.
Img. 7 : Advanced settings et bouton Import en bas de la page à la fin de la préparation des images.

Le processus d’importation est lancé.

L'écran d'import, avec les logs des images importées.
Img. 8 : Processus d’importation en cours.


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

L'écran de chargement des imports, l'import est terminé, le menu ACTIONS et l'option "view element" sont encadrés.
Img. 9 : Fin de l’importation.

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…).

Le  dossier importé.
Img. 10 : Dossier contenant les images importées

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.

Le dossier importé, le menu déroulant Processes (en haut à droite) est ouvert, l'option Create inference process est encadrée.
Img. 11 : Menu Processes avec le bouton 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.

Le menu de selection des éléments sur lesquels on veut appliquer un process. La case "load children" et le bouton CONFIGURE WORKERS sont entourés.
Img. 12 : Page Filter process elements

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/)

La page de configuration des process, les boutons "Select workers" et "Select template", en haut à gauche, sont encadrés.
Img. 13 : Page Configure process

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.

L'écran de configuration des workers. La liste des workers, à gauche, est encadrée, le bouton "add to process" en haut à droite, est encadré et marqué d'un chiffre "1". Le bouton "DONE" en bas à droite est encadré et marqué d'un chiffre "2".
Img. 14 : Choix du worker

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…)
L'écran de configuration de process, le bouton pour sélectionner le modèle, au milieu de l'écran, est encadré en rouge.
Img. 15 : Un worker a été ajouté, choix des paramètres

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.

L'écran de sélection des modèles, la liste des modèles disponibles, à gauche, et les boutons "Use" à droite sont encadrés.
Img. 16 : Choix de la version du modèle pour le worker

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.

La page de configuration des process, deux modèles yolo sont chargés. La colonne "Dependencies", sur la droite, et le bouton run process, en bas à droite, sont encadrés.
Img. 17 : Le processus est configuré, il est prêt à être lancé

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

L'écran de statut du process.
Img. 18 : Processus en cours de traitement

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.

Ecran de statut des process, les process sont terminés, les boutons Actions et view element, en haut à droite, sont encadrés.
Img. 19 : fin du processus, retour vers le dossier des images.

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.

L'écran d'affichage d'une page post traitement, une photographie est encadrée, les personnages sur cette photographie aussi.
Img. 20 : Consultation des résultats

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.

L'écran de consultation d'un dossier, le bouton et le menu déroulant Import/export, en haut à droite, sont encadrés.
Img. 21 : Export des données dans le dossier des images

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

L'écran d'export avant la création de l'export
Img. 22 : Export au format base de données
L'écran d'export une fois la base de données créée
Img. 23 : Après le rafraîchissement (REFRESH), l’export peut être téléchargé

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.

Img. 24 : Accès aux paramètres du projet à partir de la page Project

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/ 

L'écran d'ajout et de gestion des membres.
Img. 25 : Ajout d’un membre et sélection de son rôle.

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.

écran d'accueil du projet. Le menu déroulant "project" et le logo crayon à côté du titre du projet sont entourés en rouge.
Img. 26 : Accès aux paramètres du projet à partir de la page Project

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

L'écran d'informations du projet, le bouton "copier l'identifiant du projet", en haut à gauche, est encadré en rouge.
Img. 27 : Copier l’identifiant du projet

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


Vous aimerez aussi...