imgnorm

AI图像处理工具集 —— 涵盖图片等比缩放、Flux Kontext / GPT 图像尺寸适配、比例分析、违禁词检测、ComfyUI服务管理等场景。

特性

图片缩放与归一化
- image_resize：等比缩放并居中放置到指定画布，支持自定义背景色
- ImageTool：多功能比例调整，支持标准比例匹配、fill/resize双模式、自定义放大百分比
AI 模型尺寸适配
- FluxKontextImageScale：自动匹配 17 个 Flux Kontext 优选分辨率并缩放
- GPTImageSizeCalculator：根据比例 + 分辨率档位（1k/2k/4k）生成 gpt-image-2 合法尺寸
图片比例分析
- ImageRatioAnalyzer：获取精确最简比例（GCD 约分）或近似简单整数比例
内容安全
- PromptBanChecker：内置加密违禁词库开箱即用，支持自定义词库合并、排除词、Aho-Corasick 大词库加速
ComfyUI 服务管理
- ComfyUIManager：一键触发重启 + 轮询等待服务恢复

安装

pip install imgnorm

可选扩展：

pip install imgnorm[fast]     # 大词库 Aho-Corasick 加速（推荐词库 >50 时安装）
pip install imgnorm[comfyui]  # ComfyUI 服务管理功能
pip install imgnorm[dev]      # 开发环境（包含全部扩展 + pytest）

使用示例

image_resize — 等比缩放居中

from PIL import Image
from imgnorm import image_resize

# 打开图片
img = Image.open("input.jpg")

# 缩放到 640x480，默认黑色背景
result = image_resize(img, 640, 480)
result.save("output.jpg")

# 自定义背景颜色（白色）
result = image_resize(img, 640, 480, bg_color=(255, 255, 255))
result.save("output_white.jpg")

FluxKontextImageScale — Flux Kontext 优选分辨率缩放

from PIL import Image
from imgnorm import FluxKontextImageScale

img = Image.open("input.jpg")

# 自动匹配最接近原图宽高比的 Flux Kontext 优选分辨率并缩放
scaler = FluxKontextImageScale(img)
result = scaler.start()
result.save("output_kontext.jpg")

ImageTool — 多功能比例调整工具

from imgnorm import ImageTool

# 读取图片二进制数据
with open("input.jpg", "rb") as f:
    image_bytes = f.read()

# 自动匹配最接近的标准比例，最小边放大 10%（默认）并填充透明背景
tool = ImageTool()
result_bytes = tool.adjust_size(image_bytes)

# 自定义放大百分比（放大 20%）
result_bytes = tool.adjust_size(image_bytes, expand_percent=20)

# 不缩放（expand_percent=0）
result_bytes = tool.adjust_size(image_bytes, expand_percent=0)

# 指定目标比例 3:4，使用 resize 模式
tool = ImageTool(proportion="3:4", need_adjust="resize")
result_bytes = tool.adjust_size(image_bytes)

# 指定目标比例 1:1，自定义填充色（白色不透明）
tool = ImageTool(proportion="1:1", need_adjust="fill", fill_color=(255, 255, 255, 255))
result_bytes, matched_ratio = tool.adjust_size(image_bytes, return_origin_ratio=True)
print(f"原图匹配比例: {matched_ratio}")

# 保存结果
with open("output.png", "wb") as f:
    f.write(result_bytes)

GPTImageSizeCalculator — gpt-image-2 尺寸计算器

from imgnorm import GPTImageSizeCalculator

# 计算 16:9 比例、2K 分辨率的合法尺寸
result = GPTImageSizeCalculator.calc_size(aspect_ratio="16:9", resolution="2k")
print(result)
# {'width': 2560, 'height': 1440, 'size': '2560x1440', 'pixels': 3686400, 'aspect_ratio': '16:9', 'resolution': '2k', 'valid': True}

# 计算 1:1 比例、4K 分辨率的合法尺寸
result = GPTImageSizeCalculator.calc_size(aspect_ratio="1:1", resolution="4k")
print(result['size'])  # 2880x2880

# 校验尺寸是否合法
is_valid = GPTImageSizeCalculator.is_valid_image_size(1024, 1024)  # True

# 比例超过 3:1 时，默认自动钳位到最近合法比例（保持横竖方向）
result = GPTImageSizeCalculator.calc_size(aspect_ratio="1:10", resolution="4k")
print(result['size'])  # 1280x3840（自动调整为 1:3）

# 严格模式：超限比例直接抛出异常
result = GPTImageSizeCalculator.calc_size(aspect_ratio="1:10", resolution="4k", strict=True)
# → ServiceError: 图像宽高比不合法, 相差太大

ImageRatioAnalyzer — 图片比例分析器

from imgnorm import ImageRatioAnalyzer

with open("input.jpg", "rb") as f:
    image_bytes = f.read()

analyzer = ImageRatioAnalyzer()

raw_ratio = analyzer.get_raw_simple_ratio(image_bytes)
# 精确比例: 74:55
print(f"精确比例: {raw_ratio}")

