Total runs:
66.6K
Run Growth:
-4.9K
Growth Rate:
-7.38%
Sponsored by
iMean AI Trip Planner
lodestones / taggerine
Model's Last Updated: April 28 2026
image-classification
Introduction of taggerine
Model Details of taggerine
DINOv3 ViT-H/16+ Booru Tagger
A multi-label image tagger trained on e621 and Danbooru annotations, using a DINOv3 ViT-H/16+ backbone fine-tuned end-to-end with a single linear projection head.
Model Details
| Property | Value |
|---|---|
| Backbone |
facebook/dinov3-vith16plus-pretrain-lvd1689m
|
| Architecture | ViT-H/16+ · 32 layers · hidden dim 1280 · 20 heads · SwiGLU MLP · RoPE · 4 register tokens |
| Head |
Linear((1 + 4) × 1280 → 74 625)
— CLS + 4 register tokens concatenated
|
| Vocabulary | 74 625 tags (min frequency ≥ 50 across training set) |
| Input resolution | Any multiple of 16 px — trained at 512 px, generalises to higher resolutions |
| Input normalisation |
ImageNet mean/std
[0.485, 0.456, 0.406]
/
[0.229, 0.224, 0.225]
|
| Output |
Raw logits — apply
sigmoid
for per-tag probabilities
|
| Parameters | ~632 M (backbone) + ~480 M (head) |
Training
| Hyperparameter | Value |
|---|---|
| Training data | e621 + Danbooru (parquet) |
| Batch size | 32 |
| Learning rate | 1e-6 |
| Warmup steps | 50 |
| Loss |
BCEWithLogitsLoss
with per-tag
pos_weight = (neg/pos)^(1/T)
, cap 100
|
| Optimiser | AdamW (β₁=0.9, β₂=0.999, wd=0.01) |
| Precision | bfloat16 (backbone) / float32 (projection + loss) |
| Hardware | 2× GPU, ThreadPoolExecutor + NCCL all-reduce |
Usage
1. Install dependencies
pip install -r requirements.txt
Or manually:
pip install torch torchvision safetensors Pillow requests \
python-multipart fastapi uvicorn jinja2 aiofiles
2. Download model files
huggingface-cli download lodestones/taggerine \
tagger_proto.safetensors \
tagger_vocab_with_categories_and_alias_updated.json \
tagger_ui_server.py \
inference_tagger_standalone.py \
--local-dir .
Note:
tagger_proto.safetensorsis ~5.3 GB. Make sure you have enough disk space.
3. Download the
tagger_ui/
templates folder
The server requires the
tagger_ui/templates/
directory to be present alongside
tagger_ui_server.py
:
huggingface-cli download lodestones/taggerine \
--include "tagger_ui/**" \
--local-dir .
4. Run the Web UI
python tagger_ui_server.py \
--checkpoint tagger_proto.safetensors \
--vocab tagger_vocab_with_categories_and_alias_updated.json \
--port 7860
# → open http://localhost:7860
CPU-only machine?
Add
--device cpu
(inference will be slower):
python tagger_ui_server.py \
--checkpoint tagger_proto.safetensors \
--vocab tagger_vocab_with_categories_and_alias_updated.json \
--device cpu \
--port 7860
Standalone CLI inference (no server)
python inference_tagger_standalone.py \
--checkpoint tagger_proto.safetensors \
--vocab tagger_vocab_with_categories_and_alias_updated.json \
--images photo.jpg \
--topk 30
Files
| File | Description |
|---|---|
tagger_proto.safetensors
|
Model weights (bfloat16) |
tagger_vocab_with_categories_and_alias_updated.json
|
{"idx2tag": [...], "tag2category": {...}}
— 74 625 tags with category metadata
|
tagger_vocab_with_categories.json
|
Same without alias data |
tagger_vocab.json
|
Minimal vocab —
{"idx2tag": [...]}
only
|
inference_tagger_standalone.py
|
Self-contained CLI inference script (no
transformers
dep)
|
tagger_ui_server.py
|
FastAPI + Jinja2 web UI server |
requirements.txt
|
Python dependencies |
Tag Vocabulary
Tags are sourced from e621 and Danbooru annotations and cover:
-
Subject
— species, character count, gender (
solo,duo,anthro,1girl,male, …) - Body — anatomy, fur/scale/skin markings, body parts
-
Action / pose
—
looking at viewer,sitting, … - Scene — background, lighting, setting
-
Style
—
digital art,hi res,sketch,watercolor, … - Rating — explicit content tags are included; filter as needed for your use case
Minimum tag frequency threshold: 50 occurrences across the combined dataset.
Limitations
- Evaluated on booru-style illustrations and furry art; performance on photographic images or other art works to some extend.
- The vocabulary reflects the biases of e621 and Danbooru annotation practices.
License
Apache 2.0
Runs of lodestones taggerine on huggingface.co
0
Total runs
0
24-hour runs
0
3-day runs
0
7-day runs
0
30-day runs
More Information About taggerine huggingface.co Model
Url of taggerine
taggerine huggingface.co Url
Provider of taggerine huggingface.co
Other API from lodestones
Updated:October 23 2025
Total runs:
61.8K
Run Growth:
18.4K
Growth Rate:
29.82%
Total runs:
13.2K
Run Growth:
-32.6K
Growth Rate:
-247.20%
Total runs:
18
Run Growth:
15
Growth Rate:
83.33%
Total runs:
16
Run Growth:
8
Growth Rate:
50.00%
Total runs:
10
Run Growth:
6
Growth Rate:
60.00%
Total runs:
10
Run Growth:
7
Growth Rate:
70.00%
Total runs:
8
Run Growth:
5
Growth Rate:
62.50%
Total runs:
8
Run Growth:
-6
Growth Rate:
-75.00%
Total runs:
8
Run Growth:
-1
Growth Rate:
-12.50%
Total runs:
6
Run Growth:
0
Growth Rate:
0.00%
Total runs:
5
Run Growth:
1
Growth Rate:
20.00%
Total runs:
4
Run Growth:
3
Growth Rate:
75.00%
Total runs:
3
Run Growth:
-5
Growth Rate:
-166.67%
Total runs:
3
Run Growth:
0
Growth Rate:
0.00%
Total runs:
3
Run Growth:
1
Growth Rate:
33.33%
Total runs:
2
Run Growth:
-1
Growth Rate:
-50.00%
Total runs:
1
Run Growth:
-1
Growth Rate:
-100.00%
Total runs:
0
Run Growth:
0
Growth Rate:
0.00%
Total runs:
0
Run Growth:
0
Growth Rate:
0.00%
Total runs:
0
Run Growth:
0
Growth Rate:
0.00%
Total runs:
0
Run Growth:
0
Growth Rate:
0.00%
Total runs:
0
Run Growth:
0
Growth Rate:
0.00%
Total runs:
0
Run Growth:
0
Growth Rate:
0.00%
Total runs:
0
Run Growth:
0
Growth Rate:
0.00%
Total runs:
0
Run Growth:
0
Growth Rate:
0.00%
Total runs:
0
Run Growth:
0
Growth Rate:
0.00%
Total runs:
0
Run Growth:
0
Growth Rate:
0.00%
Total runs:
0
Run Growth:
0
Growth Rate:
0.00%
Total runs:
0
Run Growth:
0
Growth Rate:
0.00%
Total runs:
0
Run Growth:
0
Growth Rate:
0.00%
Total runs:
0
Run Growth:
0
Growth Rate:
0.00%
Total runs:
0
Run Growth:
0
Growth Rate:
0.00%
Total runs:
0
Run Growth:
0
Growth Rate:
0.00%
Total runs:
0
Run Growth:
0
Growth Rate:
0.00%
Total runs:
0
Run Growth:
0
Growth Rate:
0.00%
Total runs:
0
Run Growth:
0
Growth Rate:
0.00%
Total runs:
0
Run Growth:
0
Growth Rate:
0.00%
Total runs:
0
Run Growth:
0
Growth Rate:
0.00%
Total runs:
0
Run Growth:
0
Growth Rate:
0.00%
Total runs:
0
Run Growth:
0
Growth Rate:
0.00%