README.md

---
license: openrail++
tags:
- text-to-image
- stable-diffusion
- diffusers
widget:
- text: score_9, 2boys, male focus, multiple boys, yaoi, couple, princess carry, carrying, collared shirt, shirt, pants, jacket, looking at another, smile, wedding, absurdres, highres, year 2025
  parameters:
    negative_prompt: score_1, score_2, score_3, lowres, artistic error, film grain, scan artifacts, jpeg artifacts, chromatic aberration, dithering, halftone, screentones, multiple views, logo, too many watermarks, negative space, blank page
  output:
    url: images/sample01.png
  example_title: sample01
- text: score_9, A handsome anime boy playing acoustic guitar in living room at home, absurdres, highres
  parameters:
    negative_prompt: score_1, score_2, score_3, lowres, artistic error, film grain, scan artifacts, jpeg artifacts, chromatic aberration, dithering, halftone, screentones, multiple views, logo, too many watermarks, negative space, blank page
  output:
    url: images/sample02.png
  example_title: sample02
- text: score_9, tachibana makoto, free!, 1boy, male focus, solo, lying, on bed, bed, pillow, bedroom, shirt, pants, looking at viewer, one eye closed, sleepy, open mouth, absurdres, highres, year 2025
  parameters:
    negative_prompt: score_1, score_2, score_3, lowres, artistic error, film grain, scan artifacts, jpeg artifacts, chromatic aberration, dithering, halftone, screentones, multiple views, logo, too many watermarks, negative space, blank page
  output:
    url: images/sample03.png
  example_title: sample03
- text: score_9, 2boys, male focus, multiple boys, rating:general, arm around shoulder, tank top, shorts, bara, muscular male, muscular, baseball cap, hat, looking at viewer, absurdres, highres, year 2025
  parameters:
    negative_prompt: score_1, score_2, score_3, lowres, artistic error, film grain, scan artifacts, jpeg artifacts, chromatic aberration, dithering, halftone, screentones, multiple views, logo, too many watermarks, negative space, blank page
  output:
    url: images/sample04.png
  example_title: sample04
---

# AnimeBoysZeroXL

**Creating models is a labor of love, but it takes a significant amount of time and compute power to get them just right. If you’re enjoying my models, consider fueling my next project with a coffee on [Ko-fi](https://ko-fi.com/koolchh) ☕. Thank you for keeping this project going!**

<Gallery />

A dedicated model for high-quality anime-style male characters. This model is specifically optimized for males-only content, offering a wide range of aesthetic styles and high versatility.

## 🚀 Inference Guide
- **⚠️ Important**: This model uses Zero Terminal SNR with V-prediction. Please ensure you are using the correct settings during inference.
  - **ComfyUI Users**: Add the `ModelSamplingDiscrete` node into your workflow. Set `sampling` to `v_prediction`, `zsnr` to `true`.
  - **Automatic1111 Users**: Place the `.yaml` config file into the model folder. The .yaml file must have the exact same name as the model file, only with the `.yaml` extension instead of `.safetensors`. Set `Noise schedule for sampling` in settings to `Zero Terminal SNR`.
- **Prompting**: Always begin your prompt with a score tag (e.g. `score_9`). You can use any of these styles:
  - Tag soup: `score_X, tag1, tag2, tag3, ...`
  - Natural language: `score_X, [your description here]`
  - Mixed approach: `score_X, [description], tag1, tag2, ...`
  - *Tip*: If you find the style of the score tags is too strong, you could try dropping them from the prompt.
- **Negative Prompt**: Choose from one of these three presets depending on your needs:
  - **Minimal**: `score_1`
  - **Light**: `score_1, lowres, artistic error, scan artifacts, jpeg artifacts, multiple views, too many watermarks, negative space, blank page`
  - **Heavy**: `score_1, score_2, score_3, lowres, artistic error, film grain, scan artifacts, jpeg artifacts, chromatic aberration, dithering, halftone, screentones, multiple views, logo, too many watermarks, negative space, blank page`
- **CFG Scale**: A CFG scale of **3 to 5** is recommended. For finer control, I suggest using [dynamic thresholding](https://github.com/mcmonkeyprojects/sd-dynamic-thresholding).
  - *Pro-tip*: I set `mimic_scale` to match the CFG scale and set both minimum scales to the same lower value. I use `Half Cosine Up` for both modes.
- **Resolution**: To get started, try these dimensions:
  - **Portrait**: 832 × 1216
  - **Square**: 1024 × 1024
  - **Landscape**: 1216 × 832
  - *Some other supported sizes*: 768×1344, 768×1280, 896×1152, 960×1088, 1344×768, 1280×768, 1152×896, 1088×960.

## 🧨 Diffusers Example Usage

```python
import torch
from diffusers import DiffusionPipeline

pipe = DiffusionPipeline.from_pretrained(
    "Koolchh/AnimeBoysZeroXL",
    torch_dtype=torch.float16,
    use_safetensors=True,
    variant="fp16"
)
pipe.to("cuda")

prompt = "score_9, 1boy, male focus, shirt, solo, looking at viewer, smile, black hair, brown eyes, short hair"
negative_prompt = "score_1"

image = pipe(
    prompt=prompt, 
    negative_prompt=negative_prompt, 
    width=1024,
    height=1024,
    guidance_scale=5,
    num_inference_steps=28
).images[0]
```

## 🧪 Training Details

AnimeBoysZeroXL was fine-tuned from [Pony Diffusion V6 XL](https://civitai.com/models/257749/pony-diffusion-v6-xl) using approximately 950k images. The knowledge cutoff is November 2025.

The following tags were used during training to help you steer the results toward your desired style.

### Score tags

- Each image is tagged with `score_X`, where `X` is a range from **1 to 9**.
  - `score_9` represents the highest aesthetic quality based on my personal preferences.

### Rating tags

| tag                   | rating       |
|-----------------------|--------------|
| `rating:general`      | general      |
| `rating:sensitive`    | sensitive    |
| `rating:questionable` | questionable |
| `rating:explicit`     | explicit     |

### Year tags

Use `year YYYY` (ranging from 2005 to 2025) to target specific era styles.

### Training configurations
- **Hardware**: 4 × Nvidia A100 SXM 80GB
- **Optimizer**: AdaFactor
- **Gradient Accumulation Steps**: 8
- **Effective Batch Size**: 128 (4 × 8 × 4)
- **Learning Rates**:
  - **U-Net**: 2e-5
  - **Text Encoders**: 1e-5
- **LR Schedule**: Constant with 250 warmup steps
- **Precision**: FP16 Mixed Precision

### 🔄 Changes from AnimeBoysXL v3.0
- **Tag Overhaul**: Quality tags have been removed. The 5-category aesthetic tags have been replaced with a more granular 9-category score tag system. Renamed rating tags for better clarity. Abolished the tag ordering scheme.
- **Captions**: A subset of highly aesthetic images was trained using natural language prompts for better comprehension.
- **Emphasis**: Highly aesthetic images now have more "repeats" in the training data.
- **Optimization**:
  - 5% caption dropout for unconditional guidance.
  - Trained with Zero Terminal SNR and V-prediction.
  - Implemented adaptive loss weighting.
  - No multi-resolution noise or debiased estimation loss.
  - Trained with input perturbation noise (gamma=0.1).
  - Trained with huber loss.
- **Merging**: This model is a merge across several iterations of the same training run for better stability.

## License

AnimeBoysZeroXL is a derivative model of [Pony Diffusion V6 XL](https://civitai.com/models/257749/pony-diffusion-v6-xl) by PurpleSmartAI. Please read their license before using the model.