VisioNomicon

Visionomicon

VisionOMicon es una poderosa herramienta de utilidad de línea de comandos basada en Python diseñada para cambiar el nombre de los archivos de imagen utilizando las capacidades de GPT-4O. Los nombres de archivo descriptivos se generan en función de una plantilla dada por el usuario y el contenido de la imagen.

Características

• Cambiar el nombre de archivos de imagen basados ​​en nombres de archivo generados de GPT-4V
• Generación de nombres flexibles basada en la estructura dada por el usuario
• Capacidad para crear un archivo de asignación para imágenes renombradas
• Ejecutar el cambio de nombre en función de un archivo de mapeo generado
• Deshacer el cambio de nombre para volver a los nombres de archivo originales
• Paso de verificación para nombres generados usando GPT-4O
• Soporte para múltiples intentos de reintento en caso de validación o errores
• Tipos de archivos compatibles: .png , .jpeg , .jpg , .webp , .gif (no animado)

Requisitos previos

• Python 3.6+
• Acceso a la API de OpenAI con capacidades GPT-4O (requerida la clave API)

Instalación

Puede instalar el paquete usando PIP a través del siguiente comando:

pip install VisioNomicon

Alternativamente, puede instalar manualmente el paquete descargando la distribución de origen y ejecutando los siguientes comandos:

1. Descargue la última distribución de origen de la página de lanzamientos.
2. Extraiga el archivo y navegue al directorio extraído.
3. Ejecute el siguiente comando para instalar:

pip install . 

Uso

Para usar VisionOMicon, debe establecer la variable de entorno OPENAI_API_KEY en su tecla API OpenAI. Esto generalmente se puede hacer con un comando como el siguiente:

 export OPENAI_API_KEY= ' your_api_key_here '

Ejecute el guión con las banderas y argumentos deseados:

VisioNomicon [OPTIONS]

O en un solo comando:

OPENAI_API_KEY= ' your_api_key_here ' VisioNomicon [OPTIONS] 

Opción

• -f , --files : especifique las rutas de archivo de las imágenes para crear mapeo para
• -o , --output : especifique un archivo de mapeo JSON que se creará con rutas de archivo originales y nuevas. El valor predeterminado a $XDG_DATA_HOME/visionomicon/mapping-%Y-%m-%d-%H-%M-%S.json
• -x , --execute : ejecute el cambio de nombre en función del archivo de mapeo existente. Llamar a esto sin un valor utiliza el mapeo creado más recientemente en $XDG_DATA_HOME/visionomicon
• -ox , --mapex : mapear y ejecutar el cambio de nombre en un paso
• -u , --undo : Revertir el cambio de nombre a los nombres de archivo originales utilizando un archivo de mapeo. Llamar a esto sin un valor utiliza el mapeo creado más recientemente en $XDG_DATA_HOME/visionomicon
  • Es importante tener en cuenta que si los nombres o ubicaciones de archivo cambian después de ejecutar una asignación, no podrá deshacer
• -t , --template : defina la plantilla para cambiar el nombre de los archivos de imagen, sin extensión de archivo. Se recomienda usar soportes cuadrados para definir elementos del nombre de archivo. El valor predeterminado a [SubjectDescription]_[MainColor/ColorScheme]_[StyleOrFeel]_[CompositionElement]
• -e , --validation-retries : Especifique el número de reintentos para la validación de nombres (predeterminados a 3)
• -v , --error-retries : especifique el número de reintentos en caso de errores de OpenAI (predeterminados a 3)
• -E , --ignore-validation-fail : si se alcanza el límite de Validación de requisitos, mapa el archivo al nombre original en lugar de devolver un error
• -V , --ignore-error-fail : si se alcanza el límite de reintentos de error, mapa el archivo al nombre original en lugar de devolver un error
• -b , --create-batch : cree un trabajo por lotes a través de Operai API.
• -B , --retrieve-batch : recupere la salida de trabajo por lotes a través de la API de OpenAI. Ejecute esto 24 horas después de crear el trabajo por lotes.

Comandos de ejemplo

VisioNomicon -f image1.jpg image2.png -ox

Este es el uso más directo. Se crea un archivo de mapeo para las imágenes, colocadas en la ubicación predeterminada ( $XDG_DATA_HOME/visionomicon/mapping-%Y-%m-%d-%H-%M-%S.json ). Inmediatamente después, este archivo se ejecuta, cambiando el nombre de los archivos.

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

Este comando creará un archivo de mapeo de cambio de nombre para image1.jpg e image2.png basado en la plantilla proporcionada y emitir la asignación a mapping.json .

Posteriormente, puede ejecutar la asignación, cambiando el nombre de los archivos.

VisioNomicon -x mapping.json

Esto también se puede hacer en un solo comando si lo desea, usando -ox :

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

Limitaciones

• GPT-4O está limitado en los tipos de archivos que puede manejar (.png, .jpeg, .jpg, .webp, no animado .gif) y el tamaño (hasta 20 mb)
• Con algunas plantillas puede ser bastante quisquilloso, no generar los nombres de archivo que podría esperar

Que contribuye

Las contribuciones son bienvenidas. Abra primero un problema para discutir lo que le gustaría cambiar o agregar.

Licencia

Este proyecto tiene una fuente abierta bajo la licencia GLP-3.0.

Descargo de responsabilidad

Esta herramienta no está afiliada a OpenAI. La funcionalidad está sujeta a cambios basados ​​en actualizaciones de la API o los términos de servicio proporcionados por OpenAI.