approx_ratio = analyzer.get_approx_simple_ratio(image_bytes)
# 近似比例: 4:3
print(f"近似比例: {approx_ratio}")

# 调整搜索范围（默认 1~10，增大可匹配更复杂比例）
analyzer = ImageRatioAnalyzer(approx_search_range=20)
# 19:14
print(analyzer.get_approx_simple_ratio(image_bytes))
# 74:55
print(analyzer.get_raw_simple_ratio(image_bytes))

ComfyUIManager — ComfyUI 服务管理

import logging
from imgnorm import ComfyUIManager

# 配置日志（可选）
logger = logging.getLogger("comfyui")
logging.basicConfig(level=logging.DEBUG)

# 创建管理器（默认连接本地 8188 端口）
manager = ComfyUIManager(logger=logger)

# 发起重启并等待服务恢复
success = manager.run_reboot_and_wait()
if success:
    print("服务重启成功")
else:
    print("服务重启超时")

# 自定义配置
manager = ComfyUIManager(
    base_url="http://127.0.0.1:8188",
    timeout=10,
    max_wait_seconds=120,
    poll_interval=3.0,
    logger=logger
)

PromptBanChecker — 提示词违禁词检测

from imgnorm import PromptBanChecker, PromptBanError

# 1. 开箱即用：自动加载内置加密违禁词库（1300+ 词）
checker = PromptBanChecker()

# 2. 内置词库 + 自定义文件合并
checker = PromptBanChecker(ban_word_file="my_words.txt")

# 3. 内置词库 + 运行时注入额外词
checker = PromptBanChecker(builtin_words=["自定义违禁词1", "自定义违禁词2"])

# 4. 排除内置词库中的某些词
checker = PromptBanChecker(exclude_words=["nude", "色情"])

# 5. 关闭内置词库，完全使用自己的
checker = PromptBanChecker(use_default=False, ban_word_file="my_words.txt")

# 校验提示词
try:
    checker.check("some prompt text here")
    print("校验通过")
except PromptBanError as e:
    print(f"违禁词拦截: {e.error_msg}")
    print(f"命中词: {e.extend_data}")

# 查找所有命中词（不抛异常）
hits = checker.find_matched_words("text to check")
print(f"命中: {hits}")

# 重新加载违禁词
checker.load_banned_words()

违禁词加载顺序： 包内置默认词库 → builtin_words 参数 → ban_word_file 用户文件，三者自动合并去重。

性能引擎： 词库 < 50 词自动使用正则预编译；≥ 50 词且已安装 pyahocorasick 时自动切换 Aho-Corasick 算法（O(n) 扫描，与词库大小无关）。

API 说明

`image_resize(image, target_w, target_h, bg_color=(0, 0, 0))`

将图片等比缩放并居中放置到指定尺寸的画布上。

参数	类型	说明
`image`	`PIL.Image.Image`	输入图片对象
`target_w`	`int`	目标宽度
`target_h`	`int`	目标高度
`bg_color`	`tuple`	画布背景颜色（RGB 元组），默认黑色 `(0, 0, 0)`

返回值： 缩放并居中后的 PIL.Image.Image 对象。

处理逻辑：

创建指定尺寸和背景色的画布
计算等比缩放比例（取宽、高缩放比的最小值），确保图片完整放入画布
使用 LANCZOS 算法高质量缩放图片
计算居中偏移量，将缩放后的图片粘贴到画布中央

`FluxKontextImageScale(image)`

根据原图宽高比，将图片缩放到最接近的 Flux Kontext 优选分辨率。

参数	类型	说明
`image`	`PIL.Image.Image`	输入图片对象

方法 start()： 计算原图宽高比，从 17 个优选分辨率中匹配最接近的一个，使用 LANCZOS 算法缩放并返回结果图片。

优选分辨率列表（宽×高）： 672×1568 · 688×1504 · 720×1456 · 752×1392 · 800×1328 · 832×1248 · 880×1184 · 944×1104 · 1024×1024 · 1104×944 · 1184×880 · 1248×832 · 1328×800 · 1392×752 · 1456×720 · 1504×688 · 1568×672

返回值： 缩放后的 PIL.Image.Image 对象。

`ImageTool(proportion=None, need_adjust="fill", fill_color=(255,255,255,0))`

多功能图片尺寸调整工具，支持标准比例匹配和两种调整模式。

参数	类型	说明
`proportion`	`str \| None`	目标比例，如 `"3:4"` / `"1:1"`；空字符串或 `None` 表示自动匹配
`need_adjust`	`str`	调整模式：`"fill"`（画布填充）或 `"resize"`（拉伸）
`fill_color`	`tuple`	填充背景色 RGBA，默认透明 `(255, 255, 255, 0)`

方法 adjust_size(image_bytes, return_origin_ratio=False, expand_percent=10)：

参数	类型	说明
`image_bytes`	`bytes`	图片二进制数据
`return_origin_ratio`	`bool`	是否同时返回原图匹配的标准比例字符串
`expand_percent`	`float`	放大百分比，默认 10（放大 10%）；传 0 不缩放，负数缩小

返回值： bytes（处理后图片数据）；当 return_origin_ratio=True 时返回 (bytes, str)。

