README.md

---
title: Anime Artist Style Embedder
emoji: 🎨
colorFrom: red
colorTo: yellow
sdk: gradio
sdk_version: 4.44.1
app_file: app.py
pinned: false
license: other
---

# Anime Artist Style Embedder

This Space runs artist-style retrieval with the included DINOv3-based model and base prototype bank.

## Runtime Assets

- `artifacts/style_training_dinov3/best.pt`
- `artifacts/style_training_dinov3/artist_prototypes.pt`
- `artifacts/pretrained/dinov3/dinov3_vits16_pretrain_lvd1689m-08c60483.pth`
- `third_party/dinov3/`
- `yolov5_anime/` with the compact `weights/yolov5s_anime.pt`
- `anime-eyes-cascade.xml`

The larger `yolov5x_anime.pt` is intentionally not bundled to keep the Space repository under the 1GB upload limit. The bundled `yolov5s_anime.pt` is used by default. To use `x` instead, upload it to an attached Storage Bucket mounted at `/data`, for example:

```text
/data/assets/yolov5x_anime.pt
```

That is the default path used by this Space. To use another path, set:

```bash
YOLO_WEIGHTS=/data/assets/yolov5x_anime.pt
```

The same override pattern is available for:

- `ARTIST_STYLE_CHECKPOINT`
- `ARTIST_PROTOTYPES`
- `DINOV3_ROOT`
- `DINOV3_WEIGHTS`
- `YOLO_ANIME_ROOT`
- `YOLO_WEIGHTS`
- `EYE_CASCADE`

## Added Artists

Base artists are read-only. Artists added from the Space UI are stored separately under:

- `/data/custom_store` when persistent storage is mounted
- `custom_store/` otherwise

For durable user-added artists on Hugging Face Spaces, enable persistent storage or set up an external Dataset-backed sync before public use.

## Licenses

This Space includes DINOv3 materials under the DINOv3 License. The optional auto-crop pipeline uses `yolov5_anime` and Haar Cascade Anime Eye Detector materials, both under GPL-3.0. See the upstream license files in the bundled third-party folders.