PixAI Tagger v1.0

PixAI Tagger v1.0

在浏览器里给动漫图片加上描述性标签，分成六个类别，阈值可调。适合画师、数据集整理者和整理动漫图片的人。

由 pixai-labs 在 Hugging Face 上制作。这些说明是 Mindket 根据它的 Space 页面和 README 写的，应用自己的文件和许可证在 Hugging Face 上。

简介

它是什么：这个 Space 是 PixAI Tagger v1.0 的演示，这个模型会给动漫图片写标签。你添加一张图片，按下打标签按钮，就得到分成 general、character、style、copyright 或 series、meta 和 rating 的标签。你可以复制合并后的列表，也可以逐组浏览。

适合谁：如果你需要给动漫图片打一致的标签，它很适合画师、收藏者和数据集整理者。想在使用前先看看模型运行效果的开发者也适用。

行业 | 谁在用 | 怎么用 | 例子
数字艺术 | 插画师 | 给完成的作品打标签，用于发布或归档 | 给一张角色画得到标签列表
数据集工作 | 整理者 | 用统一词汇给许多图片打标签 | 给一张图打标签并复制合并后的标签
社区 | 版主和归档员 | 按角色和作品系列整理图片 | 浏览角色和系列分组
软件 | 开发者 | 阅读围绕六类别管线的处理代码 | 打开仓库里的 handler.py

如果你的图片不是动漫，可以跳过它，因为这个模型是为动漫作品而建的。

用在哪里：

• 网页浏览器：打开 Hugging Face 上的 Space 页面
• Windows、macOS 或 Linux：用 Python 3.11 运行一份副本
• 仅用 CPU：演示在 CPU 上运行，不需要显卡

用途 | 谁用 | 得到什么
给一张图打标签 | 画师 | 合并标签加六个类别列表
调整阈值 | 整理者 | 每个类别里更少或更多的标签
加上置信度分数 | 开发者 | 每个标签旁边带分数

如何设置：在线页面什么都不需要。本地副本需要 Python 3.11 和对模型的访问权限。

• 在线演示需要网页浏览器
• 本地副本需要 Python 3.11
• requirements.txt 里列出的包
• Space 加载模型时，需要把对该模型有读取权限的 Hugging Face 令牌设为 HF_TOKEN
• 或者使用本地模型文件夹，这样可以跳过下载

1. 想在线使用，打开 Hugging Face 上的 Space 页面。
2. 想运行副本，先安装 Hugging Face hub 包。
3. 把 Space 下载到本地文件夹。
4. 进入该文件夹，安装 Gradio 6.14.0 和列出的包。
5. 启动应用。

pip install -U huggingface_hub
hf download pixai-labs/pixai-tagger-demo --repo-type space --local-dir pixai-tagger-demo
cd pixai-tagger-demo
pip install gradio==6.14.0
pip install -r requirements.txt
python app.py

如果要使用你已有的模型文件夹，README 这样运行。

pip install -r requirements.txt
MODEL_DIR=/path/to/pixai-tagger-v1.0 python app.py

如何使用：上传或粘贴一张动漫图片，按下打标签按钮。复制合并后的标签，或者浏览六个类别列表。打开标签设置，可以调整阈值、选取最靠前的标签、保留下划线或显示置信度分数。

示例：你粘贴一张角色画，按下打标签按钮。页面返回一个合并列表和六个类别列表。你调高角色阈值，得到更少但更确定的标签，然后复制结果。

新手与专家：如果你是新手，用默认设置给一张图打标签，读一读列表。然后打开设置，移动一个阈值，看看标签数量怎么变化。

如果你熟悉这个领域，阈值默认取自完整词表评估中每个类别得到最佳 macro F1 的设置。处理代码封装了模型的六类别 Transformers 管线。推理在 CPU 上用 32 位浮点精度，一次只服务一个请求，除非你设置 TORCH_NUM_THREADS，否则 torch 用 2 个线程。

你上传或粘贴动漫图片
六类别打标签模型在 CPU 上运行
阈值过滤每个类别的标签
你复制或浏览标签

注意事项：有几个环境变量，可以让应用指向另一个模型、固定的版本或本地文件夹。你的 HF_TOKEN 值留在服务器端，不会出现在页面和 API 里。

Title: Default threshold per category
General: 0.17 threshold
Character: 0.27 threshold
Style: 0.15 threshold
Copyright: 0.24 threshold
Meta: 0.17 threshold
Rating: 0.41 threshold

• License: MIT
• Cost to run: 一个对该模型有读取权限的 Hugging Face 令牌
• Data it reaches: 你提供的图片，以及下载到 Hub 缓存的模型文件
• Not for: 非动漫图片或大量并行使用，因为一次只处理一个请求

Hugging Face 上的数据（2026年11月13日）

• 点赞：112
• 构建方式：gradio
• 许可证：mit

链接

• Space：https://huggingface.co/spaces/pixai-labs/pixai-tagger-demo
• 文件：https://huggingface.co/spaces/pixai-labs/pixai-tagger-demo/tree/main

试用

在浏览器里打开这个 Space，或在它的页面上把它复制到你自己的 Hugging Face 账号。这个工具包里没有会自己运行的东西。