VisioNomicon

Visionomicon

Visionomicon est un puissant outil d'utilité de ligne de commande basé sur Python conçu pour renommer les fichiers d'image à l'aide des capacités de GPT-4O. Des noms de fichiers descriptifs sont générés en fonction d'un modèle donné par l'utilisateur et du contenu de l'image.

Caractéristiques

• Renommer les fichiers d'image basés sur des noms de fichiers générés à partir de GPT-4V
• Génération de noms flexible en fonction de la structure donnée par l'utilisateur
• Capacité à créer un fichier de mappage pour les images renommées
• Exécuter le changement de nom en fonction d'un fichier de mappage généré
• Annuler le renommage pour revenir aux noms de fichiers d'origine
• Étape de vérification pour les noms générés à l'aide de GPT-4O
• Prise en charge de plusieurs tentatives de réessayer en cas de validation ou d'erreurs
• Types de fichiers pris en charge: .png , .jpeg , .jpg , .webp , .gif (non animé)

Condition préalable

• Python 3.6+
• Accès à l'API OpenAI avec les capacités GPT-4O (clé API requise)

Installation

Vous pouvez installer le package à l'aide de PIP via la commande suivante:

pip install VisioNomicon

Alternativement, vous pouvez installer manuellement le package en téléchargeant la distribution source et en exécutant les commandes suivantes:

1. Téléchargez la dernière distribution source à partir de la page des versions.
2. Extraire le fichier et accéder au répertoire extrait.
3. Exécutez la commande suivante pour installer:

pip install . 

Usage

Pour utiliser Visionomicon, vous devez définir la variable d'environnement OPENAI_API_KEY sur votre clé API OpenAI. Cela peut généralement être fait avec une commande comme la suivante:

 export OPENAI_API_KEY= ' your_api_key_here '

Exécutez le script avec les drapeaux et arguments souhaités:

VisioNomicon [OPTIONS]

Ou dans une seule commande:

OPENAI_API_KEY= ' your_api_key_here ' VisioNomicon [OPTIONS] 

Options

• -f , --files : spécifiez les chemins de fichier des images pour créer une mappage pour
• -o , --output : spécifiez un fichier de mappage JSON à créer avec des chemins de fichier originaux et nouveaux. Les défauts sont par défaut à $XDG_DATA_HOME/visionomicon/mapping-%Y-%m-%d-%H-%M-%S.json
• -x , --execute : exécuter le renommage en fonction du fichier de mappage existant. Appeler ceci sans une valeur utilise la mappage la plus récemment créée dans $XDG_DATA_HOME/visionomicon
• -ox , --mapex : mappez et exécutez le renommage en une seule étape
• -u , --undo : réintégrer le renom sur les noms de fichiers d'origine à l'aide d'un fichier de mappage. Appeler ceci sans une valeur utilise la mappage la plus récemment créée dans $XDG_DATA_HOME/visionomicon
  • Il est important de noter que si les noms de fichiers ou les emplacements changent après l'exécution d'un mappage, vous ne pourrez pas annuler
• -t , --template : Définissez le modèle pour le renommer des fichiers image, sans extension de fichier. Il est recommandé d'utiliser des crochets pour définir les éléments du nom de fichier. Par défaut à [SubjectDescription]_[MainColor/ColorScheme]_[StyleOrFeel]_[CompositionElement]
• -e , --validation-retries : Spécifiez le nombre de tentatives pour la validation du nom (par défaut à 3)
• -v , --error-retries : Spécifiez le nombre de tentatives en cas d'erreurs OpenAI (par défaut en 3)
• -E , --ignore-validation-fail : Si la limite de validation Retries est atteint, le fichier mappe au nom d'origine au lieu de renvoyer une erreur
• -V , --ignore-error-fail : Si l'erreur rétracte la limite, le fichier mappe au nom d'origine au lieu de renvoyer une erreur
• -b , --create-batch : Créez un travail par lots via API OpenAI.
• -B , --retrieve-batch : Récupérez la sortie du travail de lots via l'API OpenAI. Exécutez ces 24 heures après la création du travail par lots.

Exemples de commandes

VisioNomicon -f image1.jpg image2.png -ox

C'est l'usage le plus simple. Un fichier de mappage est créé pour les images, placée à l'emplacement par défaut ( $XDG_DATA_HOME/visionomicon/mapping-%Y-%m-%d-%H-%M-%S.json ). Immédiatement après, ce fichier est exécuté, renommant les fichiers.

VisioNomicon -f image1.jpg image2.png -o mapping.json -t " [Object]_[Color]_[Style] "

Cette commande créera un fichier de mappage de renommée pour image1.jpg et image2.png basé sur le modèle fourni et sortira le mappage à mapping.json .

Par la suite, vous pouvez exécuter le mappage, renommant les fichiers.

VisioNomicon -x mapping.json

Cela peut également être fait dans une seule commande si vous le souhaitez, en utilisant -ox :

VisioNomicon -f image1.jpg image2.png -ox mapping.json -t " [Object]_[Color]_[Style] " 

Limites

• GPT-4O est limité dans les types de fichiers qu'il peut gérer (.png, .jpeg, .jpg, .webp, non animé .gif), et la taille (jusqu'à 20 Mo)
• Avec certains modèles, il peut être assez capricieux, ne générant pas vraiment les noms de fichiers auxquels vous pourriez vous attendre

Contributif

Les contributions sont les bienvenues. Veuillez d'abord ouvrir un problème pour discuter de ce que vous souhaitez modifier ou ajouter.

Licence

Ce projet est open source sous la licence GLP-3.0.

Clause de non-responsabilité

Cet outil n'est pas affilié à OpenAI. La fonctionnalité est sujette à un changement en fonction des mises à jour de l'API ou des conditions d'utilisation fournies par OpenAI.