标准比例池： 1:1 · 2:3 · 3:2 · 3:4 · 4:3 · 4:5 · 5:4 · 9:16 · 16:9 · 21:9

处理逻辑：

proportion 存在且与原图最接近标准比例不一致 → 直接返回原图
proportion 存在且一致 → 反转比例后执行 resize/fill
proportion 为空且 need_adjust="fill" → 最小边按 expand_percent 放大，画布填充
proportion 为空且 need_adjust="resize" → 单边按 expand_percent 放大后拉伸

`GPTImageSizeCalculator`

gpt-image-2 尺寸计算器，根据比例和分辨率自动生成合法图片尺寸。

类方法：

方法	说明
`calc_size(aspect_ratio="1:1", resolution="2k", strict=False)`	根据比例和分辨率计算合法尺寸
`is_valid_image_size(width, height)`	校验尺寸是否合法
`round_to_multiple(value, multiple=16)`	四舍五入到指定倍数
`floor_to_multiple(value, multiple=16)`	向下对齐到指定倍数，用于像素超限时压缩

calc_size 参数：

参数	类型	说明
`aspect_ratio`	`str`	宽高比，如 `"1:1"` / `"16:9"` / `"4:3"`
`resolution`	`str`	分辨率档位：`"1k"` / `"2k"` / `"4k"`
`strict`	`bool`	是否严格校验宽高比（≤3:1），默认 `False`（超限自动钳位到最近合法比例）；`True` 时超限直接抛出 `ServiceError`

返回值： dict，包含 width、height、size、pixels、aspect_ratio、resolution、valid。

合法性约束：

最大边 ≤ 3840
宽高为 16 的倍数
宽高比 ≤ 3:1
像素范围：655,360 ~ 8,294,400

`ImageRatioAnalyzer(approx_search_range=10)`

图片比例分析工具，获取图片的宽高比信息。

参数	类型	说明
`approx_search_range`	`int`	近似比例搜索整数范围，默认 1~10

方法：

方法	说明
`get_raw_simple_ratio(image_bytes)`	获取精确最简宽高比（GCD 约分）
`get_approx_simple_ratio(image_bytes)`	自动拟合近似简单整数比例

get_raw_simple_ratio： 通过最大公约数约分，返回精确的最简比例字符串，如 1920x1080 → "16:9"。

get_approx_simple_ratio： 遍历 1~approx_search_range 范围内的整数组合，找到与图片实际比例最接近的简单整数比，返回如 "2:3"、"16:9"。

返回值： 比例字符串（str）。

`ComfyUIManager`

ComfyUI 服务管理工具，位于 imgnorm.comfyui 子模块。

参数	类型	说明
`base_url`	`str`	服务地址，默认 `"http://127.0.0.1:8188"`
`timeout`	`int`	请求超时秒数，默认 `5`
`max_wait_seconds`	`int`	最长等待恢复时间，默认 `60`
`poll_interval`	`float`	轮询间隔秒数，默认`2.0`
`logger`	`logging.Logger`	日志记录器，默认使用模块`logger`

方法：

方法	说明
`trigger_reboot()`	发起重启请求，远程断开视为成功
`wait_service_ready()`	轮询检测服务是否恢复，超时返回`False`
`run_reboot_and_wait()`	完整流程：重启 + 等待，返回`bool`

工作原理：

调用 /api/manager/reboot 接口触发重启
轮询 /api/system_stats 接口，状态码 200 判定恢复
超时未恢复返回 False

安装： 使用 comfyui 功能需额外安装 requests：

pip install imgnorm[comfyui]
# 或
pip install requests>=2.20.0

`PromptBanChecker(ban_word_file=None, ignore_case=True, builtin_words=None, use_default=True, exclude_words=None)`

提示词违禁词校验工具。内置加密违禁词库开箱即用，支持多来源词库合并、排除词、大词库自动加速。

参数	类型	说明
`ban_word_file`	`str \| None`	用户自定义违禁词文件路径（可选，支持 `.txt` / `.pkl` / `.pickle`）
`ignore_case`	`bool`	是否忽略大小写，默认 `True`
`builtin_words`	`list[str] \| None`	运行时注入的违禁词列表，与内置词库合并去重
`use_default`	`bool`	是否加载包内置默认违禁词库，默认 `True`
`exclude_words`	`list[str] \| None`	从最终词库中排除的词列表

方法：

方法	说明
`check(prompt)`	校验提示词，命中则抛出 `PromptBanError`
`find_matched_words(text)`	查找所有命中词，返回列表
`load_banned_words()`	重新加载并合并所有来源的违禁词
`create_pickle_file(words, output_path)`	静态方法：将词列表序列化为 pickle 文件

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

imgnorm-1.0.3-cp314-cp314-win_amd64.whl (271.7 kB view details)

Uploaded Aug 9, 2026 CPython 3.14Windows x86-64

imgnorm-1.0.3-cp314-cp314-manylinux_2_17_x86_64.whl (1.7 MB view details)

Uploaded Aug 9, 2026 CPython 3.14manylinux: glibc 2.17+ x86-64

