VisioNomicon

Sigunomicon

Visionomicon是一种功能强大的基于Python的命令行实用工具，旨在使用GPT-4O的功能重命名图像文件。描述性文件名是根据用户给定模板和图像内容生成的。

特征

• 基于GPT-4V生成的文件名重命名图像文件
• 基于用户给定的结构的灵活名称生成
• 能够为重命名的图像创建映射文件
• 根据生成的映射文件执行重命名
• 撤消重命名以恢复原始文件名
• 使用GPT-4O生成名称的验证步骤
• 在验证或错误时支持多次重试尝试
• 受支持的文件类型： .png ， .jpeg ， .jpg ， .webp ， .gif （未动画）

先决条件

• Python 3.6+
• 访问具有GPT-4O功能的OpenAI API（需要API密钥）

安装

您可以通过PIP通过以下命令安装软件包：

pip install VisioNomicon

另外，您可以通过下载源分布并运行以下命令来手动安装软件包：

1. 从“版本”页面下载最新的源分发。
2. 提取文件并导航到提取的目录。
3. 运行以下命令以安装：

pip install . 

用法

要使用Visionomicon，您需要将OPENAI_API_KEY环境变量设置为OpenAI API键。通常可以使用以下命令来完成：

 export OPENAI_API_KEY= ' your_api_key_here '

用所需的标志和参数运行脚本：

VisioNomicon [OPTIONS]

或一个单个命令：

OPENAI_API_KEY= ' your_api_key_here ' VisioNomicon [OPTIONS] 

选项

• -f ， --files ：指定图像的文件路径以创建映射
• -o ， --output ：指定使用原始文件和新文件路径创建的JSON映射文件。默认为$XDG_DATA_HOME/visionomicon/mapping-%Y-%m-%d-%H-%M-%S.json
• -x ， --execute ：根据现有映射文件执行重命名。在没有值的情况下调用此数字使用$XDG_DATA_HOME/visionomicon中的最新创建的映射
• -ox ， --mapex ：一个步骤中的地图和执行重命名
• -u ， --undo ：使用映射文件将重命名为原始文件名。在没有值的情况下调用此数字使用$XDG_DATA_HOME/visionomicon中的最新创建的映射
  • 重要的是要注意，如果执行映射后，文件名或位置更改，您将无法撤消
• -t ， --template ：定义用于重命名图像文件的模板，而无需文件扩展名。建议使用方括号来定义文件名的元素。默认为[SubjectDescription]_[MainColor/ColorScheme]_[StyleOrFeel]_[CompositionElement]
• -e ， --validation-retries ：指定名称验证的重试数（默认为3）
• -v ， --error-retries ：在发生OpenAI错误时指定重试的数量（默认为3）
• -E ， --ignore-validation-fail ：如果达到验证重试限制，请映射到原始名称而不是返回错误
• -V ， --ignore-error-fail ：如果达到了错误重试限制，请映射到原始名称而不是返回错误
• -b ， --create-batch ：通过OpenAI API创建批处理作业。
• -B ， --retrieve-batch ：通过OpenAI API检索批处理作业输出。创建批处理作业后24小时运行此操作。

示例命令

VisioNomicon -f image1.jpg image2.png -ox

这是最直接的用法。为图像创建映射文件，放置在默认位置（ $XDG_DATA_HOME/visionomicon/mapping-%Y-%m-%d-%H-%M-%S.json ）。此后，立即执行此文件，重命名文件。

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

此命令将根据提供的模板为image1.jpg和image2.png创建重命名映射文件，并将映射输出到mapping.json 。

随后，您可以执行映射，重命名文件。

VisioNomicon -x mapping.json

如果您愿意，使用-ox ：

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

限制

• GPT-4O在可以处理的文件类型中受到限制（.png，.jpeg，.jpg，.webp，non-Animated .gif）和大小（最高20MB）
• 有了一些模板，它可能很挑剔，并不是真正产生您可能期望的文件名

贡献

欢迎捐款。请先开开一个问题，以讨论您想更改或添加的内容。

执照

该项目是根据GLP-3.0许可证开源的。

免责声明

该工具与OpenAI不关联。该功能可能会根据对API的更新或OpenAI提供的服务条款进行更改。