CyberHarem/hapi_fireemblem

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

# Dataset of hapi (Fire Emblem)

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

The core tags of this character are `red_hair, dark_skin, dark-skinned_female, red_eyes, long_hair, breasts`, 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 | 205 | 239.20 MiB | [Download](https://huggingface.co/datasets/CyberHarem/hapi_fireemblem/resolve/main/dataset-raw.zip) | Waifuc-Raw | Raw data with meta information (min edge aligned to 1400 if larger). |
| 800 | 205 | 143.62 MiB | [Download](https://huggingface.co/datasets/CyberHarem/hapi_fireemblem/resolve/main/dataset-800.zip) | IMG+TXT | dataset with the shorter side not exceeding 800 pixels. |
| stage3-p480-800 | 470 | 298.71 MiB | [Download](https://huggingface.co/datasets/CyberHarem/hapi_fireemblem/resolve/main/dataset-stage3-p480-800.zip) | IMG+TXT | 3-stage cropped dataset with the area not less than 480x480 pixels. |
| 1200 | 205 | 217.13 MiB | [Download](https://huggingface.co/datasets/CyberHarem/hapi_fireemblem/resolve/main/dataset-1200.zip) | IMG+TXT | dataset with the shorter side not exceeding 1200 pixels. |
| stage3-p480-1200 | 470 | 410.55 MiB | [Download](https://huggingface.co/datasets/CyberHarem/hapi_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/hapi_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 | 29 |  |  |  |  |  | 1girl, garreg_mach_monastery_uniform, solo, crop_top, simple_background, upper_body, midriff, long_sleeves, navel, white_background, closed_mouth, medium_hair |
| 1 | 7 |  |  |  |  |  | 1girl, black_footwear, crop_top, garreg_mach_monastery_uniform, midriff, skirt, solo, thigh_boots, thighhighs, navel, bracelet, closed_mouth, full_body, knee_boots, pink_eyes, simple_background, high_heel_boots, sitting, white_background |
| 2 | 9 |  |  |  |  |  | 1girl, crop_top, garreg_mach_monastery_uniform, midriff, miniskirt, navel, stomach, bangs, open_jacket, solo, white_jacket, white_skirt, long_sleeves, bracelet, cowboy_shot, hair_between_eyes, looking_at_viewer, zettai_ryouiki, cropped_jacket, groin, white_background, closed_mouth, medium_breasts, purple_thighhighs, shiny, shirt, simple_background |
| 3 | 7 |  |  |  |  |  | 1girl, large_breasts, shoulder_armor, cleavage, solo, looking_at_viewer, official_alternate_costume, official_alternate_hairstyle, brown_gloves, closed_mouth, smile, upper_body, belt, simple_background, white_background |
| 4 | 9 |  |  |  |  |  | 1girl, earrings, solo, looking_at_viewer, cleavage, large_breasts, thighhighs, ass, cape, parted_lips, boots, circlet, simple_background |
| 5 | 9 |  |  |  |  |  | 1boy, 1girl, hetero, nipples, large_breasts, solo_focus, blush, penis, facial, paizuri, completely_nude, cum_on_breasts, earrings, smile |
| 6 | 9 |  |  |  |  |  | 1girl, hetero, nipples, penis, sex, solo_focus, vaginal, cum_in_pussy, blush, open_mouth, thighhighs, 1boy, large_breasts, 2boys, bar_censor, medium_breasts, medium_hair, mosaic_censoring, pubic_hair, rape, spread_legs |

### Table Version

| # | Samples | Img-1 | Img-2 | Img-3 | Img-4 | Img-5 | 1girl | garreg_mach_monastery_uniform | solo | crop_top | simple_background | upper_body | midriff | long_sleeves | navel | white_background | closed_mouth | medium_hair | black_footwear | skirt | thigh_boots | thighhighs | bracelet | full_body | knee_boots | pink_eyes | high_heel_boots | sitting | miniskirt | stomach | bangs | open_jacket | white_jacket | white_skirt | cowboy_shot | hair_between_eyes | looking_at_viewer | zettai_ryouiki | cropped_jacket | groin | medium_breasts | purple_thighhighs | shiny | shirt | large_breasts | shoulder_armor | cleavage | official_alternate_costume | official_alternate_hairstyle | brown_gloves | smile | belt | earrings | ass | cape | parted_lips | boots | circlet | 1boy | hetero | nipples | solo_focus | blush | penis | facial | paizuri | completely_nude | cum_on_breasts | sex | vaginal | cum_in_pussy | open_mouth | 2boys | bar_censor | mosaic_censoring | pubic_hair | rape | spread_legs |
|----:|----------:|:--------------------------------|:--------------------------------|:--------------------------------|:--------------------------------|:--------------------------------|:--------|:--------------------------------|:-------|:-----------|:--------------------|:-------------|:----------|:---------------|:--------|:-------------------|:---------------|:--------------|:-----------------|:--------|:--------------|:-------------|:-----------|:------------|:-------------|:------------|:------------------|:----------|:------------|:----------|:--------|:--------------|:---------------|:--------------|:--------------|:--------------------|:--------------------|:-----------------|:-----------------|:--------|:-----------------|:--------------------|:--------|:--------|:----------------|:-----------------|:-----------|:-----------------------------|:-------------------------------|:---------------|:--------|:-------|:-----------|:------|:-------|:--------------|:--------|:----------|:-------|:---------|:----------|:-------------|:--------|:--------|:---------|:----------|:------------------|:-----------------|:------|:----------|:---------------|:-------------|:--------|:-------------|:-------------------|:-------------|:-------|:--------------|
| 0 | 29 |  |  |  |  |  | X | X | X | X | X | X | X | X | X | X | X | X | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| 1 | 7 |  |  |  |  |  | X | X | X | X | X | | X | | X | X | X | | X | X | X | X | X | X | X | X | X | X | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| 2 | 9 |  |  |  |  |  | X | X | X | X | X | | X | X | X | X | X | | | | | | X | | | | | | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| 3 | 7 |  |  |  |  |  | X | | X | | X | X | | | | X | X | | | | | | | | | | | | | | | | | | | | X | | | | | | | | X | X | X | X | X | X | X | X | | | | | | | | | | | | | | | | | | | | | | | | | | |
| 4 | 9 |  |  |  |  |  | X | | X | | X | | | | | | | | | | | X | | | | | | | | | | | | | | | X | | | | | | | | X | | X | | | | | | X | X | X | X | X | X | | | | | | | | | | | | | | | | | | | | |
| 5 | 9 |  |  |  |  |  | X | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | X | | | | | | X | | X | | | | | | X | X | X | X | X | X | X | X | X | X | | | | | | | | | | |
| 6 | 9 |  |  |  |  |  | X | | | | | | | | | | | X | | | | X | | | | | | | | | | | | | | | | | | | X | | | | X | | | | | | | | | | | | | | X | X | X | X | X | X | | | | | X | X | X | X | X | X | X | X | X | X |

原始信息汇总

数据集概述

数据集基本信息

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

数据集内容

• 图像数量: 205
• 核心标签: red_hair, dark_skin, dark-skinned_female, red_eyes, long_hair, breasts

数据集包列表

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

标签聚类结果

原始文本版本

#	样本数量	图像示例	标签
0	29		1girl, garreg_mach_monastery_uniform, solo, crop_top, simple_background, upper_body, midriff, long_sleeves, navel, white_background, closed_mouth, medium_hair
1	7		1girl, black_footwear, crop_top, garreg_mach_monastery_uniform, midriff, skirt, solo, thigh_boots, thighhighs, navel, bracelet, closed_mouth, full_body, knee_boots, pink_eyes, simple_background, high_heel_boots, sitting, white_background
2	9		1girl, crop_top, garreg_mach_monastery_uniform, midriff, miniskirt, navel, stomach, bangs, open_jacket, solo, white_jacket, white_skirt, long_sleeves, bracelet, cowboy_shot, hair_between_eyes, looking_at_viewer, zettai_ryouiki, cropped_jacket, groin, white_background, closed_mouth, medium_breasts, purple_thighhighs, shiny, shirt, simple_background
3	7		1girl, large_breasts, shoulder_armor, cleavage, solo, looking_at_viewer, official_alternate_costume, official_alternate_hairstyle, brown_gloves, closed_mouth, smile, upper_body, belt, simple_background, white_background
4	9		1girl, earrings, solo, looking_at_viewer, cleavage, large_breasts, thighhighs, ass, cape, parted_lips, boots, circlet, simple_background
5	9		1boy, 1girl, hetero, nipples, large_breasts, solo_focus, blush, penis, facial, paizuri, completely_nude, cum_on_breasts, earrings, smile
6	9		1girl, hetero, nipples, penis, sex, solo_focus, vaginal, cum_in_pussy, blush, open_mouth, thighhighs, 1boy, large_breasts, 2boys, bar_censor, medium_breasts, medium_hair, mosaic_censoring, pubic_hair, rape, spread_legs

搜集汇总

数据集介绍

构建方式

在角色扮演与数字艺术领域，构建高质量的人物数据集是驱动文本到图像生成模型的关键。本数据集以《火焰之纹章》系列中角色哈琵为核心，通过自动化爬取系统从Danbooru、Pixiv、Zerochan等多个图像平台收集原始图像，最终筛选出205张高质量图片。数据采集由DeepGHS团队开发的Waifuc工具驱动，确保图像来源的多样性与标签的完整性。原始数据包含元信息与标签，并提供了多种预处理版本，包括限制短边不超过800或1200像素的标准化图像，以及基于三阶段裁剪策略生成的480x480像素以上区域数据集，以适应不同训练需求。

特点

该数据集以其精细的标签体系与多版本结构展现出独特价值。核心标签聚焦于角色的显性特征，如红发、深色皮肤、红眼及长发等，便于下游任务精准检索。数据包涵盖原始压缩包与经过尺寸归一化、裁剪增强的多个子集，其中三阶段裁剪版本将图像数量扩充至470张，显著提升了数据多样性。此外，数据集提供了标签聚类结果，将图像按外观特征（如服装、姿势）分为7个簇，并附带可视化样本与标签列表，为风格迁移、角色换装等研究提供了结构化分析基础。

使用方法

本数据集支持灵活的使用方式，尤其适用于文本到图像生成模型的训练与微调。用户可直接通过Hugging Face Hub下载不同版本的压缩包，并利用Waifuc库加载原始数据，通过Python脚本遍历图像及其关联标签。对于标准化版本，数据集直接提供图像与TXT标签文件，便于集成至常见训练管道。聚类信息以表格形式呈现，可供研究者快速筛选特定风格的子集。此外，数据集遵循MIT许可协议，允许自由用于学术与商业项目，但需注意部分内容可能包含非全年龄向标签，使用时需酌情处理。

背景与挑战

背景概述

在生成式人工智能领域，尤其是文本到图像合成任务中，高质量、标注精细的角色数据集是驱动模型性能提升的关键基石。CyberHarem/hapi_fireemblem数据集由DeepGHS团队于近年创建，专注于《火焰之纹章》系列中的角色哈比（Hapi），包含205张精心采集的图像及其对应的标签信息。该数据集的核心研究问题在于如何通过自动化爬取与多源整合（如Danbooru、Pixiv、Zerochan等平台），构建一个兼具视觉多样性与标签一致性的角色专属数据集，以支持角色概念的学习与迁移。其影响力体现在为二次元角色生成领域提供了标准化数据范例，推动了风格化图像生成模型在特定角色上的精细化调控能力。

当前挑战

该数据集面临的核心挑战体现在多个层面。首先，在领域问题层面，文本到图像模型常面临角色概念混淆与细粒度属性控制难题，例如哈比独特的红发、深色皮肤与红色眼眸等核心特征需在复杂场景中被精准保留，而数据集中仅205张样本的规模对模型泛化能力构成显著限制。其次，在构建过程中，自动爬取系统需应对多源数据异构性问题，包括不同平台图像分辨率差异、标签体系不统一（如日系与欧美标签混用）以及版权合规风险；同时，数据清洗阶段需剔除低质量或内容不当的图像，而多阶段裁剪策略（如stage3-p480-800）虽提升了构图多样性，却也引入了空间信息损失与标签对齐误差的潜在风险。

常用场景

经典使用场景

在文本到图像生成领域，CyberHarem/hapi_fireemblem数据集为角色定制化生成提供了高质量的图像与标签对。该数据集收录了《火焰之纹章》中哈琵这一角色的205张图像，并附有经过清洗的核心标签如红发、深色皮肤等。研究者可借助此数据集训练或微调扩散模型，实现基于文本描述精准还原角色外貌、服饰与姿态的生成任务，是动漫角色个性化生成研究的理想基准。

衍生相关工作

该数据集衍生的工作主要集中于角色成分解耦与多尺度图像生成方法。例如，基于标签聚类结果，研究者可构建角色部件级生成模块，实现服装、发型等属性的独立控制；同时，不同分辨率的版本促进了级联扩散模型与超分辨率网络的联合训练，为高保真动漫角色生成提供了标准化的评估平台，并启发了后续针对小众角色数据集的构建规范。

数据集最近研究

最新研究方向

在二次元角色数据集构建领域，CyberHarem/hapi_fireemblem 数据集为文本到图像生成任务提供了细粒度的标注资源。该数据集聚焦于《火焰之纹章》系列中哈琵这一角色，收录了205张图像及其标签，核心特征包括红发、深色皮肤、红瞳等。当前前沿研究方向集中于利用此类精细化标注数据集提升生成模型的角色一致性，并探索多模态标签对生成质量的影响。此外，该数据集通过自动爬取系统整合了Danbooru、Pixiv等多源图像，反映了社区驱动的数据收集与自动化标注技术的进步，对推动二次元角色生成模型的个性化与可控性具有显著意义。