imgnorm-1.0.3-cp313-cp313-win_amd64.whl (265.9 kB view details)

Uploaded Aug 9, 2026 CPython 3.13Windows x86-64

imgnorm-1.0.3-cp313-cp313-manylinux_2_17_x86_64.whl (1.7 MB view details)

Uploaded Aug 9, 2026 CPython 3.13manylinux: glibc 2.17+ x86-64

imgnorm-1.0.3-cp312-cp312-win_amd64.whl (269.9 kB view details)

Uploaded Aug 9, 2026 CPython 3.12Windows x86-64

imgnorm-1.0.3-cp312-cp312-manylinux_2_17_x86_64.whl (1.7 MB view details)

Uploaded Aug 9, 2026 CPython 3.12manylinux: glibc 2.17+ x86-64

imgnorm-1.0.3-cp311-cp311-win_amd64.whl (268.2 kB view details)

Uploaded Aug 9, 2026 CPython 3.11Windows x86-64

imgnorm-1.0.3-cp311-cp311-manylinux_2_17_x86_64.whl (1.6 MB view details)

Uploaded Aug 9, 2026 CPython 3.11manylinux: glibc 2.17+ x86-64

imgnorm-1.0.3-cp310-cp310-win_amd64.whl (269.0 kB view details)

Uploaded Aug 9, 2026 CPython 3.10Windows x86-64

imgnorm-1.0.3-cp310-cp310-manylinux_2_17_x86_64.whl (1.6 MB view details)

Uploaded Aug 9, 2026 CPython 3.10manylinux: glibc 2.17+ x86-64

imgnorm-1.0.3-cp39-cp39-win_amd64.whl (270.3 kB view details)

Uploaded Aug 9, 2026 CPython 3.9Windows x86-64

imgnorm-1.0.3-cp39-cp39-manylinux_2_17_x86_64.whl (1.6 MB view details)

Uploaded Aug 9, 2026 CPython 3.9manylinux: glibc 2.17+ x86-64

imgnorm-1.0.3-cp38-cp38-win_amd64.whl (276.2 kB view details)

Uploaded Aug 9, 2026 CPython 3.8Windows x86-64

imgnorm-1.0.3-cp38-cp38-manylinux_2_17_x86_64.whl (1.6 MB view details)

Uploaded Aug 9, 2026 CPython 3.8manylinux: glibc 2.17+ x86-64

File details

Details for the file imgnorm-1.0.3-cp314-cp314-win_amd64.whl.

File metadata

Download URL: imgnorm-1.0.3-cp314-cp314-win_amd64.whl
Upload date: Aug 9, 2026
Size: 271.7 kB
Tags: CPython 3.14, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for imgnorm-1.0.3-cp314-cp314-win_amd64.whl
Algorithm	Hash digest
SHA256	`ddc64cf6679a409a8479d584405c7bda0029237c9dc06d74f057ad83698b3afe`
MD5	`5ae1fa418910f3c7f90be5348c972029`
BLAKE2b-256	`29b354d1be87f291c72b5e200ccf6fe9dab49cf78f71103b1d9d6735e16972c4`

See more details on using hashes here.

Provenance

The following attestation bundles were made for imgnorm-1.0.3-cp314-cp314-win_amd64.whl:

Publisher: wheels.yml on zhenzi0322-package/imgnorm

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: imgnorm-1.0.3-cp314-cp314-win_amd64.whl
- Subject digest: ddc64cf6679a409a8479d584405c7bda0029237c9dc06d74f057ad83698b3afe
- Sigstore transparency entry: 2394416063
- Sigstore integration time: Aug 9, 2026
Source repository:
- Permalink: zhenzi0322-package/imgnorm@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Branch / Tag: refs/tags/v1.0.3
- Owner: https://github.com/zhenzi0322-package
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: wheels.yml@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Trigger Event: push

File details

Details for the file imgnorm-1.0.3-cp314-cp314-manylinux_2_17_x86_64.whl.

File metadata

Download URL: imgnorm-1.0.3-cp314-cp314-manylinux_2_17_x86_64.whl
Upload date: Aug 9, 2026
Size: 1.7 MB
Tags: CPython 3.14, manylinux: glibc 2.17+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for imgnorm-1.0.3-cp314-cp314-manylinux_2_17_x86_64.whl
Algorithm	Hash digest
SHA256	`be52dc7b1fd76aabba1bf51bbc2ac2c237274ea265cdf06a9f7bea4e2610d2ab`
MD5	`6d523f662701e0f2a10f8e74fbc4810e`
BLAKE2b-256	`1920fd7ac5949d33588f041b175cc0c26469daf32ba31816db44e5cbaee40532`

See more details on using hashes here.

Provenance

The following attestation bundles were made for imgnorm-1.0.3-cp314-cp314-manylinux_2_17_x86_64.whl:

