CyberHarem/minami_kotori_lovelive

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

# Dataset of minami_kotori/南ことり/미나미코토리 (Love Live!)

This is the dataset of minami_kotori/南ことり/미나미코토리 (Love Live!), containing 500 images and their tags.

The core tags of this character are `long_hair, brown_hair, one_side_up, yellow_eyes, bow, hair_bow, brown_eyes, bangs, 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 | 500 | 677.73 MiB | [Download](https://huggingface.co/datasets/CyberHarem/minami_kotori_lovelive/resolve/main/dataset-raw.zip) | Waifuc-Raw | Raw data with meta information (min edge aligned to 1400 if larger). |
| 800 | 500 | 399.31 MiB | [Download](https://huggingface.co/datasets/CyberHarem/minami_kotori_lovelive/resolve/main/dataset-800.zip) | IMG+TXT | dataset with the shorter side not exceeding 800 pixels. |
| stage3-p480-800 | 1185 | 838.65 MiB | [Download](https://huggingface.co/datasets/CyberHarem/minami_kotori_lovelive/resolve/main/dataset-stage3-p480-800.zip) | IMG+TXT | 3-stage cropped dataset with the area not less than 480x480 pixels. |
| 1200 | 500 | 596.84 MiB | [Download](https://huggingface.co/datasets/CyberHarem/minami_kotori_lovelive/resolve/main/dataset-1200.zip) | IMG+TXT | dataset with the shorter side not exceeding 1200 pixels. |
| stage3-p480-1200 | 1185 | 1.15 GiB | [Download](https://huggingface.co/datasets/CyberHarem/minami_kotori_lovelive/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/minami_kotori_lovelive',
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 | 24 |  |  |  |  |  | 1girl, otonokizaka_school_uniform, solo, green_bow, smile, looking_at_viewer, striped_bowtie, red_bowtie, white_shirt, blue_skirt, blush, plaid_skirt, pleated_skirt, winter_uniform, blazer, collared_shirt, long_sleeves, blue_jacket, miniskirt, white_background, single_hair_ring, simple_background |
| 1 | 21 |  |  |  |  |  | 1girl, solo, apron, looking_at_viewer, maid_headdress, blush, open_mouth, :d |
| 2 | 12 |  |  |  |  |  | 1girl, looking_at_viewer, maid_headdress, solo, blush, neck_ribbon, smile, white_apron, black_ribbon, maid_apron, enmaided, single_hair_ring, very_long_hair, green_bow, open_mouth, puffy_short_sleeves, simple_background, upper_body, white_background |
| 3 | 14 |  |  |  |  |  | looking_at_viewer, smile, 1girl, solo, hair_ornament, earrings, white_gloves, dress, open_mouth, blush, choker, simple_background, white_background, white_thighhighs |
| 4 | 7 |  |  |  |  |  | 1girl, looking_at_viewer, solo, blush, bokura_wa_ima_no_naka_de, fingerless_gloves, skirt, smile, navel, open_mouth, earrings, suspenders, ;d, bridal_garter, medium_breasts, one_eye_closed, simple_background, white_background |
| 5 | 12 |  |  |  |  |  | 1girl, open_mouth, solo, looking_at_viewer, :d, skirt, vertical-striped_thighhighs, detached_sleeves, scepter, bird, mismatched_legwear, navel, ribbon, mini_crown |
| 6 | 7 |  |  |  |  |  | 1girl, earrings, looking_at_viewer, solo, blush, hair_flower, choker, collarbone, detached_sleeves, frills, heart, smile, x_hair_ornament, maid_headdress, angel_wings, cleavage, happy_birthday, holding, striped_thighhighs |
| 7 | 7 |  |  |  |  |  | 1girl, solo, looking_at_viewer, collarbone, sleeveless, smile, flower, head_wreath, white_background, bare_shoulders, blush, upper_body, white_dress |
| 8 | 6 |  |  |  |  |  | 1girl, looking_at_viewer, ribbon, smile, solo, wings, sleeveless, frills, hair_flower, headset, layered_skirt, blush, x_hair_ornament |
| 9 | 27 |  |  |  |  |  | 1girl, solo, looking_at_viewer, navel, medium_breasts, smile, blush, green_bikini, cleavage, side-tie_bikini_bottom, open_mouth, day, sky |

### Table Version

| # | Samples | Img-1 | Img-2 | Img-3 | Img-4 | Img-5 | 1girl | otonokizaka_school_uniform | solo | green_bow | smile | looking_at_viewer | striped_bowtie | red_bowtie | white_shirt | blue_skirt | blush | plaid_skirt | pleated_skirt | winter_uniform | blazer | collared_shirt | long_sleeves | blue_jacket | miniskirt | white_background | single_hair_ring | simple_background | apron | maid_headdress | open_mouth | :d | neck_ribbon | white_apron | black_ribbon | maid_apron | enmaided | very_long_hair | puffy_short_sleeves | upper_body | hair_ornament | earrings | white_gloves | dress | choker | white_thighhighs | bokura_wa_ima_no_naka_de | fingerless_gloves | skirt | navel | suspenders | ;d | bridal_garter | medium_breasts | one_eye_closed | vertical-striped_thighhighs | detached_sleeves | scepter | bird | mismatched_legwear | ribbon | mini_crown | hair_flower | collarbone | frills | heart | x_hair_ornament | angel_wings | cleavage | happy_birthday | holding | striped_thighhighs | sleeveless | flower | head_wreath | bare_shoulders | white_dress | wings | headset | layered_skirt | green_bikini | side-tie_bikini_bottom | day | sky |
|----:|----------:|:--------------------------------|:--------------------------------|:--------------------------------|:--------------------------------|:--------------------------------|:--------|:-----------------------------|:-------|:------------|:--------|:--------------------|:-----------------|:-------------|:--------------|:-------------|:--------|:--------------|:----------------|:-----------------|:---------|:-----------------|:---------------|:--------------|:------------|:-------------------|:-------------------|:--------------------|:--------|:-----------------|:-------------|:-----|:--------------|:--------------|:---------------|:-------------|:-----------|:-----------------|:----------------------|:-------------|:----------------|:-----------|:---------------|:--------|:---------|:-------------------|:---------------------------|:--------------------|:--------|:--------|:-------------|:-----|:----------------|:-----------------|:-----------------|:------------------------------|:-------------------|:----------|:-------|:---------------------|:---------|:-------------|:--------------|:-------------|:---------|:--------|:------------------|:--------------|:-----------|:-----------------|:----------|:---------------------|:-------------|:---------|:--------------|:-----------------|:--------------|:--------|:----------|:----------------|:---------------|:-------------------------|:------|:------|
| 0 | 24 |  |  |  |  |  | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| 1 | 21 |  |  |  |  |  | X | | X | | | X | | | | | X | | | | | | | | | | | | X | X | X | X | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| 2 | 12 |  |  |  |  |  | X | | X | X | X | X | | | | | X | | | | | | | | | X | X | X | | X | X | | X | X | X | X | X | X | X | X | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| 3 | 14 |  |  |  |  |  | X | | X | | X | X | | | | | X | | | | | | | | | X | | X | | | X | | | | | | | | | | X | X | X | X | X | X | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| 4 | 7 |  |  |  |  |  | X | | X | | X | X | | | | | X | | | | | | | | | X | | X | | | X | | | | | | | | | | | X | | | | | X | X | X | X | X | X | X | X | X | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| 5 | 12 |  |  |  |  |  | X | | X | | | X | | | | | | | | | | | | | | | | | | | X | X | | | | | | | | | | | | | | | | | X | X | | | | | | X | X | X | X | X | X | X | | | | | | | | | | | | | | | | | | | | | | |
| 6 | 7 |  |  |  |  |  | X | | X | | X | X | | | | | X | | | | | | | | | | | | | X | | | | | | | | | | | | X | | | X | | | | | | | | | | | | X | | | | | | X | X | X | X | X | X | X | X | X | X | | | | | | | | | | | | |
| 7 | 7 |  |  |  |  |  | X | | X | | X | X | | | | | X | | | | | | | | | X | | | | | | | | | | | | | | X | | | | | | | | | | | | | | | | | | | | | | | | X | | | | | | | | | X | X | X | X | X | | | | | | | |
| 8 | 6 |  |  |  |  |  | X | | X | | X | X | | | | | X | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | X | | X | | X | | X | | | | | | X | | | | | X | X | X | | | | |
| 9 | 27 |  |  |  |  |  | X | | X | | X | X | | | | | X | | | | | | | | | | | | | | X | | | | | | | | | | | | | | | | | | | X | | | | X | | | | | | | | | | | | | | | X | | | | | | | | | | | | X | X | X | X |

原始信息汇总

数据集概述

数据集基本信息

• 名称: Dataset of minami_kotori/南ことり/미나미코토리 (Love Live!)
• 许可证: MIT
• 任务类别: text-to-image
• 标签: art, not-for-all-audiences
• 大小类别: n<1K

数据集内容

• 图像数量: 500张
• 核心标签: long_hair, brown_hair, one_side_up, yellow_eyes, bow, hair_bow, brown_eyes, bangs, breasts

数据集包列表

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

标签聚类结果

原始文本版本

#	样本数量	图像示例	标签
0	24		1girl, otonokizaka_school_uniform, solo, green_bow, smile, looking_at_viewer, striped_bowtie, red_bowtie, white_shirt, blue_skirt, blush, plaid_skirt, pleated_skirt, winter_uniform, blazer, collared_shirt, long_sleeves, blue_jacket, miniskirt, white_background, single_hair_ring, simple_background
1	21		1girl, solo, apron, looking_at_viewer, maid_headdress, blush, open_mouth, :d
2	12		1girl, looking_at_viewer, maid_headdress, solo, blush, neck_ribbon, smile, white_apron, black_ribbon, maid_apron, enmaided, single_hair_ring, very_long_hair, green_bow, open_mouth, puffy_short_sleeves, simple_background, upper_body, white_background
3	14		looking_at_viewer, smile, 1girl, solo, hair_ornament, earrings, white_gloves, dress, open_mouth, blush, choker, simple_background, white_background, white_thighhighs
4	7		1girl, looking_at_viewer, solo, blush, bokura_wa_ima_no_naka_de, fingerless_gloves, skirt, smile, navel, open_mouth, earrings, suspenders, ;d, bridal_garter, medium_breasts, one_eye_closed, simple_background, white_background
5	12		1girl, open_mouth, solo, looking_at_viewer, :d, skirt, vertical-striped_thighhighs, detached_sleeves, scepter, bird, mismatched_legwear, navel, ribbon, mini_crown
6	7		1girl, earrings, looking_at_viewer, solo, blush, hair_flower, choker, collarbone, detached_sleeves, frills, heart, smile, x_hair_ornament, maid_headdress, angel_wings, cleavage, happy_birthday, holding, striped_thighhighs
7	7		1girl, solo, looking_at_viewer, collarbone, sleeveless, smile, flower, head_wreath, white_background, bare_shoulders, blush, upper_body, white_dress
8	6		1girl, looking_at_viewer, ribbon, smile, solo, wings, sleeveless, frills, hair_flower, headset, layered_skirt, blush, x_hair_ornament
9	27		1girl, solo, looking_at_viewer, navel, medium_breasts, smile, blush, green_bikini, cleavage, side-tie_bikini_bottom, open_mouth, day, sky

搜集汇总

数据集介绍

构建方式

在动漫角色数据集构建领域，针对《Love Live!》中的南小鸟（南ことり）形象，本数据集通过自动化爬取系统从Danbooru、Pixiv、Zerochan等多个知名图像站点收集了500幅高质量图像及其标注标签。该自动化流程由DeepGHS团队研发的Waifuc框架驱动，确保了数据采集的广度与效率。原始图像经预处理后，其短边对齐至1400像素以上，以保留丰富细节。数据集提供了多种规格的压缩版本，包括短边不超过800或1200像素的常规尺寸，以及经过三阶段裁剪、面积不低于480×480像素的增强版本，以满足不同训练需求。每个版本均包含图像与对应的TXT标签文件，方便直接使用。

特点

该数据集的核心特色在于其精细的标签体系与聚类分析能力。角色核心标签如长发、棕发、单侧束发、黄瞳、蝴蝶结等已被系统化整理，便于模型精确捕捉角色特征。数据集不仅提供了原始元数据，还通过标签聚类技术将图像划分为多个语义簇，例如音乃木坂学院制服、女仆装、礼服等穿搭主题，每个簇均附有代表性样本缩略图与完整标签列表。这种聚类结构为研究者挖掘角色在不同场景下的视觉风格提供了便利，尤其适用于文本到图像生成任务中的风格迁移与细粒度控制。

使用方法

本数据集支持多种加载方式，推荐使用Waifuc框架进行高效读取。用户可通过Hugging Face Hub下载原始ZIP压缩包，解压后利用LocalSource接口逐项获取图像及其元数据，包括文件名与标签信息。对于需要快速实验的场景，可直接选用预处理的800或1200像素版本，其标签文件与图像一一对应，无需额外解析。此外，三阶段裁剪版本尤其适合需要固定输入尺寸的生成模型，减少了手动预处理的工作量。研究者亦可基于提供的聚类结果，筛选特定风格的子集进行针对性训练或评估。

背景与挑战

背景概述

在文本到图像生成领域，高质量、精细标注的角色数据集是驱动模型掌握特定视觉概念的关键。CyberHarem/minami_kotori_lovelive 数据集由 DeepGHS 团队于近期创建，聚焦于《Love Live!》系列中人气角色南小鸟（南ことり）。该数据集的核心研究问题在于如何系统性地收集并结构化动漫角色图像，以支持生成模型对角色外观、服饰及姿态的精准学习。通过从 Danbooru、Pixiv 等多源平台自动化爬取并人工筛选后，数据集收录了 500 张图像及对应的标签信息，并提供了多分辨率与裁剪版本，极大便利了研究者针对不同任务需求进行调用。这一工作不仅填补了特定二次元角色精细化数据集的空白，也为后续动漫角色生成与风格迁移研究奠定了重要基础。

当前挑战

该数据集所面临的挑战首先体现在领域问题的复杂性上：动漫角色图像普遍存在风格多样、视角多变、服饰搭配丰富的特点，如何确保生成模型在捕捉角色核心特征（如发型、发色、眼睛颜色等）的同时，能够泛化至不同画风与场景，是亟待解决的难题。其次，在构建过程中，自动化爬取虽提升了效率，却引入了图像质量参差不齐、标签噪声高、版权归属模糊等问题。例如，来自不同源站的图像分辨率差异显著，需进行边缘对齐与裁剪处理；自动标注的标签可能存在遗漏或冗余，需人工校验与聚类分析。此外，数据集的规模仅 500 张，在应对复杂生成任务时可能面临过拟合风险，限制了模型的泛化能力。

常用场景

经典使用场景

在动漫角色生成与风格迁移领域，该数据集为南小鸟（南ことり）这一经典角色提供了高质量的图像与标签配对资源。研究者可借助其丰富的服饰、姿态与场景变体，训练文本到图像的生成模型，例如基于扩散模型或生成对抗网络的方法，实现从文本描述到角色肖像的精准映射。该数据集的多分辨率版本与裁剪策略，为模型在细节保留与计算效率之间的权衡提供了灵活的实验基准。

解决学术问题

该数据集有效解决了二次元角色视觉生成中数据稀缺与标注不一致的学术难题。通过系统化爬取多源图像并统一标注核心标签（如发型、服饰、表情），它为可控图像生成、多模态对齐以及细粒度属性编辑等研究方向提供了标准化的训练与评估基础。其意义在于推动了面向特定角色的一致性生成研究，并促进了动漫图像领域从粗粒度分类向精细化语义控制的范式转变。

衍生相关工作

该数据集衍生的工作包括基于角色标签聚类的服装风格迁移研究，以及面向多角色统一生成框架的预训练模型微调策略。例如，部分工作利用其聚类信息挖掘角色特定配饰（如发饰、领结）的生成规律，进而提出解耦式属性编辑方法。另有研究将其作为二次元人物身份保持生成（Identity-Preserving Generation）的基准，推动了角色一致性在文本到图像模型中的评估体系构建。