CyberHarem/karin_fireemblem

---
license: mit
task_categories:
- text-to-image
tags:
- art
- not-for-all-audiences
size_categories:
- n<1K
---

# Dataset of karin (Fire Emblem)

This is the dataset of karin (Fire Emblem), containing 16 images and their tags.

The core tags of this character are `green_hair, green_eyes, short_hair, bangs`, which are pruned in this dataset.

Images are crawled from many sites (e.g. danbooru, pixiv, zerochan ...), the auto-crawling system is powered by [DeepGHS Team](https://github.com/deepghs)([huggingface organization](https://huggingface.co/deepghs)).

## List of Packages

| Name | Images | Size | Download | Type | Description |
|:-----------------|---------:|:----------|:------------------------------------------------------------------------------------------------------------------|:-----------|:---------------------------------------------------------------------|
| raw | 16 | 8.76 MiB | [Download](https://huggingface.co/datasets/CyberHarem/karin_fireemblem/resolve/main/dataset-raw.zip) | Waifuc-Raw | Raw data with meta information (min edge aligned to 1400 if larger). |
| 800 | 16 | 8.04 MiB | [Download](https://huggingface.co/datasets/CyberHarem/karin_fireemblem/resolve/main/dataset-800.zip) | IMG+TXT | dataset with the shorter side not exceeding 800 pixels. |
| stage3-p480-800 | 21 | 9.65 MiB | [Download](https://huggingface.co/datasets/CyberHarem/karin_fireemblem/resolve/main/dataset-stage3-p480-800.zip) | IMG+TXT | 3-stage cropped dataset with the area not less than 480x480 pixels. |
| 1200 | 16 | 8.55 MiB | [Download](https://huggingface.co/datasets/CyberHarem/karin_fireemblem/resolve/main/dataset-1200.zip) | IMG+TXT | dataset with the shorter side not exceeding 1200 pixels. |
| stage3-p480-1200 | 21 | 10.17 MiB | [Download](https://huggingface.co/datasets/CyberHarem/karin_fireemblem/resolve/main/dataset-stage3-p480-1200.zip) | IMG+TXT | 3-stage cropped dataset with the area not less than 480x480 pixels. |

### Load Raw Dataset with Waifuc

We provide raw dataset (including tagged images) for [waifuc](https://deepghs.github.io/waifuc/main/tutorials/installation/index.html) loading. If you need this, just run the following code

```python
import os
import zipfile

from huggingface_hub import hf_hub_download
from waifuc.source import LocalSource

# download raw archive file
zip_file = hf_hub_download(
repo_id='CyberHarem/karin_fireemblem',
repo_type='dataset',
filename='dataset-raw.zip',
)

# extract files to your directory
dataset_dir = 'dataset_dir'
os.makedirs(dataset_dir, exist_ok=True)
with zipfile.ZipFile(zip_file, 'r') as zf:
zf.extractall(dataset_dir)

# load the dataset with waifuc
source = LocalSource(dataset_dir)
for item in source:
print(item.image, item.meta['filename'], item.meta['tags'])
```

## List of Clusters

List of tag clustering result, maybe some outfits can be mined here.

### Raw Text Version

| # | Samples | Img-1 | Img-2 | Img-3 | Img-4 | Img-5 | Tags |
|----:|----------:|:--------------------------------|:--------------------------------|:--------------------------------|:--------------------------------|:--------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 0 | 16 |  |  |  |  |  | 1girl, smile, solo, breastplate, shoulder_armor, open_mouth, shiny, spear, thigh_boots, thighhighs, belt, fingerless_gloves, looking_at_viewer, short_sleeves, simple_background, elbow_gloves, green_dress, holding |

### Table Version

| # | Samples | Img-1 | Img-2 | Img-3 | Img-4 | Img-5 | 1girl | smile | solo | breastplate | shoulder_armor | open_mouth | shiny | spear | thigh_boots | thighhighs | belt | fingerless_gloves | looking_at_viewer | short_sleeves | simple_background | elbow_gloves | green_dress | holding |
|----:|----------:|:--------------------------------|:--------------------------------|:--------------------------------|:--------------------------------|:--------------------------------|:--------|:--------|:-------|:--------------|:-----------------|:-------------|:--------|:--------|:--------------|:-------------|:-------|:--------------------|:--------------------|:----------------|:--------------------|:---------------|:--------------|:----------|
| 0 | 16 |  |  |  |  |  | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X |

许可证：MIT协议
任务类别：
- 文本到图像（text-to-image）
标签：
- 艺术创作（art）
- 非全年龄受众（not-for-all-audiences）
样本规模类别：
- 样本量小于1000（n<1K）

# 《火焰纹章（Fire Emblem）》卡琳数据集

本数据集收录《火焰纹章（Fire Emblem）》角色卡琳的相关素材，包含16张图像及其配套标注标签。
该角色的核心特征标签为`绿发（green_hair）、绿眼（green_eyes）、短发（short_hair）、齐刘海（bangs）`，本数据集已对该类核心标签进行了裁剪移除处理。
本数据集的图像源自多平台爬取（如danbooru、pixiv、zerochan等），自动爬取系统由[DeepGHS团队](https://github.com/deepghs)（[Hugging Face官方机构](https://huggingface.co/deepghs)）提供技术支持。

## 数据包清单

| 数据包名称 | 图像数量 | 文件大小 | 下载链接 | 数据类型 | 数据说明 |
|:-----------------|---------:|:----------|:------------------------------------------------------------------------------------------------------------------|:-----------|:---------------------------------------------------------------------|
| raw | 16 | 8.76 MiB | [下载](https://huggingface.co/datasets/CyberHarem/karin_fireemblem/resolve/main/dataset-raw.zip) | Waifuc-Raw | 包含元数据的原始图像集（若图像短边尺寸大于1400像素，则将其对齐至1400像素）。 |
| 800 | 16 | 8.04 MiB | [下载](https://huggingface.co/datasets/CyberHarem/karin_fireemblem/resolve/main/dataset-800.zip) | 图像+标签文本（IMG+TXT） | 短边尺寸不超过800像素的预处理数据集。 |
| stage3-p480-800 | 21 | 9.65 MiB | [下载](https://huggingface.co/datasets/CyberHarem/karin_fireemblem/resolve/main/dataset-stage3-p480-800.zip) | 图像+标签文本（IMG+TXT） | 三级裁剪预处理数据集，裁剪后区域不小于480×480像素。 |
| 1200 | 16 | 8.55 MiB | [下载](https://huggingface.co/datasets/CyberHarem/karin_fireemblem/resolve/main/dataset-1200.zip) | 图像+标签文本（IMG+TXT） | 短边尺寸不超过1200像素的预处理数据集。 |
| stage3-p480-1200 | 21 | 10.17 MiB | [下载](https://huggingface.co/datasets/CyberHarem/karin_fireemblem/resolve/main/dataset-stage3-p480-1200.zip) | 图像+标签文本（IMG+TXT） | 三级裁剪预处理数据集，裁剪后区域不小于480×480像素。 |

### 使用Waifuc加载原始数据集

我们提供可通过Waifuc加载的原始数据集（包含带标注的图像），具体使用教程可参考[Waifuc官方安装指南](https://deepghs.github.io/waifuc/main/tutorials/installation/index.html)。如需使用该数据集，可运行以下代码：

python
import os
import zipfile

from huggingface_hub import hf_hub_download
from waifuc.source import LocalSource

# 下载原始压缩数据包
zip_file = hf_hub_download(
repo_id='CyberHarem/karin_fireemblem',
repo_type='dataset',
filename='dataset-raw.zip',
)

# 将数据解压至指定目录
dataset_dir = 'dataset_dir'
os.makedirs(dataset_dir, exist_ok=True)
with zipfile.ZipFile(zip_file, 'r') as zf:
zf.extractall(dataset_dir)

# 使用Waifuc加载数据集
source = LocalSource(dataset_dir)
for item in source:
print(item.image, item.meta['filename'], item.meta['tags'])

## 聚类结果清单

以下为标签聚类结果列表，可从中挖掘该角色的不同穿搭风格。

### 原始文本格式

| 序号 | 样本数 | 示例图1 | 示例图2 | 示例图3 | 示例图4 | 示例图5 | 特征标签 |
|----:|----------:|:--------------------------------|:--------------------------------|:--------------------------------|:--------------------------------|:--------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 0 | 16 |  |  |  |  |  | 单女性角色（1girl）、微笑（smile）、单人（solo）、胸甲（breastplate）、肩甲（shoulder_armor）、张嘴（open_mouth）、光泽质感（shiny）、长矛（spear）、过膝长靴（thigh_boots）、过膝袜（thighhighs）、腰带（belt）、露指手套（fingerless_gloves）、直视镜头（looking_at_viewer）、短袖（short_sleeves）、简洁背景（simple_background）、肘部护甲（elbow_gloves）、绿色连衣裙（green_dress）、手持物品（holding） |

### 表格格式

| 序号 | 样本数 | 示例图1 | 示例图2 | 示例图3 | 示例图4 | 示例图5 | 1girl | smile | solo | breastplate | shoulder_armor | open_mouth | shiny | spear | thigh_boots | thighhighs | belt | fingerless_gloves | looking_at_viewer | short_sleeves | simple_background | elbow_gloves | green_dress | holding |
|----:|----------:|:--------------------------------|:--------------------------------|:--------------------------------|:--------------------------------|:--------------------------------|:--------|:--------|:-------|:--------------|:-----------------|:-------------|:--------|:--------|:--------------|:-------------|:-------|:--------------------|:--------------------|:----------------|:--------------------|:---------------|:--------------|:----------|
| 0 | 16 |  |  |  |  |  | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |

原始信息汇总

数据集概述

数据集信息

• 名称: Dataset of karin (Fire Emblem)
• 许可证: MIT
• 任务类别: text-to-image
• 标签: art, not-for-all-audiences
• 大小类别: n<1K

数据集内容

• 图像数量: 16张
• 核心标签: green_hair, green_eyes, short_hair, bangs
• 来源: 从多个网站爬取，如danbooru, pixiv, zerochan等

数据包列表

名称	图像数量	大小	类型	描述
raw	16	8.76 MiB	Waifuc-Raw	包含元信息的原始数据（最小边对齐到1400像素，如果更大）
800	16	8.04 MiB	IMG+TXT	短边不超过800像素的数据集
stage3-p480-800	21	9.65 MiB	IMG+TXT	3阶段裁剪数据集，区域不小于480x480像素
1200	16	8.55 MiB	IMG+TXT	短边不超过1200像素的数据集
stage3-p480-1200	21	10.17 MiB	IMG+TXT	3阶段裁剪数据集，区域不小于480x480像素

标签聚类结果

原始文本版本

#	样本数量	图像1	图像2	图像3	图像4	图像5	标签
0	16						1girl, smile, solo, breastplate, shoulder_armor, open_mouth, shiny, spear, thigh_boots, thighhighs, belt, fingerless_gloves, looking_at_viewer, short_sleeves, simple_background, elbow_gloves, green_dress, holding

表格版本

#	样本数量	图像1	图像2	图像3	图像4	图像5	1girl	smile	solo	breastplate	shoulder_armor	open_mouth	shiny	spear	thigh_boots	thighhighs	belt	fingerless_gloves	looking_at_viewer	short_sleeves	simple_background	elbow_gloves	green_dress	holding
0	16						X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X

搜集汇总

数据集介绍

构建方式

在二次元角色图像数据集的构建中，精细化与多样性是核心诉求。本数据集聚焦于《火焰之纹章》中的角色卡琳，采用自动化爬取技术，从Danbooru、Pixiv、Zerochan等多个知名图源站点搜集图像。整个采集流程由DeepGHS团队开发的系统驱动，确保数据来源的广泛性与代表性。数据集共收录16张原始图像，并附有对应的标签信息。为适配不同研究需求，项目提供了多个预处理版本，包括限制短边不超过800或1200像素的标准化版本，以及采用三阶段裁剪策略、确保有效区域不低于480×480像素的增强版本。此外，原始数据以Waifuc兼容格式打包，便于研究者直接加载与使用。

特点

该数据集的核心特色在于其精细化的标签体系与多版本的数据组织形式。角色关键属性如‘绿发’、‘绿瞳’、‘短发’、‘刘海’等被明确标注并作为核心标签，同时通过聚类分析技术，将16张样本图像归为一类，自动挖掘出‘微笑’、‘单人’、‘胸甲’、‘肩甲’、‘长矛’等高频共现标签，为角色外观的语义理解提供了结构化参考。数据集不仅提供原始分辨率图像，还包含多种尺寸与裁剪策略的预处理包，兼顾了训练效率与图像质量。所有图像均经过边缘对齐处理，确保最小边不低于1400像素，从而保留丰富的细节信息。

使用方法

本数据集的使用方式灵活多样，尤其适合文本到图像生成模型的训练与评估。研究者可通过Hugging Face Hub直接下载不同规格的压缩包，如‘raw’、‘800’、‘1200’或‘stage3-p480-800’等。若需加载原始数据，建议采用Waifuc库：首先通过`hf_hub_download`函数下载`dataset-raw.zip`文件，解压至本地目录后，利用`LocalSource`接口即可遍历图像及其元数据，包括文件名与标签信息。此外，数据集提供的聚类结果表格可作为先验知识，辅助进行角色服装、姿势等属性的细粒度分析或数据增强策略的设计。

背景与挑战

背景概述

在动漫与游戏角色驱动的文生图（text-to-image）领域，高质量、标签精准的角色数据集是模型微调与风格迁移的核心基石。CyberHarem/karin_fireemblem数据集由DeepGHS团队于近年创建，聚焦于《火焰之纹章》系列中的角色卡琳（Karin），旨在为二次元角色生成提供标准化数据支持。该数据集包含16张经过多源爬取（如Danbooru、Pixiv、Zerochan）的图片及其标签，核心标签涵盖绿发、绿瞳、短发、刘海等关键特征，并提供了多种分辨率与裁剪版本以适应不同训练需求。通过集成Waifuc工具链，数据集实现了高效加载与预处理，显著降低了角色定制化模型的门槛，对推动动漫风格生成模型的研究具有示范意义。

当前挑战

该数据集面临的核心挑战源于其小规模与单一角色属性。首先，在领域问题层面，仅16张样本难以覆盖角色多角度、多表情及复杂场景的多样性，易导致生成模型过拟合或泛化能力不足，无法应对姿态变化、服饰细节渲染等任务。其次，构建过程中遭遇数据稀疏与标签一致性难题：多源爬取的图片风格各异（如画师差异、分辨率不一），自动标签系统可能引入噪声或遗漏细粒度属性（如特定装备“胸甲”“长矛”），而人工校验成本高昂。此外，版权合规与数据清洗的平衡进一步增加了扩展难度，限制了数据集在跨角色迁移学习中的鲁棒性。

常用场景

经典使用场景

在文本到图像生成领域，CyberHarem/karin_fireemblem数据集作为角色概念驱动的微调素材，广泛应用于个性化图像生成模型的训练。该数据集聚焦于《火焰之纹章》中的卡琳这一角色，通过16张高质量图像及其标注标签，为Stable Diffusion等扩散模型提供了精细的角色特征锚点，使得模型能够习得诸如绿色长发、绿色眼眸、短刘海等核心视觉元素，进而实现从文本描述到特定角色形象的精准生成。

实际应用

在实际应用中，该数据集赋能了游戏与动漫产业的自动化内容创作。创作者可利用该数据集微调生成模型，快速产出符合角色设定的宣传图、同人插画或游戏内头像，显著降低人工绘制成本。此外，其多分辨率与裁剪版本（如800、1200像素及三级裁剪版本）适配了不同平台的分发需求，从社交媒体缩略图到高清壁纸均能一键生成，提升了角色素材的复用效率与商业价值。

衍生相关工作

该数据集衍生了多项经典工作，尤其在角色概念学习与数据增强领域。基于其标签聚类结果（如胸甲、长矛、绿色长裙等装备组合），研究者开发了角色部件解耦与重组技术，实现了跨角色风格迁移。同时，依托waifuc框架的原始数据加载方式，催生了自动化图像爬取与标注流水线的优化研究，推动了大规模角色数据集构建的标准化。此外，该数据集常作为DreamBooth与LoRA微调方法的基准测试用例，用以评估角色保真度与训练效率。