Publisher: wheels.yml on zhenzi0322-package/imgnorm

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: imgnorm-1.0.3-cp314-cp314-manylinux_2_17_x86_64.whl
- Subject digest: be52dc7b1fd76aabba1bf51bbc2ac2c237274ea265cdf06a9f7bea4e2610d2ab
- Sigstore transparency entry: 2394415378
- Sigstore integration time: Aug 9, 2026
Source repository:
- Permalink: zhenzi0322-package/imgnorm@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Branch / Tag: refs/tags/v1.0.3
- Owner: https://github.com/zhenzi0322-package
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: wheels.yml@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Trigger Event: push

File details

Details for the file imgnorm-1.0.3-cp313-cp313-win_amd64.whl.

File metadata

Download URL: imgnorm-1.0.3-cp313-cp313-win_amd64.whl
Upload date: Aug 9, 2026
Size: 265.9 kB
Tags: CPython 3.13, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for imgnorm-1.0.3-cp313-cp313-win_amd64.whl
Algorithm	Hash digest
SHA256	`e69aa8d4439010c93c7cbbc0e4685aab6d9249e2e27687d229d5746dda33d156`
MD5	`958e3b52d22f7144937f75caf17b8f30`
BLAKE2b-256	`04b2c2b1d3473a6e125a68f895697d5938749652f8fd160f9d6515caa673e444`

See more details on using hashes here.

Provenance

The following attestation bundles were made for imgnorm-1.0.3-cp313-cp313-win_amd64.whl:

Publisher: wheels.yml on zhenzi0322-package/imgnorm

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: imgnorm-1.0.3-cp313-cp313-win_amd64.whl
- Subject digest: e69aa8d4439010c93c7cbbc0e4685aab6d9249e2e27687d229d5746dda33d156
- Sigstore transparency entry: 2394409364
- Sigstore integration time: Aug 9, 2026
Source repository:
- Permalink: zhenzi0322-package/imgnorm@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Branch / Tag: refs/tags/v1.0.3
- Owner: https://github.com/zhenzi0322-package
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: wheels.yml@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Trigger Event: push

File details

Details for the file imgnorm-1.0.3-cp313-cp313-manylinux_2_17_x86_64.whl.

File metadata

Download URL: imgnorm-1.0.3-cp313-cp313-manylinux_2_17_x86_64.whl
Upload date: Aug 9, 2026
Size: 1.7 MB
Tags: CPython 3.13, manylinux: glibc 2.17+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for imgnorm-1.0.3-cp313-cp313-manylinux_2_17_x86_64.whl
Algorithm	Hash digest
SHA256	`6c9542ef2e3a86d57cbd2b7bb2334e546fc77fa62155e5b7e2e20ce9f8a485ef`
MD5	`3901fc02bd4b408f21cbe9a3f950fec8`
BLAKE2b-256	`5ead7b6ee8dddde6f0ea3c321baf4969bb400afc16f66a4f14313537a1b5d6d5`

See more details on using hashes here.

Provenance

The following attestation bundles were made for imgnorm-1.0.3-cp313-cp313-manylinux_2_17_x86_64.whl:

Publisher: wheels.yml on zhenzi0322-package/imgnorm

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: imgnorm-1.0.3-cp313-cp313-manylinux_2_17_x86_64.whl
- Subject digest: 6c9542ef2e3a86d57cbd2b7bb2334e546fc77fa62155e5b7e2e20ce9f8a485ef
- Sigstore transparency entry: 2394417165
- Sigstore integration time: Aug 9, 2026
Source repository:
- Permalink: zhenzi0322-package/imgnorm@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Branch / Tag: refs/tags/v1.0.3
- Owner: https://github.com/zhenzi0322-package
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: wheels.yml@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Trigger Event: push

File details

Details for the file imgnorm-1.0.3-cp312-cp312-win_amd64.whl.

File metadata

Download URL: imgnorm-1.0.3-cp312-cp312-win_amd64.whl
Upload date: Aug 9, 2026
Size: 269.9 kB
Tags: CPython 3.12, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for imgnorm-1.0.3-cp312-cp312-win_amd64.whl
Algorithm	Hash digest
SHA256	`80c17680ef0aad87a68e238535866c55f044c578bfffb26487bfd744e0c0b044`
MD5	`9a11419e7b50547f9ca78822b3b5b50a`
BLAKE2b-256	`60ff72ee86e2a959c618ab30113b432487003e006550ace69d3af46231afd6f2`

See more details on using hashes here.

Provenance

The following attestation bundles were made for imgnorm-1.0.3-cp312-cp312-win_amd64.whl:

Publisher: wheels.yml on zhenzi0322-package/imgnorm

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: imgnorm-1.0.3-cp312-cp312-win_amd64.whl
- Subject digest: 80c17680ef0aad87a68e238535866c55f044c578bfffb26487bfd744e0c0b044
- Sigstore transparency entry: 2394408527
- Sigstore integration time: Aug 9, 2026
Source repository:
- Permalink: zhenzi0322-package/imgnorm@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Branch / Tag: refs/tags/v1.0.3
- Owner: https://github.com/zhenzi0322-package
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: wheels.yml@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Trigger Event: push

File details

Details for the file imgnorm-1.0.3-cp312-cp312-manylinux_2_17_x86_64.whl.

File metadata

Download URL: imgnorm-1.0.3-cp312-cp312-manylinux_2_17_x86_64.whl
Upload date: Aug 9, 2026
Size: 1.7 MB
Tags: CPython 3.12, manylinux: glibc 2.17+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for imgnorm-1.0.3-cp312-cp312-manylinux_2_17_x86_64.whl
Algorithm	Hash digest
SHA256	`aab33003517fe6e44352d35f34c15ad0217b4e8424d5af5784b418d0683ae3e5`
MD5	`9d12ca3378850d35df27fe8099210d53`
BLAKE2b-256	`132c890ee2a0d0a4d69f5e73799375fc8b20c7ce21846ca103314098ec8d6c3e`

See more details on using hashes here.

Provenance

The following attestation bundles were made for imgnorm-1.0.3-cp312-cp312-manylinux_2_17_x86_64.whl:

Publisher: wheels.yml on zhenzi0322-package/imgnorm

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: imgnorm-1.0.3-cp312-cp312-manylinux_2_17_x86_64.whl
- Subject digest: aab33003517fe6e44352d35f34c15ad0217b4e8424d5af5784b418d0683ae3e5
- Sigstore transparency entry: 2394410623
- Sigstore integration time: Aug 9, 2026
Source repository:
- Permalink: zhenzi0322-package/imgnorm@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Branch / Tag: refs/tags/v1.0.3
- Owner: https://github.com/zhenzi0322-package
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: wheels.yml@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Trigger Event: push

File details

Details for the file imgnorm-1.0.3-cp311-cp311-win_amd64.whl.

File metadata

Download URL: imgnorm-1.0.3-cp311-cp311-win_amd64.whl
Upload date: Aug 9, 2026
Size: 268.2 kB
Tags: CPython 3.11, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for imgnorm-1.0.3-cp311-cp311-win_amd64.whl
Algorithm	Hash digest
SHA256	`dc3d139f480dd10ca980c8278ca6700be71dbca999df968af62a9199fa494a11`
MD5	`5d277b4fa902023792205b6001de6ef3`
BLAKE2b-256	`8dfae3c70e47783f06a4480822a93b78b7813fa6d039b62f808beb2e5f27ece6`

See more details on using hashes here.

Provenance

The following attestation bundles were made for imgnorm-1.0.3-cp311-cp311-win_amd64.whl:

Publisher: wheels.yml on zhenzi0322-package/imgnorm

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: imgnorm-1.0.3-cp311-cp311-win_amd64.whl
- Subject digest: dc3d139f480dd10ca980c8278ca6700be71dbca999df968af62a9199fa494a11
- Sigstore transparency entry: 2394412560
- Sigstore integration time: Aug 9, 2026
Source repository:
- Permalink: zhenzi0322-package/imgnorm@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Branch / Tag: refs/tags/v1.0.3
- Owner: https://github.com/zhenzi0322-package
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: wheels.yml@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Trigger Event: push

File details

Details for the file imgnorm-1.0.3-cp311-cp311-manylinux_2_17_x86_64.whl.

File metadata

Download URL: imgnorm-1.0.3-cp311-cp311-manylinux_2_17_x86_64.whl
Upload date: Aug 9, 2026
Size: 1.6 MB
Tags: CPython 3.11, manylinux: glibc 2.17+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for imgnorm-1.0.3-cp311-cp311-manylinux_2_17_x86_64.whl
Algorithm	Hash digest
SHA256	`a387b2022ab100347086a1adc78289728a2676fd5f7a5313c33f378140a68beb`
MD5	`04a706373ff433c4cfde51b558780d8e`
BLAKE2b-256	`7d0b5acdd1c74f80fc2feb4caf5b43ffff1d4c8c7932f9285d0ea48a8ad589b8`

See more details on using hashes here.

Provenance

The following attestation bundles were made for imgnorm-1.0.3-cp311-cp311-manylinux_2_17_x86_64.whl:

Publisher: wheels.yml on zhenzi0322-package/imgnorm

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: imgnorm-1.0.3-cp311-cp311-manylinux_2_17_x86_64.whl
- Subject digest: a387b2022ab100347086a1adc78289728a2676fd5f7a5313c33f378140a68beb
- Sigstore transparency entry: 2394414701
- Sigstore integration time: Aug 9, 2026
Source repository:
- Permalink: zhenzi0322-package/imgnorm@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Branch / Tag: refs/tags/v1.0.3
- Owner: https://github.com/zhenzi0322-package
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: wheels.yml@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Trigger Event: push

File details

Details for the file imgnorm-1.0.3-cp310-cp310-win_amd64.whl.

File metadata

Download URL: imgnorm-1.0.3-cp310-cp310-win_amd64.whl
Upload date: Aug 9, 2026
Size: 269.0 kB
Tags: CPython 3.10, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for imgnorm-1.0.3-cp310-cp310-win_amd64.whl
Algorithm	Hash digest
SHA256	`f8e8c866ae7b244a133921dd6a5d44fda586b2d11624e9e01f84df61f0a995bf`
MD5	`76d7293cc25ae8c7001d3064b3505f21`
BLAKE2b-256	`475bd3630e44ae20f246f308dcb013a53f3e89c83962c7df85de8119bf06255f`

See more details on using hashes here.

Provenance

The following attestation bundles were made for imgnorm-1.0.3-cp310-cp310-win_amd64.whl:

Publisher: wheels.yml on zhenzi0322-package/imgnorm

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: imgnorm-1.0.3-cp310-cp310-win_amd64.whl
- Subject digest: f8e8c866ae7b244a133921dd6a5d44fda586b2d11624e9e01f84df61f0a995bf
- Sigstore transparency entry: 2394416590
- Sigstore integration time: Aug 9, 2026
Source repository:
- Permalink: zhenzi0322-package/imgnorm@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Branch / Tag: refs/tags/v1.0.3
- Owner: https://github.com/zhenzi0322-package
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: wheels.yml@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Trigger Event: push

File details

Details for the file imgnorm-1.0.3-cp310-cp310-manylinux_2_17_x86_64.whl.

File metadata

Download URL: imgnorm-1.0.3-cp310-cp310-manylinux_2_17_x86_64.whl
Upload date: Aug 9, 2026
Size: 1.6 MB
Tags: CPython 3.10, manylinux: glibc 2.17+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for imgnorm-1.0.3-cp310-cp310-manylinux_2_17_x86_64.whl
Algorithm	Hash digest
SHA256	`d4a72e4f27f82f0041921e68481618b8f150582641c1e612e4c3304d6a0f629b`
MD5	`fb63b1c0bbf50827a5bbef5dc92436cd`
BLAKE2b-256	`d50282422cd3239a192991c2f6f36c2350329235252411ee9b69d3465d3faa40`

See more details on using hashes here.

Provenance

The following attestation bundles were made for imgnorm-1.0.3-cp310-cp310-manylinux_2_17_x86_64.whl:

Publisher: wheels.yml on zhenzi0322-package/imgnorm

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: imgnorm-1.0.3-cp310-cp310-manylinux_2_17_x86_64.whl
- Subject digest: d4a72e4f27f82f0041921e68481618b8f150582641c1e612e4c3304d6a0f629b
- Sigstore transparency entry: 2394414039
- Sigstore integration time: Aug 9, 2026
Source repository:
- Permalink: zhenzi0322-package/imgnorm@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Branch / Tag: refs/tags/v1.0.3
- Owner: https://github.com/zhenzi0322-package
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: wheels.yml@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Trigger Event: push

File details

Details for the file imgnorm-1.0.3-cp39-cp39-win_amd64.whl.

File metadata

Download URL: imgnorm-1.0.3-cp39-cp39-win_amd64.whl
Upload date: Aug 9, 2026
Size: 270.3 kB
Tags: CPython 3.9, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for imgnorm-1.0.3-cp39-cp39-win_amd64.whl
Algorithm	Hash digest
SHA256	`4908969b42a921d40731805966f47a3e5b7e8a14b1fa034208dcb4cfe7f72c4d`
MD5	`c2dc061738894e1f671f379f895111f9`
BLAKE2b-256	`5626b84e82af4fb486bb2fe613d4cea61468bc45043184dd66d77ced73d02c34`

See more details on using hashes here.

Provenance

The following attestation bundles were made for imgnorm-1.0.3-cp39-cp39-win_amd64.whl:

Publisher: wheels.yml on zhenzi0322-package/imgnorm

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: imgnorm-1.0.3-cp39-cp39-win_amd64.whl
- Subject digest: 4908969b42a921d40731805966f47a3e5b7e8a14b1fa034208dcb4cfe7f72c4d
- Sigstore transparency entry: 2394409827
- Sigstore integration time: Aug 9, 2026
Source repository:
- Permalink: zhenzi0322-package/imgnorm@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Branch / Tag: refs/tags/v1.0.3
- Owner: https://github.com/zhenzi0322-package
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: wheels.yml@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Trigger Event: push

File details

Details for the file imgnorm-1.0.3-cp39-cp39-manylinux_2_17_x86_64.whl.

File metadata

Download URL: imgnorm-1.0.3-cp39-cp39-manylinux_2_17_x86_64.whl
Upload date: Aug 9, 2026
Size: 1.6 MB
Tags: CPython 3.9, manylinux: glibc 2.17+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for imgnorm-1.0.3-cp39-cp39-manylinux_2_17_x86_64.whl
Algorithm	Hash digest
SHA256	`b542304f32f77685ae7deb5c8bca0952f36a9448207142334dee298c9affafaf`
MD5	`26b70448efcef7737fbef64ad59ccbdc`
BLAKE2b-256	`d9e1bc7f7effabda9ef4535ae924415aa74b169ef72989f4849c3e105f437e35`

See more details on using hashes here.

Provenance

The following attestation bundles were made for imgnorm-1.0.3-cp39-cp39-manylinux_2_17_x86_64.whl:

Publisher: wheels.yml on zhenzi0322-package/imgnorm

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: imgnorm-1.0.3-cp39-cp39-manylinux_2_17_x86_64.whl
- Subject digest: b542304f32f77685ae7deb5c8bca0952f36a9448207142334dee298c9affafaf
- Sigstore transparency entry: 2394413400
- Sigstore integration time: Aug 9, 2026
Source repository:
- Permalink: zhenzi0322-package/imgnorm@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Branch / Tag: refs/tags/v1.0.3
- Owner: https://github.com/zhenzi0322-package
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: wheels.yml@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Trigger Event: push

File details

Details for the file imgnorm-1.0.3-cp38-cp38-win_amd64.whl.

File metadata

Download URL: imgnorm-1.0.3-cp38-cp38-win_amd64.whl
Upload date: Aug 9, 2026
Size: 276.2 kB
Tags: CPython 3.8, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for imgnorm-1.0.3-cp38-cp38-win_amd64.whl
Algorithm	Hash digest
SHA256	`15945cfe239cfd6dd674b413325f516c2f6af0822d7718cab2375fdad76cc0ca`
MD5	`977bbfcd10a209d8055d12a8fc6b544c`
BLAKE2b-256	`ea9bcfd8c73571cb1cb3e87b37776198dcef1dd952116073a9b713af0ef2ecbc`

See more details on using hashes here.

Provenance

The following attestation bundles were made for imgnorm-1.0.3-cp38-cp38-win_amd64.whl:

Publisher: wheels.yml on zhenzi0322-package/imgnorm

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: imgnorm-1.0.3-cp38-cp38-win_amd64.whl
- Subject digest: 15945cfe239cfd6dd674b413325f516c2f6af0822d7718cab2375fdad76cc0ca
- Sigstore transparency entry: 2394417792
- Sigstore integration time: Aug 9, 2026
Source repository:
- Permalink: zhenzi0322-package/imgnorm@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Branch / Tag: refs/tags/v1.0.3
- Owner: https://github.com/zhenzi0322-package
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: wheels.yml@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Trigger Event: push

File details

Details for the file imgnorm-1.0.3-cp38-cp38-manylinux_2_17_x86_64.whl.

File metadata

Download URL: imgnorm-1.0.3-cp38-cp38-manylinux_2_17_x86_64.whl
Upload date: Aug 9, 2026
Size: 1.6 MB
Tags: CPython 3.8, manylinux: glibc 2.17+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for imgnorm-1.0.3-cp38-cp38-manylinux_2_17_x86_64.whl
Algorithm	Hash digest
SHA256	`c38273b75fb0cab0e50b050d0f57a6c7c9cadd8cda1b78ea33a2066f5d999b94`
MD5	`1b87381afaedac032cc61f0e0e6b6395`
BLAKE2b-256	`6a65af61276f026e103c0141675262d4ed9e81dc2cd1604fa084ec6801ed675d`

See more details on using hashes here.

Provenance

The following attestation bundles were made for imgnorm-1.0.3-cp38-cp38-manylinux_2_17_x86_64.whl:

Publisher: wheels.yml on zhenzi0322-package/imgnorm

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: imgnorm-1.0.3-cp38-cp38-manylinux_2_17_x86_64.whl
- Subject digest: c38273b75fb0cab0e50b050d0f57a6c7c9cadd8cda1b78ea33a2066f5d999b94
- Sigstore transparency entry: 2394411673
- Sigstore integration time: Aug 9, 2026
Source repository:
- Permalink: zhenzi0322-package/imgnorm@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Branch / Tag: refs/tags/v1.0.3
- Owner: https://github.com/zhenzi0322-package
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: wheels.yml@a36187d33fbb4c910f32f0cf549c991fc18c0e09
- Trigger Event: push

Release history Release notifications | RSS feed

This release

1.0.3

Aug 9, 2026

1.0.2

Jul 25, 2026

1.0.1

Jul 25, 2026

imgnorm 1.0.3

imgnorm

特性

安装

使用示例

image_resize — 等比缩放居中

FluxKontextImageScale — Flux Kontext 优选分辨率缩放

ImageTool — 多功能比例调整工具

GPTImageSizeCalculator — gpt-image-2 尺寸计算器

ImageRatioAnalyzer — 图片比例分析器

ComfyUIManager — ComfyUI 服务管理

PromptBanChecker — 提示词违禁词检测

API 说明

image_resize(image, target_w, target_h, bg_color=(0, 0, 0))

FluxKontextImageScale(image)

ImageTool(proportion=None, need_adjust="fill", fill_color=(255,255,255,0))

GPTImageSizeCalculator

ImageRatioAnalyzer(approx_search_range=10)

ComfyUIManager

PromptBanChecker(ban_word_file=None, ignore_case=True, builtin_words=None, use_default=True, exclude_words=None)

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License

Requires

Download files

Source Distributions

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

`image_resize(image, target_w, target_h, bg_color=(0, 0, 0))`

`FluxKontextImageScale(image)`

`ImageTool(proportion=None, need_adjust="fill", fill_color=(255,255,255,0))`

`GPTImageSizeCalculator`

`ImageRatioAnalyzer(approx_search_range=10)`

`ComfyUIManager`

`PromptBanChecker(ban_word_file=None, ignore_case=True, builtin_words=None, use_default=True, exclude_words=None)`