BiliSakura commited on
Commit
28463c6
·
verified ·
1 Parent(s): 64cf3b0

Upload folder using huggingface_hub

Browse files
Files changed (36) hide show
  1. .gitattributes +1 -0
  2. DiCo-B-256/model_index.json +1021 -0
  3. DiCo-B-256/pipeline.py +398 -0
  4. DiCo-B-256/scheduler/scheduler_config.json +12 -0
  5. DiCo-B-256/transformer/config.json +14 -0
  6. DiCo-B-256/transformer/diffusion_pytorch_model.safetensors +3 -0
  7. DiCo-B-256/transformer/transformer_dico.py +479 -0
  8. DiCo-B-256/vae/config.json +38 -0
  9. DiCo-B-256/vae/diffusion_pytorch_model.safetensors +3 -0
  10. DiCo-L-256/model_index.json +1021 -0
  11. DiCo-L-256/pipeline.py +398 -0
  12. DiCo-L-256/scheduler/scheduler_config.json +12 -0
  13. DiCo-L-256/transformer/config.json +14 -0
  14. DiCo-L-256/transformer/diffusion_pytorch_model.safetensors +3 -0
  15. DiCo-L-256/transformer/transformer_dico.py +479 -0
  16. DiCo-L-256/vae/config.json +38 -0
  17. DiCo-L-256/vae/diffusion_pytorch_model.safetensors +3 -0
  18. DiCo-S-256/model_index.json +1021 -0
  19. DiCo-S-256/pipeline.py +398 -0
  20. DiCo-S-256/scheduler/scheduler_config.json +12 -0
  21. DiCo-S-256/transformer/config.json +14 -0
  22. DiCo-S-256/transformer/diffusion_pytorch_model.safetensors +3 -0
  23. DiCo-S-256/transformer/transformer_dico.py +479 -0
  24. DiCo-S-256/vae/config.json +38 -0
  25. DiCo-S-256/vae/diffusion_pytorch_model.safetensors +3 -0
  26. DiCo-XL-256/demo.png +3 -0
  27. DiCo-XL-256/model_index.json +1021 -0
  28. DiCo-XL-256/pipeline.py +398 -0
  29. DiCo-XL-256/scheduler/scheduler_config.json +12 -0
  30. DiCo-XL-256/transformer/config.json +14 -0
  31. DiCo-XL-256/transformer/diffusion_pytorch_model.safetensors +3 -0
  32. DiCo-XL-256/transformer/transformer_dico.py +479 -0
  33. DiCo-XL-256/vae/config.json +38 -0
  34. DiCo-XL-256/vae/diffusion_pytorch_model.safetensors +3 -0
  35. README.md +150 -0
  36. demo_inference.py +88 -0
.gitattributes CHANGED
@@ -33,3 +33,4 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
33
  *.zip filter=lfs diff=lfs merge=lfs -text
34
  *.zst filter=lfs diff=lfs merge=lfs -text
35
  *tfevents* filter=lfs diff=lfs merge=lfs -text
 
 
33
  *.zip filter=lfs diff=lfs merge=lfs -text
34
  *.zst filter=lfs diff=lfs merge=lfs -text
35
  *tfevents* filter=lfs diff=lfs merge=lfs -text
36
+ DiCo-XL-256/demo.png filter=lfs diff=lfs merge=lfs -text
DiCo-B-256/model_index.json ADDED
@@ -0,0 +1,1021 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "_class_name": [
3
+ "pipeline",
4
+ "DiCoPipeline"
5
+ ],
6
+ "_diffusers_version": "0.38.0",
7
+ "scheduler": [
8
+ "diffusers",
9
+ "DDIMScheduler"
10
+ ],
11
+ "transformer": [
12
+ "transformer_dico",
13
+ "DiCoTransformer2DModel"
14
+ ],
15
+ "vae": [
16
+ "diffusers",
17
+ "AutoencoderKL"
18
+ ],
19
+ "id2label": {
20
+ "0": "tench, Tinca tinca",
21
+ "1": "goldfish, Carassius auratus",
22
+ "2": "great white shark, white shark, man-eater, man-eating shark, Carcharodon carcharias",
23
+ "3": "tiger shark, Galeocerdo cuvieri",
24
+ "4": "hammerhead, hammerhead shark",
25
+ "5": "electric ray, crampfish, numbfish, torpedo",
26
+ "6": "stingray",
27
+ "7": "cock",
28
+ "8": "hen",
29
+ "9": "ostrich, Struthio camelus",
30
+ "10": "brambling, Fringilla montifringilla",
31
+ "11": "goldfinch, Carduelis carduelis",
32
+ "12": "house finch, linnet, Carpodacus mexicanus",
33
+ "13": "junco, snowbird",
34
+ "14": "indigo bunting, indigo finch, indigo bird, Passerina cyanea",
35
+ "15": "robin, American robin, Turdus migratorius",
36
+ "16": "bulbul",
37
+ "17": "jay",
38
+ "18": "magpie",
39
+ "19": "chickadee",
40
+ "20": "water ouzel, dipper",
41
+ "21": "kite",
42
+ "22": "bald eagle, American eagle, Haliaeetus leucocephalus",
43
+ "23": "vulture",
44
+ "24": "great grey owl, great gray owl, Strix nebulosa",
45
+ "25": "European fire salamander, Salamandra salamandra",
46
+ "26": "common newt, Triturus vulgaris",
47
+ "27": "eft",
48
+ "28": "spotted salamander, Ambystoma maculatum",
49
+ "29": "axolotl, mud puppy, Ambystoma mexicanum",
50
+ "30": "bullfrog, Rana catesbeiana",
51
+ "31": "tree frog, tree-frog",
52
+ "32": "tailed frog, bell toad, ribbed toad, tailed toad, Ascaphus trui",
53
+ "33": "loggerhead, loggerhead turtle, Caretta caretta",
54
+ "34": "leatherback turtle, leatherback, leathery turtle, Dermochelys coriacea",
55
+ "35": "mud turtle",
56
+ "36": "terrapin",
57
+ "37": "box turtle, box tortoise",
58
+ "38": "banded gecko",
59
+ "39": "common iguana, iguana, Iguana iguana",
60
+ "40": "American chameleon, anole, Anolis carolinensis",
61
+ "41": "whiptail, whiptail lizard",
62
+ "42": "agama",
63
+ "43": "frilled lizard, Chlamydosaurus kingi",
64
+ "44": "alligator lizard",
65
+ "45": "Gila monster, Heloderma suspectum",
66
+ "46": "green lizard, Lacerta viridis",
67
+ "47": "African chameleon, Chamaeleo chamaeleon",
68
+ "48": "Komodo dragon, Komodo lizard, dragon lizard, giant lizard, Varanus komodoensis",
69
+ "49": "African crocodile, Nile crocodile, Crocodylus niloticus",
70
+ "50": "American alligator, Alligator mississipiensis",
71
+ "51": "triceratops",
72
+ "52": "thunder snake, worm snake, Carphophis amoenus",
73
+ "53": "ringneck snake, ring-necked snake, ring snake",
74
+ "54": "hognose snake, puff adder, sand viper",
75
+ "55": "green snake, grass snake",
76
+ "56": "king snake, kingsnake",
77
+ "57": "garter snake, grass snake",
78
+ "58": "water snake",
79
+ "59": "vine snake",
80
+ "60": "night snake, Hypsiglena torquata",
81
+ "61": "boa constrictor, Constrictor constrictor",
82
+ "62": "rock python, rock snake, Python sebae",
83
+ "63": "Indian cobra, Naja naja",
84
+ "64": "green mamba",
85
+ "65": "sea snake",
86
+ "66": "horned viper, cerastes, sand viper, horned asp, Cerastes cornutus",
87
+ "67": "diamondback, diamondback rattlesnake, Crotalus adamanteus",
88
+ "68": "sidewinder, horned rattlesnake, Crotalus cerastes",
89
+ "69": "trilobite",
90
+ "70": "harvestman, daddy longlegs, Phalangium opilio",
91
+ "71": "scorpion",
92
+ "72": "black and gold garden spider, Argiope aurantia",
93
+ "73": "barn spider, Araneus cavaticus",
94
+ "74": "garden spider, Aranea diademata",
95
+ "75": "black widow, Latrodectus mactans",
96
+ "76": "tarantula",
97
+ "77": "wolf spider, hunting spider",
98
+ "78": "tick",
99
+ "79": "centipede",
100
+ "80": "black grouse",
101
+ "81": "ptarmigan",
102
+ "82": "ruffed grouse, partridge, Bonasa umbellus",
103
+ "83": "prairie chicken, prairie grouse, prairie fowl",
104
+ "84": "peacock",
105
+ "85": "quail",
106
+ "86": "partridge",
107
+ "87": "African grey, African gray, Psittacus erithacus",
108
+ "88": "macaw",
109
+ "89": "sulphur-crested cockatoo, Kakatoe galerita, Cacatua galerita",
110
+ "90": "lorikeet",
111
+ "91": "coucal",
112
+ "92": "bee eater",
113
+ "93": "hornbill",
114
+ "94": "hummingbird",
115
+ "95": "jacamar",
116
+ "96": "toucan",
117
+ "97": "drake",
118
+ "98": "red-breasted merganser, Mergus serrator",
119
+ "99": "goose",
120
+ "100": "black swan, Cygnus atratus",
121
+ "101": "tusker",
122
+ "102": "echidna, spiny anteater, anteater",
123
+ "103": "platypus, duckbill, duckbilled platypus, duck-billed platypus, Ornithorhynchus anatinus",
124
+ "104": "wallaby, brush kangaroo",
125
+ "105": "koala, koala bear, kangaroo bear, native bear, Phascolarctos cinereus",
126
+ "106": "wombat",
127
+ "107": "jellyfish",
128
+ "108": "sea anemone, anemone",
129
+ "109": "brain coral",
130
+ "110": "flatworm, platyhelminth",
131
+ "111": "nematode, nematode worm, roundworm",
132
+ "112": "conch",
133
+ "113": "snail",
134
+ "114": "slug",
135
+ "115": "sea slug, nudibranch",
136
+ "116": "chiton, coat-of-mail shell, sea cradle, polyplacophore",
137
+ "117": "chambered nautilus, pearly nautilus, nautilus",
138
+ "118": "Dungeness crab, Cancer magister",
139
+ "119": "rock crab, Cancer irroratus",
140
+ "120": "fiddler crab",
141
+ "121": "king crab, Alaska crab, Alaskan king crab, Alaska king crab, Paralithodes camtschatica",
142
+ "122": "American lobster, Northern lobster, Maine lobster, Homarus americanus",
143
+ "123": "spiny lobster, langouste, rock lobster, crawfish, crayfish, sea crawfish",
144
+ "124": "crayfish, crawfish, crawdad, crawdaddy",
145
+ "125": "hermit crab",
146
+ "126": "isopod",
147
+ "127": "white stork, Ciconia ciconia",
148
+ "128": "black stork, Ciconia nigra",
149
+ "129": "spoonbill",
150
+ "130": "flamingo",
151
+ "131": "little blue heron, Egretta caerulea",
152
+ "132": "American egret, great white heron, Egretta albus",
153
+ "133": "bittern",
154
+ "134": "crane",
155
+ "135": "limpkin, Aramus pictus",
156
+ "136": "European gallinule, Porphyrio porphyrio",
157
+ "137": "American coot, marsh hen, mud hen, water hen, Fulica americana",
158
+ "138": "bustard",
159
+ "139": "ruddy turnstone, Arenaria interpres",
160
+ "140": "red-backed sandpiper, dunlin, Erolia alpina",
161
+ "141": "redshank, Tringa totanus",
162
+ "142": "dowitcher",
163
+ "143": "oystercatcher, oyster catcher",
164
+ "144": "pelican",
165
+ "145": "king penguin, Aptenodytes patagonica",
166
+ "146": "albatross, mollymawk",
167
+ "147": "grey whale, gray whale, devilfish, Eschrichtius gibbosus, Eschrichtius robustus",
168
+ "148": "killer whale, killer, orca, grampus, sea wolf, Orcinus orca",
169
+ "149": "dugong, Dugong dugon",
170
+ "150": "sea lion",
171
+ "151": "Chihuahua",
172
+ "152": "Japanese spaniel",
173
+ "153": "Maltese dog, Maltese terrier, Maltese",
174
+ "154": "Pekinese, Pekingese, Peke",
175
+ "155": "Shih-Tzu",
176
+ "156": "Blenheim spaniel",
177
+ "157": "papillon",
178
+ "158": "toy terrier",
179
+ "159": "Rhodesian ridgeback",
180
+ "160": "Afghan hound, Afghan",
181
+ "161": "basset, basset hound",
182
+ "162": "beagle",
183
+ "163": "bloodhound, sleuthhound",
184
+ "164": "bluetick",
185
+ "165": "black-and-tan coonhound",
186
+ "166": "Walker hound, Walker foxhound",
187
+ "167": "English foxhound",
188
+ "168": "redbone",
189
+ "169": "borzoi, Russian wolfhound",
190
+ "170": "Irish wolfhound",
191
+ "171": "Italian greyhound",
192
+ "172": "whippet",
193
+ "173": "Ibizan hound, Ibizan Podenco",
194
+ "174": "Norwegian elkhound, elkhound",
195
+ "175": "otterhound, otter hound",
196
+ "176": "Saluki, gazelle hound",
197
+ "177": "Scottish deerhound, deerhound",
198
+ "178": "Weimaraner",
199
+ "179": "Staffordshire bullterrier, Staffordshire bull terrier",
200
+ "180": "American Staffordshire terrier, Staffordshire terrier, American pit bull terrier, pit bull terrier",
201
+ "181": "Bedlington terrier",
202
+ "182": "Border terrier",
203
+ "183": "Kerry blue terrier",
204
+ "184": "Irish terrier",
205
+ "185": "Norfolk terrier",
206
+ "186": "Norwich terrier",
207
+ "187": "Yorkshire terrier",
208
+ "188": "wire-haired fox terrier",
209
+ "189": "Lakeland terrier",
210
+ "190": "Sealyham terrier, Sealyham",
211
+ "191": "Airedale, Airedale terrier",
212
+ "192": "cairn, cairn terrier",
213
+ "193": "Australian terrier",
214
+ "194": "Dandie Dinmont, Dandie Dinmont terrier",
215
+ "195": "Boston bull, Boston terrier",
216
+ "196": "miniature schnauzer",
217
+ "197": "giant schnauzer",
218
+ "198": "standard schnauzer",
219
+ "199": "Scotch terrier, Scottish terrier, Scottie",
220
+ "200": "Tibetan terrier, chrysanthemum dog",
221
+ "201": "silky terrier, Sydney silky",
222
+ "202": "soft-coated wheaten terrier",
223
+ "203": "West Highland white terrier",
224
+ "204": "Lhasa, Lhasa apso",
225
+ "205": "flat-coated retriever",
226
+ "206": "curly-coated retriever",
227
+ "207": "golden retriever",
228
+ "208": "Labrador retriever",
229
+ "209": "Chesapeake Bay retriever",
230
+ "210": "German short-haired pointer",
231
+ "211": "vizsla, Hungarian pointer",
232
+ "212": "English setter",
233
+ "213": "Irish setter, red setter",
234
+ "214": "Gordon setter",
235
+ "215": "Brittany spaniel",
236
+ "216": "clumber, clumber spaniel",
237
+ "217": "English springer, English springer spaniel",
238
+ "218": "Welsh springer spaniel",
239
+ "219": "cocker spaniel, English cocker spaniel, cocker",
240
+ "220": "Sussex spaniel",
241
+ "221": "Irish water spaniel",
242
+ "222": "kuvasz",
243
+ "223": "schipperke",
244
+ "224": "groenendael",
245
+ "225": "malinois",
246
+ "226": "briard",
247
+ "227": "kelpie",
248
+ "228": "komondor",
249
+ "229": "Old English sheepdog, bobtail",
250
+ "230": "Shetland sheepdog, Shetland sheep dog, Shetland",
251
+ "231": "collie",
252
+ "232": "Border collie",
253
+ "233": "Bouvier des Flandres, Bouviers des Flandres",
254
+ "234": "Rottweiler",
255
+ "235": "German shepherd, German shepherd dog, German police dog, alsatian",
256
+ "236": "Doberman, Doberman pinscher",
257
+ "237": "miniature pinscher",
258
+ "238": "Greater Swiss Mountain dog",
259
+ "239": "Bernese mountain dog",
260
+ "240": "Appenzeller",
261
+ "241": "EntleBucher",
262
+ "242": "boxer",
263
+ "243": "bull mastiff",
264
+ "244": "Tibetan mastiff",
265
+ "245": "French bulldog",
266
+ "246": "Great Dane",
267
+ "247": "Saint Bernard, St Bernard",
268
+ "248": "Eskimo dog, husky",
269
+ "249": "malamute, malemute, Alaskan malamute",
270
+ "250": "Siberian husky",
271
+ "251": "dalmatian, coach dog, carriage dog",
272
+ "252": "affenpinscher, monkey pinscher, monkey dog",
273
+ "253": "basenji",
274
+ "254": "pug, pug-dog",
275
+ "255": "Leonberg",
276
+ "256": "Newfoundland, Newfoundland dog",
277
+ "257": "Great Pyrenees",
278
+ "258": "Samoyed, Samoyede",
279
+ "259": "Pomeranian",
280
+ "260": "chow, chow chow",
281
+ "261": "keeshond",
282
+ "262": "Brabancon griffon",
283
+ "263": "Pembroke, Pembroke Welsh corgi",
284
+ "264": "Cardigan, Cardigan Welsh corgi",
285
+ "265": "toy poodle",
286
+ "266": "miniature poodle",
287
+ "267": "standard poodle",
288
+ "268": "Mexican hairless",
289
+ "269": "timber wolf, grey wolf, gray wolf, Canis lupus",
290
+ "270": "white wolf, Arctic wolf, Canis lupus tundrarum",
291
+ "271": "red wolf, maned wolf, Canis rufus, Canis niger",
292
+ "272": "coyote, prairie wolf, brush wolf, Canis latrans",
293
+ "273": "dingo, warrigal, warragal, Canis dingo",
294
+ "274": "dhole, Cuon alpinus",
295
+ "275": "African hunting dog, hyena dog, Cape hunting dog, Lycaon pictus",
296
+ "276": "hyena, hyaena",
297
+ "277": "red fox, Vulpes vulpes",
298
+ "278": "kit fox, Vulpes macrotis",
299
+ "279": "Arctic fox, white fox, Alopex lagopus",
300
+ "280": "grey fox, gray fox, Urocyon cinereoargenteus",
301
+ "281": "tabby, tabby cat",
302
+ "282": "tiger cat",
303
+ "283": "Persian cat",
304
+ "284": "Siamese cat, Siamese",
305
+ "285": "Egyptian cat",
306
+ "286": "cougar, puma, catamount, mountain lion, painter, panther, Felis concolor",
307
+ "287": "lynx, catamount",
308
+ "288": "leopard, Panthera pardus",
309
+ "289": "snow leopard, ounce, Panthera uncia",
310
+ "290": "jaguar, panther, Panthera onca, Felis onca",
311
+ "291": "lion, king of beasts, Panthera leo",
312
+ "292": "tiger, Panthera tigris",
313
+ "293": "cheetah, chetah, Acinonyx jubatus",
314
+ "294": "brown bear, bruin, Ursus arctos",
315
+ "295": "American black bear, black bear, Ursus americanus, Euarctos americanus",
316
+ "296": "ice bear, polar bear, Ursus Maritimus, Thalarctos maritimus",
317
+ "297": "sloth bear, Melursus ursinus, Ursus ursinus",
318
+ "298": "mongoose",
319
+ "299": "meerkat, mierkat",
320
+ "300": "tiger beetle",
321
+ "301": "ladybug, ladybeetle, lady beetle, ladybird, ladybird beetle",
322
+ "302": "ground beetle, carabid beetle",
323
+ "303": "long-horned beetle, longicorn, longicorn beetle",
324
+ "304": "leaf beetle, chrysomelid",
325
+ "305": "dung beetle",
326
+ "306": "rhinoceros beetle",
327
+ "307": "weevil",
328
+ "308": "fly",
329
+ "309": "bee",
330
+ "310": "ant, emmet, pismire",
331
+ "311": "grasshopper, hopper",
332
+ "312": "cricket",
333
+ "313": "walking stick, walkingstick, stick insect",
334
+ "314": "cockroach, roach",
335
+ "315": "mantis, mantid",
336
+ "316": "cicada, cicala",
337
+ "317": "leafhopper",
338
+ "318": "lacewing, lacewing fly",
339
+ "319": "dragonfly, darning needle, devils darning needle, sewing needle, snake feeder, snake doctor, mosquito hawk, skeeter hawk",
340
+ "320": "damselfly",
341
+ "321": "admiral",
342
+ "322": "ringlet, ringlet butterfly",
343
+ "323": "monarch, monarch butterfly, milkweed butterfly, Danaus plexippus",
344
+ "324": "cabbage butterfly",
345
+ "325": "sulphur butterfly, sulfur butterfly",
346
+ "326": "lycaenid, lycaenid butterfly",
347
+ "327": "starfish, sea star",
348
+ "328": "sea urchin",
349
+ "329": "sea cucumber, holothurian",
350
+ "330": "wood rabbit, cottontail, cottontail rabbit",
351
+ "331": "hare",
352
+ "332": "Angora, Angora rabbit",
353
+ "333": "hamster",
354
+ "334": "porcupine, hedgehog",
355
+ "335": "fox squirrel, eastern fox squirrel, Sciurus niger",
356
+ "336": "marmot",
357
+ "337": "beaver",
358
+ "338": "guinea pig, Cavia cobaya",
359
+ "339": "sorrel",
360
+ "340": "zebra",
361
+ "341": "hog, pig, grunter, squealer, Sus scrofa",
362
+ "342": "wild boar, boar, Sus scrofa",
363
+ "343": "warthog",
364
+ "344": "hippopotamus, hippo, river horse, Hippopotamus amphibius",
365
+ "345": "ox",
366
+ "346": "water buffalo, water ox, Asiatic buffalo, Bubalus bubalis",
367
+ "347": "bison",
368
+ "348": "ram, tup",
369
+ "349": "bighorn, bighorn sheep, cimarron, Rocky Mountain bighorn, Rocky Mountain sheep, Ovis canadensis",
370
+ "350": "ibex, Capra ibex",
371
+ "351": "hartebeest",
372
+ "352": "impala, Aepyceros melampus",
373
+ "353": "gazelle",
374
+ "354": "Arabian camel, dromedary, Camelus dromedarius",
375
+ "355": "llama",
376
+ "356": "weasel",
377
+ "357": "mink",
378
+ "358": "polecat, fitch, foulmart, foumart, Mustela putorius",
379
+ "359": "black-footed ferret, ferret, Mustela nigripes",
380
+ "360": "otter",
381
+ "361": "skunk, polecat, wood pussy",
382
+ "362": "badger",
383
+ "363": "armadillo",
384
+ "364": "three-toed sloth, ai, Bradypus tridactylus",
385
+ "365": "orangutan, orang, orangutang, Pongo pygmaeus",
386
+ "366": "gorilla, Gorilla gorilla",
387
+ "367": "chimpanzee, chimp, Pan troglodytes",
388
+ "368": "gibbon, Hylobates lar",
389
+ "369": "siamang, Hylobates syndactylus, Symphalangus syndactylus",
390
+ "370": "guenon, guenon monkey",
391
+ "371": "patas, hussar monkey, Erythrocebus patas",
392
+ "372": "baboon",
393
+ "373": "macaque",
394
+ "374": "langur",
395
+ "375": "colobus, colobus monkey",
396
+ "376": "proboscis monkey, Nasalis larvatus",
397
+ "377": "marmoset",
398
+ "378": "capuchin, ringtail, Cebus capucinus",
399
+ "379": "howler monkey, howler",
400
+ "380": "titi, titi monkey",
401
+ "381": "spider monkey, Ateles geoffroyi",
402
+ "382": "squirrel monkey, Saimiri sciureus",
403
+ "383": "Madagascar cat, ring-tailed lemur, Lemur catta",
404
+ "384": "indri, indris, Indri indri, Indri brevicaudatus",
405
+ "385": "Indian elephant, Elephas maximus",
406
+ "386": "African elephant, Loxodonta africana",
407
+ "387": "lesser panda, red panda, panda, bear cat, cat bear, Ailurus fulgens",
408
+ "388": "giant panda, panda, panda bear, coon bear, Ailuropoda melanoleuca",
409
+ "389": "barracouta, snoek",
410
+ "390": "eel",
411
+ "391": "coho, cohoe, coho salmon, blue jack, silver salmon, Oncorhynchus kisutch",
412
+ "392": "rock beauty, Holocanthus tricolor",
413
+ "393": "anemone fish",
414
+ "394": "sturgeon",
415
+ "395": "gar, garfish, garpike, billfish, Lepisosteus osseus",
416
+ "396": "lionfish",
417
+ "397": "puffer, pufferfish, blowfish, globefish",
418
+ "398": "abacus",
419
+ "399": "abaya",
420
+ "400": "academic gown, academic robe, judge robe",
421
+ "401": "accordion, piano accordion, squeeze box",
422
+ "402": "acoustic guitar",
423
+ "403": "aircraft carrier, carrier, flattop, attack aircraft carrier",
424
+ "404": "airliner",
425
+ "405": "airship, dirigible",
426
+ "406": "altar",
427
+ "407": "ambulance",
428
+ "408": "amphibian, amphibious vehicle",
429
+ "409": "analog clock",
430
+ "410": "apiary, bee house",
431
+ "411": "apron",
432
+ "412": "ashcan, trash can, garbage can, wastebin, ash bin, ash-bin, ashbin, dustbin, trash barrel, trash bin",
433
+ "413": "assault rifle, assault gun",
434
+ "414": "backpack, back pack, knapsack, packsack, rucksack, haversack",
435
+ "415": "bakery, bakeshop, bakehouse",
436
+ "416": "balance beam, beam",
437
+ "417": "balloon",
438
+ "418": "ballpoint, ballpoint pen, ballpen, Biro",
439
+ "419": "Band Aid",
440
+ "420": "banjo",
441
+ "421": "bannister, banister, balustrade, balusters, handrail",
442
+ "422": "barbell",
443
+ "423": "barber chair",
444
+ "424": "barbershop",
445
+ "425": "barn",
446
+ "426": "barometer",
447
+ "427": "barrel, cask",
448
+ "428": "barrow, garden cart, lawn cart, wheelbarrow",
449
+ "429": "baseball",
450
+ "430": "basketball",
451
+ "431": "bassinet",
452
+ "432": "bassoon",
453
+ "433": "bathing cap, swimming cap",
454
+ "434": "bath towel",
455
+ "435": "bathtub, bathing tub, bath, tub",
456
+ "436": "beach wagon, station wagon, wagon, estate car, beach waggon, station waggon, waggon",
457
+ "437": "beacon, lighthouse, beacon light, pharos",
458
+ "438": "beaker",
459
+ "439": "bearskin, busby, shako",
460
+ "440": "beer bottle",
461
+ "441": "beer glass",
462
+ "442": "bell cote, bell cot",
463
+ "443": "bib",
464
+ "444": "bicycle-built-for-two, tandem bicycle, tandem",
465
+ "445": "bikini, two-piece",
466
+ "446": "binder, ring-binder",
467
+ "447": "binoculars, field glasses, opera glasses",
468
+ "448": "birdhouse",
469
+ "449": "boathouse",
470
+ "450": "bobsled, bobsleigh, bob",
471
+ "451": "bolo tie, bolo, bola tie, bola",
472
+ "452": "bonnet, poke bonnet",
473
+ "453": "bookcase",
474
+ "454": "bookshop, bookstore, bookstall",
475
+ "455": "bottlecap",
476
+ "456": "bow",
477
+ "457": "bow tie, bow-tie, bowtie",
478
+ "458": "brass, memorial tablet, plaque",
479
+ "459": "brassiere, bra, bandeau",
480
+ "460": "breakwater, groin, groyne, mole, bulwark, seawall, jetty",
481
+ "461": "breastplate, aegis, egis",
482
+ "462": "broom",
483
+ "463": "bucket, pail",
484
+ "464": "buckle",
485
+ "465": "bulletproof vest",
486
+ "466": "bullet train, bullet",
487
+ "467": "butcher shop, meat market",
488
+ "468": "cab, hack, taxi, taxicab",
489
+ "469": "caldron, cauldron",
490
+ "470": "candle, taper, wax light",
491
+ "471": "cannon",
492
+ "472": "canoe",
493
+ "473": "can opener, tin opener",
494
+ "474": "cardigan",
495
+ "475": "car mirror",
496
+ "476": "carousel, carrousel, merry-go-round, roundabout, whirligig",
497
+ "477": "carpenters kit, tool kit",
498
+ "478": "carton",
499
+ "479": "car wheel",
500
+ "480": "cash machine, cash dispenser, automated teller machine, automatic teller machine, automated teller, automatic teller, ATM",
501
+ "481": "cassette",
502
+ "482": "cassette player",
503
+ "483": "castle",
504
+ "484": "catamaran",
505
+ "485": "CD player",
506
+ "486": "cello, violoncello",
507
+ "487": "cellular telephone, cellular phone, cellphone, cell, mobile phone",
508
+ "488": "chain",
509
+ "489": "chainlink fence",
510
+ "490": "chain mail, ring mail, mail, chain armor, chain armour, ring armor, ring armour",
511
+ "491": "chain saw, chainsaw",
512
+ "492": "chest",
513
+ "493": "chiffonier, commode",
514
+ "494": "chime, bell, gong",
515
+ "495": "china cabinet, china closet",
516
+ "496": "Christmas stocking",
517
+ "497": "church, church building",
518
+ "498": "cinema, movie theater, movie theatre, movie house, picture palace",
519
+ "499": "cleaver, meat cleaver, chopper",
520
+ "500": "cliff dwelling",
521
+ "501": "cloak",
522
+ "502": "clog, geta, patten, sabot",
523
+ "503": "cocktail shaker",
524
+ "504": "coffee mug",
525
+ "505": "coffeepot",
526
+ "506": "coil, spiral, volute, whorl, helix",
527
+ "507": "combination lock",
528
+ "508": "computer keyboard, keypad",
529
+ "509": "confectionery, confectionary, candy store",
530
+ "510": "container ship, containership, container vessel",
531
+ "511": "convertible",
532
+ "512": "corkscrew, bottle screw",
533
+ "513": "cornet, horn, trumpet, trump",
534
+ "514": "cowboy boot",
535
+ "515": "cowboy hat, ten-gallon hat",
536
+ "516": "cradle",
537
+ "517": "crane",
538
+ "518": "crash helmet",
539
+ "519": "crate",
540
+ "520": "crib, cot",
541
+ "521": "Crock Pot",
542
+ "522": "croquet ball",
543
+ "523": "crutch",
544
+ "524": "cuirass",
545
+ "525": "dam, dike, dyke",
546
+ "526": "desk",
547
+ "527": "desktop computer",
548
+ "528": "dial telephone, dial phone",
549
+ "529": "diaper, nappy, napkin",
550
+ "530": "digital clock",
551
+ "531": "digital watch",
552
+ "532": "dining table, board",
553
+ "533": "dishrag, dishcloth",
554
+ "534": "dishwasher, dish washer, dishwashing machine",
555
+ "535": "disk brake, disc brake",
556
+ "536": "dock, dockage, docking facility",
557
+ "537": "dogsled, dog sled, dog sleigh",
558
+ "538": "dome",
559
+ "539": "doormat, welcome mat",
560
+ "540": "drilling platform, offshore rig",
561
+ "541": "drum, membranophone, tympan",
562
+ "542": "drumstick",
563
+ "543": "dumbbell",
564
+ "544": "Dutch oven",
565
+ "545": "electric fan, blower",
566
+ "546": "electric guitar",
567
+ "547": "electric locomotive",
568
+ "548": "entertainment center",
569
+ "549": "envelope",
570
+ "550": "espresso maker",
571
+ "551": "face powder",
572
+ "552": "feather boa, boa",
573
+ "553": "file, file cabinet, filing cabinet",
574
+ "554": "fireboat",
575
+ "555": "fire engine, fire truck",
576
+ "556": "fire screen, fireguard",
577
+ "557": "flagpole, flagstaff",
578
+ "558": "flute, transverse flute",
579
+ "559": "folding chair",
580
+ "560": "football helmet",
581
+ "561": "forklift",
582
+ "562": "fountain",
583
+ "563": "fountain pen",
584
+ "564": "four-poster",
585
+ "565": "freight car",
586
+ "566": "French horn, horn",
587
+ "567": "frying pan, frypan, skillet",
588
+ "568": "fur coat",
589
+ "569": "garbage truck, dustcart",
590
+ "570": "gasmask, respirator, gas helmet",
591
+ "571": "gas pump, gasoline pump, petrol pump, island dispenser",
592
+ "572": "goblet",
593
+ "573": "go-kart",
594
+ "574": "golf ball",
595
+ "575": "golfcart, golf cart",
596
+ "576": "gondola",
597
+ "577": "gong, tam-tam",
598
+ "578": "gown",
599
+ "579": "grand piano, grand",
600
+ "580": "greenhouse, nursery, glasshouse",
601
+ "581": "grille, radiator grille",
602
+ "582": "grocery store, grocery, food market, market",
603
+ "583": "guillotine",
604
+ "584": "hair slide",
605
+ "585": "hair spray",
606
+ "586": "half track",
607
+ "587": "hammer",
608
+ "588": "hamper",
609
+ "589": "hand blower, blow dryer, blow drier, hair dryer, hair drier",
610
+ "590": "hand-held computer, hand-held microcomputer",
611
+ "591": "handkerchief, hankie, hanky, hankey",
612
+ "592": "hard disc, hard disk, fixed disk",
613
+ "593": "harmonica, mouth organ, harp, mouth harp",
614
+ "594": "harp",
615
+ "595": "harvester, reaper",
616
+ "596": "hatchet",
617
+ "597": "holster",
618
+ "598": "home theater, home theatre",
619
+ "599": "honeycomb",
620
+ "600": "hook, claw",
621
+ "601": "hoopskirt, crinoline",
622
+ "602": "horizontal bar, high bar",
623
+ "603": "horse cart, horse-cart",
624
+ "604": "hourglass",
625
+ "605": "iPod",
626
+ "606": "iron, smoothing iron",
627
+ "607": "jack-o-lantern",
628
+ "608": "jean, blue jean, denim",
629
+ "609": "jeep, landrover",
630
+ "610": "jersey, T-shirt, tee shirt",
631
+ "611": "jigsaw puzzle",
632
+ "612": "jinrikisha, ricksha, rickshaw",
633
+ "613": "joystick",
634
+ "614": "kimono",
635
+ "615": "knee pad",
636
+ "616": "knot",
637
+ "617": "lab coat, laboratory coat",
638
+ "618": "ladle",
639
+ "619": "lampshade, lamp shade",
640
+ "620": "laptop, laptop computer",
641
+ "621": "lawn mower, mower",
642
+ "622": "lens cap, lens cover",
643
+ "623": "letter opener, paper knife, paperknife",
644
+ "624": "library",
645
+ "625": "lifeboat",
646
+ "626": "lighter, light, igniter, ignitor",
647
+ "627": "limousine, limo",
648
+ "628": "liner, ocean liner",
649
+ "629": "lipstick, lip rouge",
650
+ "630": "Loafer",
651
+ "631": "lotion",
652
+ "632": "loudspeaker, speaker, speaker unit, loudspeaker system, speaker system",
653
+ "633": "loupe, jewelers loupe",
654
+ "634": "lumbermill, sawmill",
655
+ "635": "magnetic compass",
656
+ "636": "mailbag, postbag",
657
+ "637": "mailbox, letter box",
658
+ "638": "maillot",
659
+ "639": "maillot, tank suit",
660
+ "640": "manhole cover",
661
+ "641": "maraca",
662
+ "642": "marimba, xylophone",
663
+ "643": "mask",
664
+ "644": "matchstick",
665
+ "645": "maypole",
666
+ "646": "maze, labyrinth",
667
+ "647": "measuring cup",
668
+ "648": "medicine chest, medicine cabinet",
669
+ "649": "megalith, megalithic structure",
670
+ "650": "microphone, mike",
671
+ "651": "microwave, microwave oven",
672
+ "652": "military uniform",
673
+ "653": "milk can",
674
+ "654": "minibus",
675
+ "655": "miniskirt, mini",
676
+ "656": "minivan",
677
+ "657": "missile",
678
+ "658": "mitten",
679
+ "659": "mixing bowl",
680
+ "660": "mobile home, manufactured home",
681
+ "661": "Model T",
682
+ "662": "modem",
683
+ "663": "monastery",
684
+ "664": "monitor",
685
+ "665": "moped",
686
+ "666": "mortar",
687
+ "667": "mortarboard",
688
+ "668": "mosque",
689
+ "669": "mosquito net",
690
+ "670": "motor scooter, scooter",
691
+ "671": "mountain bike, all-terrain bike, off-roader",
692
+ "672": "mountain tent",
693
+ "673": "mouse, computer mouse",
694
+ "674": "mousetrap",
695
+ "675": "moving van",
696
+ "676": "muzzle",
697
+ "677": "nail",
698
+ "678": "neck brace",
699
+ "679": "necklace",
700
+ "680": "nipple",
701
+ "681": "notebook, notebook computer",
702
+ "682": "obelisk",
703
+ "683": "oboe, hautboy, hautbois",
704
+ "684": "ocarina, sweet potato",
705
+ "685": "odometer, hodometer, mileometer, milometer",
706
+ "686": "oil filter",
707
+ "687": "organ, pipe organ",
708
+ "688": "oscilloscope, scope, cathode-ray oscilloscope, CRO",
709
+ "689": "overskirt",
710
+ "690": "oxcart",
711
+ "691": "oxygen mask",
712
+ "692": "packet",
713
+ "693": "paddle, boat paddle",
714
+ "694": "paddlewheel, paddle wheel",
715
+ "695": "padlock",
716
+ "696": "paintbrush",
717
+ "697": "pajama, pyjama, pjs, jammies",
718
+ "698": "palace",
719
+ "699": "panpipe, pandean pipe, syrinx",
720
+ "700": "paper towel",
721
+ "701": "parachute, chute",
722
+ "702": "parallel bars, bars",
723
+ "703": "park bench",
724
+ "704": "parking meter",
725
+ "705": "passenger car, coach, carriage",
726
+ "706": "patio, terrace",
727
+ "707": "pay-phone, pay-station",
728
+ "708": "pedestal, plinth, footstall",
729
+ "709": "pencil box, pencil case",
730
+ "710": "pencil sharpener",
731
+ "711": "perfume, essence",
732
+ "712": "Petri dish",
733
+ "713": "photocopier",
734
+ "714": "pick, plectrum, plectron",
735
+ "715": "pickelhaube",
736
+ "716": "picket fence, paling",
737
+ "717": "pickup, pickup truck",
738
+ "718": "pier",
739
+ "719": "piggy bank, penny bank",
740
+ "720": "pill bottle",
741
+ "721": "pillow",
742
+ "722": "ping-pong ball",
743
+ "723": "pinwheel",
744
+ "724": "pirate, pirate ship",
745
+ "725": "pitcher, ewer",
746
+ "726": "plane, carpenters plane, woodworking plane",
747
+ "727": "planetarium",
748
+ "728": "plastic bag",
749
+ "729": "plate rack",
750
+ "730": "plow, plough",
751
+ "731": "plunger, plumbers helper",
752
+ "732": "Polaroid camera, Polaroid Land camera",
753
+ "733": "pole",
754
+ "734": "police van, police wagon, paddy wagon, patrol wagon, wagon, black Maria",
755
+ "735": "poncho",
756
+ "736": "pool table, billiard table, snooker table",
757
+ "737": "pop bottle, soda bottle",
758
+ "738": "pot, flowerpot",
759
+ "739": "potters wheel",
760
+ "740": "power drill",
761
+ "741": "prayer rug, prayer mat",
762
+ "742": "printer",
763
+ "743": "prison, prison house",
764
+ "744": "projectile, missile",
765
+ "745": "projector",
766
+ "746": "puck, hockey puck",
767
+ "747": "punching bag, punch bag, punching ball, punchball",
768
+ "748": "purse",
769
+ "749": "quill, quill pen",
770
+ "750": "quilt, comforter, comfort, puff",
771
+ "751": "racer, race car, racing car",
772
+ "752": "racket, racquet",
773
+ "753": "radiator",
774
+ "754": "radio, wireless",
775
+ "755": "radio telescope, radio reflector",
776
+ "756": "rain barrel",
777
+ "757": "recreational vehicle, RV, R.V.",
778
+ "758": "reel",
779
+ "759": "reflex camera",
780
+ "760": "refrigerator, icebox",
781
+ "761": "remote control, remote",
782
+ "762": "restaurant, eating house, eating place, eatery",
783
+ "763": "revolver, six-gun, six-shooter",
784
+ "764": "rifle",
785
+ "765": "rocking chair, rocker",
786
+ "766": "rotisserie",
787
+ "767": "rubber eraser, rubber, pencil eraser",
788
+ "768": "rugby ball",
789
+ "769": "rule, ruler",
790
+ "770": "running shoe",
791
+ "771": "safe",
792
+ "772": "safety pin",
793
+ "773": "saltshaker, salt shaker",
794
+ "774": "sandal",
795
+ "775": "sarong",
796
+ "776": "sax, saxophone",
797
+ "777": "scabbard",
798
+ "778": "scale, weighing machine",
799
+ "779": "school bus",
800
+ "780": "schooner",
801
+ "781": "scoreboard",
802
+ "782": "screen, CRT screen",
803
+ "783": "screw",
804
+ "784": "screwdriver",
805
+ "785": "seat belt, seatbelt",
806
+ "786": "sewing machine",
807
+ "787": "shield, buckler",
808
+ "788": "shoe shop, shoe-shop, shoe store",
809
+ "789": "shoji",
810
+ "790": "shopping basket",
811
+ "791": "shopping cart",
812
+ "792": "shovel",
813
+ "793": "shower cap",
814
+ "794": "shower curtain",
815
+ "795": "ski",
816
+ "796": "ski mask",
817
+ "797": "sleeping bag",
818
+ "798": "slide rule, slipstick",
819
+ "799": "sliding door",
820
+ "800": "slot, one-armed bandit",
821
+ "801": "snorkel",
822
+ "802": "snowmobile",
823
+ "803": "snowplow, snowplough",
824
+ "804": "soap dispenser",
825
+ "805": "soccer ball",
826
+ "806": "sock",
827
+ "807": "solar dish, solar collector, solar furnace",
828
+ "808": "sombrero",
829
+ "809": "soup bowl",
830
+ "810": "space bar",
831
+ "811": "space heater",
832
+ "812": "space shuttle",
833
+ "813": "spatula",
834
+ "814": "speedboat",
835
+ "815": "spider web, spiders web",
836
+ "816": "spindle",
837
+ "817": "sports car, sport car",
838
+ "818": "spotlight, spot",
839
+ "819": "stage",
840
+ "820": "steam locomotive",
841
+ "821": "steel arch bridge",
842
+ "822": "steel drum",
843
+ "823": "stethoscope",
844
+ "824": "stole",
845
+ "825": "stone wall",
846
+ "826": "stopwatch, stop watch",
847
+ "827": "stove",
848
+ "828": "strainer",
849
+ "829": "streetcar, tram, tramcar, trolley, trolley car",
850
+ "830": "stretcher",
851
+ "831": "studio couch, day bed",
852
+ "832": "stupa, tope",
853
+ "833": "submarine, pigboat, sub, U-boat",
854
+ "834": "suit, suit of clothes",
855
+ "835": "sundial",
856
+ "836": "sunglass",
857
+ "837": "sunglasses, dark glasses, shades",
858
+ "838": "sunscreen, sunblock, sun blocker",
859
+ "839": "suspension bridge",
860
+ "840": "swab, swob, mop",
861
+ "841": "sweatshirt",
862
+ "842": "swimming trunks, bathing trunks",
863
+ "843": "swing",
864
+ "844": "switch, electric switch, electrical switch",
865
+ "845": "syringe",
866
+ "846": "table lamp",
867
+ "847": "tank, army tank, armored combat vehicle, armoured combat vehicle",
868
+ "848": "tape player",
869
+ "849": "teapot",
870
+ "850": "teddy, teddy bear",
871
+ "851": "television, television system",
872
+ "852": "tennis ball",
873
+ "853": "thatch, thatched roof",
874
+ "854": "theater curtain, theatre curtain",
875
+ "855": "thimble",
876
+ "856": "thresher, thrasher, threshing machine",
877
+ "857": "throne",
878
+ "858": "tile roof",
879
+ "859": "toaster",
880
+ "860": "tobacco shop, tobacconist shop, tobacconist",
881
+ "861": "toilet seat",
882
+ "862": "torch",
883
+ "863": "totem pole",
884
+ "864": "tow truck, tow car, wrecker",
885
+ "865": "toyshop",
886
+ "866": "tractor",
887
+ "867": "trailer truck, tractor trailer, trucking rig, rig, articulated lorry, semi",
888
+ "868": "tray",
889
+ "869": "trench coat",
890
+ "870": "tricycle, trike, velocipede",
891
+ "871": "trimaran",
892
+ "872": "tripod",
893
+ "873": "triumphal arch",
894
+ "874": "trolleybus, trolley coach, trackless trolley",
895
+ "875": "trombone",
896
+ "876": "tub, vat",
897
+ "877": "turnstile",
898
+ "878": "typewriter keyboard",
899
+ "879": "umbrella",
900
+ "880": "unicycle, monocycle",
901
+ "881": "upright, upright piano",
902
+ "882": "vacuum, vacuum cleaner",
903
+ "883": "vase",
904
+ "884": "vault",
905
+ "885": "velvet",
906
+ "886": "vending machine",
907
+ "887": "vestment",
908
+ "888": "viaduct",
909
+ "889": "violin, fiddle",
910
+ "890": "volleyball",
911
+ "891": "waffle iron",
912
+ "892": "wall clock",
913
+ "893": "wallet, billfold, notecase, pocketbook",
914
+ "894": "wardrobe, closet, press",
915
+ "895": "warplane, military plane",
916
+ "896": "washbasin, handbasin, washbowl, lavabo, wash-hand basin",
917
+ "897": "washer, automatic washer, washing machine",
918
+ "898": "water bottle",
919
+ "899": "water jug",
920
+ "900": "water tower",
921
+ "901": "whiskey jug",
922
+ "902": "whistle",
923
+ "903": "wig",
924
+ "904": "window screen",
925
+ "905": "window shade",
926
+ "906": "Windsor tie",
927
+ "907": "wine bottle",
928
+ "908": "wing",
929
+ "909": "wok",
930
+ "910": "wooden spoon",
931
+ "911": "wool, woolen, woollen",
932
+ "912": "worm fence, snake fence, snake-rail fence, Virginia fence",
933
+ "913": "wreck",
934
+ "914": "yawl",
935
+ "915": "yurt",
936
+ "916": "web site, website, internet site, site",
937
+ "917": "comic book",
938
+ "918": "crossword puzzle, crossword",
939
+ "919": "street sign",
940
+ "920": "traffic light, traffic signal, stoplight",
941
+ "921": "book jacket, dust cover, dust jacket, dust wrapper",
942
+ "922": "menu",
943
+ "923": "plate",
944
+ "924": "guacamole",
945
+ "925": "consomme",
946
+ "926": "hot pot, hotpot",
947
+ "927": "trifle",
948
+ "928": "ice cream, icecream",
949
+ "929": "ice lolly, lolly, lollipop, popsicle",
950
+ "930": "French loaf",
951
+ "931": "bagel, beigel",
952
+ "932": "pretzel",
953
+ "933": "cheeseburger",
954
+ "934": "hotdog, hot dog, red hot",
955
+ "935": "mashed potato",
956
+ "936": "head cabbage",
957
+ "937": "broccoli",
958
+ "938": "cauliflower",
959
+ "939": "zucchini, courgette",
960
+ "940": "spaghetti squash",
961
+ "941": "acorn squash",
962
+ "942": "butternut squash",
963
+ "943": "cucumber, cuke",
964
+ "944": "artichoke, globe artichoke",
965
+ "945": "bell pepper",
966
+ "946": "cardoon",
967
+ "947": "mushroom",
968
+ "948": "Granny Smith",
969
+ "949": "strawberry",
970
+ "950": "orange",
971
+ "951": "lemon",
972
+ "952": "fig",
973
+ "953": "pineapple, ananas",
974
+ "954": "banana",
975
+ "955": "jackfruit, jak, jack",
976
+ "956": "custard apple",
977
+ "957": "pomegranate",
978
+ "958": "hay",
979
+ "959": "carbonara",
980
+ "960": "chocolate sauce, chocolate syrup",
981
+ "961": "dough",
982
+ "962": "meat loaf, meatloaf",
983
+ "963": "pizza, pizza pie",
984
+ "964": "potpie",
985
+ "965": "burrito",
986
+ "966": "red wine",
987
+ "967": "espresso",
988
+ "968": "cup",
989
+ "969": "eggnog",
990
+ "970": "alp",
991
+ "971": "bubble",
992
+ "972": "cliff, drop, drop-off",
993
+ "973": "coral reef",
994
+ "974": "geyser",
995
+ "975": "lakeside, lakeshore",
996
+ "976": "promontory, headland, head, foreland",
997
+ "977": "sandbar, sand bar",
998
+ "978": "seashore, coast, seacoast, sea-coast",
999
+ "979": "valley, vale",
1000
+ "980": "volcano",
1001
+ "981": "ballplayer, baseball player",
1002
+ "982": "groom, bridegroom",
1003
+ "983": "scuba diver",
1004
+ "984": "rapeseed",
1005
+ "985": "daisy",
1006
+ "986": "yellow ladys slipper, yellow lady-slipper, Cypripedium calceolus, Cypripedium parviflorum",
1007
+ "987": "corn",
1008
+ "988": "acorn",
1009
+ "989": "hip, rose hip, rosehip",
1010
+ "990": "buckeye, horse chestnut, conker",
1011
+ "991": "coral fungus",
1012
+ "992": "agaric",
1013
+ "993": "gyromitra",
1014
+ "994": "stinkhorn, carrion fungus",
1015
+ "995": "earthstar",
1016
+ "996": "hen-of-the-woods, hen of the woods, Polyporus frondosus, Grifola frondosa",
1017
+ "997": "bolete",
1018
+ "998": "ear, spike, capitulum",
1019
+ "999": "toilet tissue, toilet paper, bathroom tissue"
1020
+ }
1021
+ }
DiCo-B-256/pipeline.py ADDED
@@ -0,0 +1,398 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """Hub custom pipeline: DiCoPipeline.
2
+ Load with native Hugging Face diffusers and trust_remote_code=True.
3
+ """
4
+
5
+ # Copyright 2026 The HuggingFace Team. All rights reserved.
6
+ #
7
+ # Licensed under the Apache License, Version 2.0 (the "License");
8
+ # you may not use this file except in compliance with the License.
9
+ # You may obtain a copy of the License at
10
+ #
11
+ # http://www.apache.org/licenses/LICENSE-2.0
12
+ #
13
+ # Unless required by applicable law or agreed to in writing, software
14
+ # distributed under the License is distributed on an "AS IS" BASIS,
15
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16
+ # See the License for the specific language governing permissions and
17
+ # limitations under the License.
18
+
19
+ from __future__ import annotations
20
+
21
+ import inspect
22
+ import json
23
+ from pathlib import Path
24
+ from typing import Dict, List, Optional, Tuple, Union
25
+
26
+ import torch
27
+ from diffusers.image_processor import VaeImageProcessor
28
+ from diffusers.models import AutoencoderKL
29
+ from diffusers.pipelines.pipeline_utils import DiffusionPipeline, ImagePipelineOutput
30
+ from diffusers.schedulers import DDIMScheduler, KarrasDiffusionSchedulers
31
+ from diffusers.utils.torch_utils import randn_tensor
32
+
33
+
34
+ EXAMPLE_DOC_STRING = """
35
+ Examples:
36
+ ```py
37
+ >>> from pathlib import Path
38
+ >>> from diffusers import DiffusionPipeline
39
+ >>> import torch
40
+
41
+ >>> model_dir = Path("./DiCo-XL-256").resolve()
42
+ >>> pipe = DiffusionPipeline.from_pretrained(
43
+ ... str(model_dir),
44
+ ... local_files_only=True,
45
+ ... custom_pipeline=str(model_dir / "pipeline.py"),
46
+ ... trust_remote_code=True,
47
+ ... torch_dtype=torch.bfloat16,
48
+ ... )
49
+ >>> pipe.to("cuda")
50
+
51
+ >>> image = pipe(
52
+ ... class_labels="golden retriever",
53
+ ... num_inference_steps=250,
54
+ ... guidance_scale=1.4,
55
+ ... generator=torch.Generator("cuda").manual_seed(0),
56
+ ... ).images[0]
57
+ ```
58
+ """
59
+
60
+
61
+ class DiCoPipeline(DiffusionPipeline):
62
+ r"""
63
+ Pipeline for class-conditional image generation with DiCo (Diffusion ConvNet).
64
+
65
+ Parameters:
66
+ transformer ([`DiCoTransformer2DModel`]):
67
+ Class-conditional DiCo denoiser operating in VAE latent space.
68
+ vae ([`AutoencoderKL`]):
69
+ Variational autoencoder used to decode latents to pixels.
70
+ scheduler ([`DDIMScheduler`]):
71
+ Diffusion scheduler. Other [`KarrasDiffusionSchedulers`] can be swapped at inference time.
72
+ id2label (`dict[int, str]`, *optional*):
73
+ ImageNet class id to English label mapping. Values may contain comma-separated synonyms.
74
+ """
75
+
76
+ model_cpu_offload_seq = "transformer->vae"
77
+
78
+ @staticmethod
79
+ def prepare_extra_step_kwargs(
80
+ scheduler: KarrasDiffusionSchedulers,
81
+ generator: Optional[Union[torch.Generator, List[torch.Generator]]] = None,
82
+ eta: float = 0.0,
83
+ ) -> Dict[str, object]:
84
+ kwargs: Dict[str, object] = {}
85
+ step_params = set(inspect.signature(scheduler.step).parameters.keys())
86
+ if "generator" in step_params:
87
+ kwargs["generator"] = generator
88
+ if "eta" in step_params:
89
+ kwargs["eta"] = eta
90
+ return kwargs
91
+
92
+ def __init__(
93
+ self,
94
+ transformer,
95
+ vae: AutoencoderKL,
96
+ scheduler: KarrasDiffusionSchedulers,
97
+ id2label: Optional[Dict[Union[int, str], str]] = None,
98
+ ):
99
+ super().__init__()
100
+ if scheduler is None:
101
+ scheduler = DDIMScheduler(
102
+ num_train_timesteps=1000,
103
+ beta_start=0.0001,
104
+ beta_end=0.02,
105
+ beta_schedule="linear",
106
+ clip_sample=False,
107
+ set_alpha_to_one=True,
108
+ steps_offset=0,
109
+ prediction_type="epsilon",
110
+ )
111
+ self.register_modules(transformer=transformer, vae=vae, scheduler=scheduler)
112
+ self.vae_scale_factor = 2 ** (len(self.vae.config.block_out_channels) - 1)
113
+ self.image_processor = VaeImageProcessor(vae_scale_factor=self.vae_scale_factor)
114
+ self._id2label = self._normalize_id2label(id2label)
115
+ self.labels = self._build_label2id(self._id2label)
116
+ self._labels_loaded_from_model_index = bool(self._id2label)
117
+
118
+ @classmethod
119
+ def from_pretrained(cls, pretrained_model_name_or_path: str, **kwargs):
120
+ model_kwargs = dict(kwargs)
121
+ transformer_subfolder = model_kwargs.pop("transformer_subfolder", None)
122
+ scheduler_subfolder = model_kwargs.pop("scheduler_subfolder", None)
123
+ vae_subfolder = model_kwargs.pop("vae_subfolder", None)
124
+ scheduler_kwargs = model_kwargs.pop("scheduler_kwargs", {})
125
+ base_path = Path(pretrained_model_name_or_path)
126
+
127
+ if transformer_subfolder is None and (base_path / "transformer").exists():
128
+ transformer_subfolder = "transformer"
129
+ if scheduler_subfolder is None and (base_path / "scheduler").exists():
130
+ scheduler_subfolder = "scheduler"
131
+ if vae_subfolder is None and (base_path / "vae").exists():
132
+ vae_subfolder = "vae"
133
+
134
+ try:
135
+ return super().from_pretrained(pretrained_model_name_or_path, **kwargs)
136
+ except Exception:
137
+ transformer_path = str(base_path / transformer_subfolder) if transformer_subfolder else pretrained_model_name_or_path
138
+ from transformer.transformer_dico import DiCoTransformer2DModel
139
+ transformer = DiCoTransformer2DModel.from_pretrained(transformer_path, **model_kwargs)
140
+ try:
141
+ scheduler = DDIMScheduler.from_pretrained(
142
+ pretrained_model_name_or_path,
143
+ subfolder=scheduler_subfolder,
144
+ **scheduler_kwargs,
145
+ )
146
+ except Exception:
147
+ scheduler = DDIMScheduler(
148
+ num_train_timesteps=1000,
149
+ beta_start=0.0001,
150
+ beta_end=0.02,
151
+ beta_schedule="linear",
152
+ clip_sample=False,
153
+ set_alpha_to_one=True,
154
+ steps_offset=0,
155
+ prediction_type="epsilon",
156
+ **scheduler_kwargs,
157
+ )
158
+ try:
159
+ vae = AutoencoderKL.from_pretrained(
160
+ pretrained_model_name_or_path,
161
+ subfolder=vae_subfolder,
162
+ **model_kwargs,
163
+ )
164
+ except Exception:
165
+ vae = AutoencoderKL.from_pretrained("stabilityai/sd-vae-ft-ema", **model_kwargs)
166
+ id2label = cls._read_id2label_from_model_index(str(base_path))
167
+ return cls(transformer=transformer, vae=vae, scheduler=scheduler, id2label=id2label)
168
+
169
+ def _ensure_labels_loaded(self) -> None:
170
+ if self._labels_loaded_from_model_index:
171
+ return
172
+ loaded = self._read_id2label_from_model_index(getattr(self.config, "_name_or_path", None))
173
+ if loaded:
174
+ self._id2label = loaded
175
+ self.labels = self._build_label2id(self._id2label)
176
+ self._labels_loaded_from_model_index = True
177
+
178
+ @staticmethod
179
+ def _normalize_id2label(id2label: Optional[Dict[Union[int, str], str]]) -> Dict[int, str]:
180
+ if not id2label:
181
+ return {}
182
+ return {int(key): value for key, value in id2label.items()}
183
+
184
+ @staticmethod
185
+ def _read_id2label_from_model_index(variant_path: Optional[str]) -> Dict[int, str]:
186
+ if not variant_path:
187
+ return {}
188
+ model_index_path = Path(variant_path).resolve() / "model_index.json"
189
+ if not model_index_path.exists():
190
+ return {}
191
+ raw = json.loads(model_index_path.read_text(encoding="utf-8"))
192
+ id2label = raw.get("id2label")
193
+ if not isinstance(id2label, dict):
194
+ return {}
195
+ return {int(key): value for key, value in id2label.items()}
196
+
197
+ @staticmethod
198
+ def _build_label2id(id2label: Dict[int, str]) -> Dict[str, int]:
199
+ label2id: Dict[str, int] = {}
200
+ for class_id, value in id2label.items():
201
+ for synonym in value.split(","):
202
+ synonym = synonym.strip()
203
+ if synonym:
204
+ label2id[synonym] = int(class_id)
205
+ return dict(sorted(label2id.items()))
206
+
207
+ @property
208
+ def id2label(self) -> Dict[int, str]:
209
+ self._ensure_labels_loaded()
210
+ return self._id2label
211
+
212
+ def get_label_ids(self, label: Union[str, List[str]]) -> List[int]:
213
+ self._ensure_labels_loaded()
214
+ if not self.labels:
215
+ raise ValueError("No English labels loaded. Ensure `id2label` exists in model_index.json.")
216
+ if isinstance(label, str):
217
+ label = [label]
218
+ missing = [item for item in label if item not in self.labels]
219
+ if missing:
220
+ preview = ", ".join(list(self.labels.keys())[:8])
221
+ raise ValueError(f"Unknown English label(s): {missing}. Example valid labels: {preview}, ...")
222
+ return [self.labels[item] for item in label]
223
+
224
+ def _normalize_class_labels(
225
+ self,
226
+ class_labels: Union[int, str, List[Union[int, str]], torch.LongTensor],
227
+ ) -> torch.LongTensor:
228
+ if torch.is_tensor(class_labels):
229
+ return class_labels.to(device=self._execution_device, dtype=torch.long).reshape(-1)
230
+ if isinstance(class_labels, int):
231
+ class_label_ids = [class_labels]
232
+ elif isinstance(class_labels, str):
233
+ class_label_ids = self.get_label_ids(class_labels)
234
+ elif class_labels and isinstance(class_labels[0], str):
235
+ class_label_ids = self.get_label_ids(class_labels)
236
+ else:
237
+ class_label_ids = list(class_labels)
238
+ return torch.tensor(class_label_ids, device=self._execution_device, dtype=torch.long).reshape(-1)
239
+
240
+ def _default_image_size(self) -> int:
241
+ return int(self.transformer.config.input_size) * self.vae_scale_factor
242
+
243
+ def check_inputs(
244
+ self,
245
+ height: int,
246
+ width: int,
247
+ num_inference_steps: int,
248
+ output_type: str,
249
+ ) -> None:
250
+ if num_inference_steps < 1:
251
+ raise ValueError("num_inference_steps must be >= 1.")
252
+ if output_type not in {"pil", "np", "pt", "latent"}:
253
+ raise ValueError("output_type must be one of: 'pil', 'np', 'pt', 'latent'.")
254
+ if height % self.vae_scale_factor != 0 or width % self.vae_scale_factor != 0:
255
+ raise ValueError(
256
+ f"height and width must be divisible by the VAE downsample factor {self.vae_scale_factor}."
257
+ )
258
+ latent_height = height // self.vae_scale_factor
259
+ latent_width = width // self.vae_scale_factor
260
+ expected_size = int(self.transformer.config.input_size)
261
+ if latent_height != expected_size or latent_width != expected_size:
262
+ raise ValueError(
263
+ f"Requested latent size {(latent_height, latent_width)} does not match the pretrained "
264
+ f"transformer input_size={expected_size}. Use height=width={self._default_image_size()}."
265
+ )
266
+
267
+ def prepare_latents(
268
+ self,
269
+ batch_size: int,
270
+ height: int,
271
+ width: int,
272
+ dtype: torch.dtype,
273
+ device: torch.device,
274
+ generator: Optional[Union[torch.Generator, List[torch.Generator]]],
275
+ ) -> torch.Tensor:
276
+ latent_height = height // self.vae_scale_factor
277
+ latent_width = width // self.vae_scale_factor
278
+ return randn_tensor(
279
+ (batch_size, self.transformer.config.in_channels, latent_height, latent_width),
280
+ generator=generator,
281
+ device=device,
282
+ dtype=dtype,
283
+ )
284
+
285
+ @staticmethod
286
+ def _expand_timestep(timestep, batch: int, device: torch.device) -> torch.Tensor:
287
+ if not torch.is_tensor(timestep):
288
+ timestep = torch.tensor([timestep], dtype=torch.long, device=device)
289
+ elif timestep.ndim == 0:
290
+ timestep = timestep[None].to(device=device)
291
+ return timestep.expand(batch)
292
+
293
+ @staticmethod
294
+ def _prepare_model_output_for_scheduler(
295
+ model_output: torch.Tensor,
296
+ latent_channels: int,
297
+ scheduler: KarrasDiffusionSchedulers,
298
+ ) -> torch.Tensor:
299
+ if model_output.shape[1] != 2 * latent_channels:
300
+ return model_output
301
+ variance_type = getattr(scheduler.config, "variance_type", None)
302
+ if scheduler.__class__.__name__ == "DDPMScheduler" and variance_type in ("learned", "learned_range"):
303
+ return model_output
304
+ model_output, _ = torch.split(model_output, latent_channels, dim=1)
305
+ return model_output
306
+
307
+ def decode_latents(self, latents: torch.Tensor, output_type: str = "pil"):
308
+ if output_type == "latent":
309
+ return latents
310
+ scaling_factor = getattr(self.vae.config, "scaling_factor", 0.18215)
311
+ image = self.vae.decode(latents / scaling_factor).sample
312
+ if output_type == "pt":
313
+ return image
314
+ return self.image_processor.postprocess(image, output_type=output_type)
315
+
316
+ @torch.inference_mode()
317
+ def __call__(
318
+ self,
319
+ class_labels: Union[int, str, List[Union[int, str]], torch.LongTensor],
320
+ height: Optional[int] = None,
321
+ width: Optional[int] = None,
322
+ num_inference_steps: int = 250,
323
+ guidance_scale: float = 1.0,
324
+ eta: float = 0.0,
325
+ generator: Optional[Union[torch.Generator, List[torch.Generator]]] = None,
326
+ output_type: str = "pil",
327
+ return_dict: bool = True,
328
+ ) -> Union[ImagePipelineOutput, Tuple]:
329
+ default_size = self._default_image_size()
330
+ height = int(height or default_size)
331
+ width = int(width or default_size)
332
+ self.check_inputs(height, width, num_inference_steps, output_type)
333
+
334
+ device = self._execution_device
335
+ model_dtype = next(self.transformer.parameters()).dtype
336
+ class_labels_tensor = self._normalize_class_labels(class_labels)
337
+ batch_size = class_labels_tensor.numel()
338
+ latent_channels = int(self.transformer.config.in_channels)
339
+ null_class_val = int(self.transformer.config.num_classes)
340
+ do_cfg = guidance_scale > 1.0
341
+
342
+ latents = self.prepare_latents(
343
+ batch_size=batch_size,
344
+ height=height,
345
+ width=width,
346
+ dtype=model_dtype,
347
+ device=device,
348
+ generator=generator,
349
+ )
350
+ latent_model_input = torch.cat([latents] * 2) if do_cfg else latents
351
+
352
+ class_labels_input = class_labels_tensor
353
+ if do_cfg:
354
+ class_null = torch.full_like(class_labels_tensor, null_class_val)
355
+ class_labels_input = torch.cat([class_labels_tensor, class_null], dim=0)
356
+
357
+ self.scheduler.set_timesteps(num_inference_steps, device=device)
358
+ extra_step_kwargs = self.prepare_extra_step_kwargs(self.scheduler, generator=generator, eta=eta)
359
+
360
+ for t in self.progress_bar(self.scheduler.timesteps):
361
+ if do_cfg:
362
+ half = latent_model_input[: len(latent_model_input) // 2]
363
+ latent_model_input = torch.cat([half, half], dim=0)
364
+ latent_model_input = self.scheduler.scale_model_input(latent_model_input, t)
365
+ timesteps = self._expand_timestep(t, latent_model_input.shape[0], latent_model_input.device)
366
+
367
+ noise_pred = self.transformer(
368
+ hidden_states=latent_model_input,
369
+ timestep=timesteps,
370
+ class_labels=class_labels_input,
371
+ return_dict=True,
372
+ ).sample
373
+
374
+ if do_cfg:
375
+ eps, rest = noise_pred[:, :latent_channels], noise_pred[:, latent_channels:]
376
+ cond_eps, uncond_eps = torch.split(eps, len(eps) // 2, dim=0)
377
+ half_eps = uncond_eps + guidance_scale * (cond_eps - uncond_eps)
378
+ eps = torch.cat([half_eps, half_eps], dim=0)
379
+ noise_pred = torch.cat([eps, rest], dim=1)
380
+
381
+ model_output = self._prepare_model_output_for_scheduler(noise_pred, latent_channels, self.scheduler)
382
+ latent_model_input = self.scheduler.step(
383
+ model_output, t, latent_model_input, return_dict=True, **extra_step_kwargs
384
+ ).prev_sample
385
+
386
+ if do_cfg:
387
+ latents, _ = latent_model_input.chunk(2, dim=0)
388
+ else:
389
+ latents = latent_model_input
390
+
391
+ image = self.decode_latents(latents, output_type=output_type)
392
+ self.maybe_free_model_hooks()
393
+ if not return_dict:
394
+ return (image,)
395
+ return ImagePipelineOutput(images=image)
396
+
397
+
398
+ DiCoPipelineOutput = ImagePipelineOutput
DiCo-B-256/scheduler/scheduler_config.json ADDED
@@ -0,0 +1,12 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "_class_name": "DDIMScheduler",
3
+ "_diffusers_version": "0.35.1",
4
+ "num_train_timesteps": 1000,
5
+ "beta_start": 0.0001,
6
+ "beta_end": 0.02,
7
+ "beta_schedule": "linear",
8
+ "clip_sample": false,
9
+ "set_alpha_to_one": true,
10
+ "steps_offset": 0,
11
+ "prediction_type": "epsilon"
12
+ }
DiCo-B-256/transformer/config.json ADDED
@@ -0,0 +1,14 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "_class_name": "DiCoTransformer2DModel",
3
+ "_diffusers_version": "0.38.0",
4
+ "class_dropout_prob": 0.1,
5
+ "depth": null,
6
+ "hidden_size": 416,
7
+ "in_channels": 4,
8
+ "input_size": 32,
9
+ "learn_sigma": true,
10
+ "mlp_ratio": 2.0,
11
+ "model_type": "DiCo-B",
12
+ "num_class_embeds": null,
13
+ "num_classes": 1000
14
+ }
DiCo-B-256/transformer/diffusion_pytorch_model.safetensors ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:a70318a80eaff9e024b40cad7792244a1771fc167fbde9103c13ed2c5c159074
3
+ size 520003840
DiCo-B-256/transformer/transformer_dico.py ADDED
@@ -0,0 +1,479 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Copyright 2026 The HuggingFace Team. All rights reserved.
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ from __future__ import annotations
16
+
17
+ import argparse
18
+ import math
19
+ from collections.abc import Mapping
20
+ from typing import Dict, Literal, Optional, Tuple
21
+
22
+ import torch
23
+ import torch.nn as nn
24
+ import torch.nn.functional as F
25
+
26
+ from diffusers.configuration_utils import ConfigMixin, register_to_config
27
+ from diffusers.models.modeling_outputs import Transformer2DModelOutput
28
+ from diffusers.models.modeling_utils import ModelMixin
29
+
30
+
31
+ DICO_PRESET_CONFIGS: Dict[str, Dict[str, object]] = {
32
+ "DiCo-S": {
33
+ "hidden_size": 128,
34
+ "depth": [5, 4, 4, 4, 4],
35
+ "mlp_ratio": 2.0,
36
+ },
37
+ "DiCo-B": {
38
+ "hidden_size": 256,
39
+ "depth": [5, 4, 4, 4, 4],
40
+ "mlp_ratio": 2.0,
41
+ },
42
+ "DiCo-L": {
43
+ "hidden_size": 352,
44
+ "depth": [9, 8, 9, 8, 9],
45
+ "mlp_ratio": 2.0,
46
+ },
47
+ "DiCo-XL": {
48
+ "hidden_size": 416,
49
+ "depth": [9, 9, 10, 9, 9],
50
+ "mlp_ratio": 2.0,
51
+ },
52
+ "DiCo-H": {
53
+ "hidden_size": 416,
54
+ "depth": [14, 12, 10, 12, 14],
55
+ "mlp_ratio": 4.0,
56
+ },
57
+ }
58
+
59
+
60
+ def remap_legacy_state_dict(state_dict: Dict[str, torch.Tensor]) -> Dict[str, torch.Tensor]:
61
+ """Map wrapper/backbone keys from legacy checkpoints to native model keys."""
62
+ remapped: Dict[str, torch.Tensor] = {}
63
+ for key, value in state_dict.items():
64
+ new_key = key
65
+ for prefix in ("transformer.", "model.", "net."):
66
+ if new_key.startswith(prefix):
67
+ new_key = new_key[len(prefix) :]
68
+ break
69
+ remapped[new_key] = value
70
+ return remapped
71
+
72
+
73
+ def infer_learn_sigma(state_dict: Dict[str, torch.Tensor], in_channels: int = 4) -> bool:
74
+ weight = state_dict.get("final_layer.out_proj.weight")
75
+ if weight is None:
76
+ return True
77
+ return int(weight.shape[0]) == in_channels * 2
78
+
79
+
80
+ def config_from_legacy(config: Dict[str, object]) -> Dict[str, object]:
81
+ """Build native config kwargs from a legacy config.json dict."""
82
+ model_type = config.get("model_type") or config.get("model_name") or config.get("model")
83
+ if model_type not in DICO_PRESET_CONFIGS:
84
+ raise ValueError(f"Unknown DiCo preset '{model_type}'. Known: {list(DICO_PRESET_CONFIGS)}")
85
+
86
+ preset = dict(DICO_PRESET_CONFIGS[model_type])
87
+ preset["num_classes"] = int(config.get("num_class_embeds") or config.get("num_classes") or 1000)
88
+ preset["model_type"] = model_type
89
+ preset["input_size"] = int(config.get("input_size") or config.get("sample_size") or 32)
90
+ if config.get("learn_sigma") is not None:
91
+ preset["learn_sigma"] = bool(config["learn_sigma"])
92
+ return preset
93
+
94
+
95
+ def modulate(x: torch.Tensor, shift: torch.Tensor, scale: torch.Tensor) -> torch.Tensor:
96
+ return x * (1 + scale.unsqueeze(-1).unsqueeze(-1)) + shift.unsqueeze(-1).unsqueeze(-1)
97
+
98
+
99
+ class LayerNorm2d(nn.LayerNorm):
100
+ def __init__(self, num_channels: int, eps: float = 1e-6, affine: bool = True):
101
+ super().__init__(num_channels, eps=eps, elementwise_affine=affine)
102
+
103
+ def forward(self, x: torch.Tensor) -> torch.Tensor:
104
+ x = x.permute(0, 2, 3, 1)
105
+ x = F.layer_norm(x, self.normalized_shape, self.weight, self.bias, self.eps)
106
+ return x.permute(0, 3, 1, 2)
107
+
108
+
109
+ class DiCoTimestepEmbedder(nn.Module):
110
+ def __init__(self, hidden_size: int, frequency_embedding_size: int = 256):
111
+ super().__init__()
112
+ self.mlp = nn.Sequential(
113
+ nn.Linear(frequency_embedding_size, hidden_size, bias=True),
114
+ nn.SiLU(),
115
+ nn.Linear(hidden_size, hidden_size, bias=True),
116
+ )
117
+ self.frequency_embedding_size = frequency_embedding_size
118
+
119
+ @staticmethod
120
+ def timestep_embedding(t: torch.Tensor, dim: int, max_period: int = 10000) -> torch.Tensor:
121
+ half = dim // 2
122
+ freqs = torch.exp(
123
+ -math.log(max_period) * torch.arange(start=0, end=half, dtype=torch.float32) / half
124
+ ).to(device=t.device)
125
+ args = t[:, None].float() * freqs[None]
126
+ embedding = torch.cat([torch.cos(args), torch.sin(args)], dim=-1)
127
+ if dim % 2:
128
+ embedding = torch.cat([embedding, torch.zeros_like(embedding[:, :1])], dim=-1)
129
+ return embedding
130
+
131
+ def forward(self, t: torch.Tensor) -> torch.Tensor:
132
+ t_freq = self.timestep_embedding(t, self.frequency_embedding_size)
133
+ weight_dtype = self.mlp[0].weight.dtype
134
+ return self.mlp(t_freq.to(dtype=weight_dtype))
135
+
136
+
137
+ class DiCoLabelEmbedder(nn.Module):
138
+ def __init__(self, num_classes: int, hidden_size: int, dropout_prob: float):
139
+ super().__init__()
140
+ use_cfg_embedding = dropout_prob > 0
141
+ self.embedding_table = nn.Embedding(num_classes + use_cfg_embedding, hidden_size)
142
+ self.num_classes = num_classes
143
+ self.dropout_prob = dropout_prob
144
+
145
+ def token_drop(self, labels: torch.Tensor, force_drop_ids: Optional[torch.Tensor] = None) -> torch.Tensor:
146
+ if force_drop_ids is None:
147
+ drop_ids = torch.rand(labels.shape[0], device=labels.device) < self.dropout_prob
148
+ else:
149
+ drop_ids = force_drop_ids == 1
150
+ return torch.where(drop_ids, self.num_classes, labels)
151
+
152
+ def forward(
153
+ self,
154
+ labels: torch.Tensor,
155
+ train: bool,
156
+ force_drop_ids: Optional[torch.Tensor] = None,
157
+ ) -> torch.Tensor:
158
+ use_dropout = self.dropout_prob > 0
159
+ if (train and use_dropout) or (force_drop_ids is not None):
160
+ labels = self.token_drop(labels, force_drop_ids)
161
+ return self.embedding_table(labels)
162
+
163
+
164
+ class DiCoMultiScaleLabelEmbedder(nn.Module):
165
+ def __init__(
166
+ self,
167
+ num_classes: int,
168
+ hidden_size_0: int,
169
+ hidden_size_1: int,
170
+ hidden_size_2: int,
171
+ dropout_prob: float,
172
+ ):
173
+ super().__init__()
174
+ use_cfg_embedding = dropout_prob > 0
175
+ self.embedding_table_0 = nn.Embedding(num_classes + use_cfg_embedding, hidden_size_0)
176
+ self.embedding_table_1 = nn.Embedding(num_classes + use_cfg_embedding, hidden_size_1)
177
+ self.embedding_table_2 = nn.Embedding(num_classes + use_cfg_embedding, hidden_size_2)
178
+ self.num_classes = num_classes
179
+ self.dropout_prob = dropout_prob
180
+
181
+ def token_drop(self, labels: torch.Tensor, force_drop_ids: Optional[torch.Tensor] = None) -> torch.Tensor:
182
+ if force_drop_ids is None:
183
+ drop_ids = torch.rand(labels.shape[0], device=labels.device) < self.dropout_prob
184
+ else:
185
+ drop_ids = force_drop_ids == 1
186
+ return torch.where(drop_ids, self.num_classes, labels)
187
+
188
+ def forward(
189
+ self,
190
+ labels: torch.Tensor,
191
+ train: bool,
192
+ force_drop_ids: Optional[torch.Tensor] = None,
193
+ ) -> Tuple[torch.Tensor, torch.Tensor, torch.Tensor]:
194
+ use_dropout = self.dropout_prob > 0
195
+ if (train and use_dropout) or (force_drop_ids is not None):
196
+ labels = self.token_drop(labels, force_drop_ids)
197
+ return (
198
+ self.embedding_table_0(labels),
199
+ self.embedding_table_1(labels),
200
+ self.embedding_table_2(labels),
201
+ )
202
+
203
+
204
+ class DiCoBlock(nn.Module):
205
+ def __init__(self, hidden_size: int, mlp_ratio: float = 4.0):
206
+ super().__init__()
207
+ self.conv1 = nn.Conv2d(hidden_size, hidden_size, kernel_size=1, padding=0, stride=1, groups=1, bias=True)
208
+ self.conv2 = nn.Conv2d(
209
+ hidden_size, hidden_size, kernel_size=3, padding=1, stride=1, groups=hidden_size, bias=True
210
+ )
211
+ self.conv3 = nn.Conv2d(hidden_size, hidden_size, kernel_size=1, padding=0, stride=1, groups=1, bias=True)
212
+ self.ca = nn.Sequential(
213
+ nn.AdaptiveAvgPool2d(1),
214
+ nn.Conv2d(hidden_size, hidden_size, kernel_size=1, padding=0, stride=1, groups=1, bias=True),
215
+ nn.Sigmoid(),
216
+ )
217
+ ffn_channel = int(mlp_ratio * hidden_size)
218
+ self.conv4 = nn.Conv2d(hidden_size, ffn_channel, kernel_size=1, padding=0, stride=1, groups=1, bias=True)
219
+ self.conv5 = nn.Conv2d(ffn_channel, hidden_size, kernel_size=1, padding=0, stride=1, groups=1, bias=True)
220
+ self.norm1 = LayerNorm2d(hidden_size, affine=False, eps=1e-6)
221
+ self.norm2 = LayerNorm2d(hidden_size, affine=False, eps=1e-6)
222
+ self.adaLN_modulation = nn.Sequential(nn.SiLU(), nn.Linear(hidden_size, 6 * hidden_size, bias=True))
223
+
224
+ def forward(self, inp: torch.Tensor, c: torch.Tensor) -> torch.Tensor:
225
+ shift_msa, scale_msa, gate_msa, shift_mlp, scale_mlp, gate_mlp = self.adaLN_modulation(c).chunk(6, dim=1)
226
+ x = modulate(self.norm1(inp), shift_msa, scale_msa)
227
+ x = F.gelu(self.conv2(self.conv1(x)))
228
+ x = x * self.ca(x)
229
+ x = self.conv3(x)
230
+ x = inp + gate_msa.unsqueeze(-1).unsqueeze(-1) * x
231
+ x = x + gate_mlp.unsqueeze(-1).unsqueeze(-1) * self.conv5(
232
+ F.gelu(self.conv4(modulate(self.norm2(x), shift_mlp, scale_mlp)))
233
+ )
234
+ return x
235
+
236
+
237
+ class DiCoFinalLayer(nn.Module):
238
+ def __init__(self, hidden_size: int, out_channels: int):
239
+ super().__init__()
240
+ self.norm_final = LayerNorm2d(hidden_size, affine=False, eps=1e-6)
241
+ self.out_proj = nn.Conv2d(hidden_size, out_channels, kernel_size=3, stride=1, padding=1, bias=True)
242
+ self.adaLN_modulation = nn.Sequential(nn.SiLU(), nn.Linear(hidden_size, 2 * hidden_size, bias=True))
243
+
244
+ def forward(self, x: torch.Tensor, c: torch.Tensor) -> torch.Tensor:
245
+ shift, scale = self.adaLN_modulation(c).chunk(2, dim=1)
246
+ x = modulate(self.norm_final(x), shift, scale)
247
+ return self.out_proj(x)
248
+
249
+
250
+ class OverlapPatchEmbed(nn.Module):
251
+ def __init__(self, in_c: int = 3, embed_dim: int = 48, bias: bool = False):
252
+ super().__init__()
253
+ self.proj = nn.Conv2d(in_c, embed_dim, kernel_size=3, stride=1, padding=1, bias=bias)
254
+
255
+ def forward(self, x: torch.Tensor) -> torch.Tensor:
256
+ return self.proj(x)
257
+
258
+
259
+ class Downsample(nn.Module):
260
+ def __init__(self, n_feat: int):
261
+ super().__init__()
262
+ self.body = nn.Sequential(
263
+ nn.Conv2d(n_feat, n_feat // 2, kernel_size=3, stride=1, padding=1, bias=False),
264
+ nn.PixelUnshuffle(2),
265
+ )
266
+
267
+ def forward(self, x: torch.Tensor) -> torch.Tensor:
268
+ return self.body(x)
269
+
270
+
271
+ class Upsample(nn.Module):
272
+ def __init__(self, n_feat: int):
273
+ super().__init__()
274
+ self.body = nn.Sequential(
275
+ nn.Conv2d(n_feat, n_feat * 2, kernel_size=3, stride=1, padding=1, bias=False),
276
+ nn.PixelShuffle(2),
277
+ )
278
+
279
+ def forward(self, x: torch.Tensor) -> torch.Tensor:
280
+ return self.body(x)
281
+
282
+
283
+ class DiCoTransformer2DModel(ModelMixin, ConfigMixin):
284
+ r"""
285
+ DiCo (Diffusion ConvNet) denoiser for class-conditional latent diffusion.
286
+
287
+ ConvNet U-Net backbone with multi-scale adaLN conditioning, operating on VAE latents.
288
+ """
289
+
290
+ _supports_gradient_checkpointing = True
291
+
292
+ @register_to_config
293
+ def __init__(
294
+ self,
295
+ input_size: int = 32,
296
+ in_channels: int = 4,
297
+ hidden_size: int = 416,
298
+ depth: Optional[list[int]] = None,
299
+ mlp_ratio: float = 2.0,
300
+ class_dropout_prob: float = 0.1,
301
+ num_classes: int = 1000,
302
+ learn_sigma: bool = True,
303
+ model_type: str | None = None,
304
+ num_class_embeds: int | None = None,
305
+ ):
306
+ super().__init__()
307
+ if num_class_embeds is not None:
308
+ num_classes = int(num_class_embeds)
309
+ if model_type in DICO_PRESET_CONFIGS:
310
+ preset = DICO_PRESET_CONFIGS[model_type]
311
+ hidden_size = int(preset["hidden_size"])
312
+ depth = list(preset["depth"])
313
+ mlp_ratio = float(preset["mlp_ratio"])
314
+
315
+ if depth is None:
316
+ depth = [9, 9, 10, 9, 9]
317
+
318
+ self.learn_sigma = learn_sigma
319
+ self.in_channels = in_channels
320
+ self.out_channels = in_channels * 2 if learn_sigma else in_channels
321
+ self.num_classes = num_classes
322
+ self.gradient_checkpointing = False
323
+
324
+ self.x_embedder = OverlapPatchEmbed(in_channels, hidden_size, bias=True)
325
+ self.t_embedder_1 = DiCoTimestepEmbedder(hidden_size)
326
+ self.y_embedder = DiCoMultiScaleLabelEmbedder(
327
+ num_classes, hidden_size, hidden_size * 2, hidden_size * 4, class_dropout_prob
328
+ )
329
+ self.t_embedder_2 = DiCoTimestepEmbedder(hidden_size * 2)
330
+ self.t_embedder_3 = DiCoTimestepEmbedder(hidden_size * 4)
331
+
332
+ self.encoder_level_1 = nn.ModuleList([DiCoBlock(hidden_size, mlp_ratio) for _ in range(depth[0])])
333
+ self.down1_2 = Downsample(hidden_size)
334
+ self.encoder_level_2 = nn.ModuleList([DiCoBlock(hidden_size * 2, mlp_ratio) for _ in range(depth[1])])
335
+ self.down2_3 = Downsample(hidden_size * 2)
336
+ self.latent = nn.ModuleList([DiCoBlock(hidden_size * 4, mlp_ratio) for _ in range(depth[2])])
337
+ self.up3_2 = Upsample(int(hidden_size * 4))
338
+ self.reduce_chan_level2 = nn.Conv2d(int(hidden_size * 4), int(hidden_size * 2), kernel_size=1, bias=True)
339
+ self.decoder_level_2 = nn.ModuleList([DiCoBlock(hidden_size * 2, mlp_ratio) for _ in range(depth[3])])
340
+ self.up2_1 = Upsample(int(hidden_size * 2))
341
+ self.reduce_chan_level1 = nn.Conv2d(int(hidden_size * 2), int(hidden_size * 2), kernel_size=1, bias=True)
342
+ self.decoder_level_1 = nn.ModuleList([DiCoBlock(hidden_size * 2, mlp_ratio) for _ in range(depth[4])])
343
+ self.final_layer = DiCoFinalLayer(hidden_size * 2, self.out_channels)
344
+ self.initialize_weights()
345
+
346
+ def initialize_weights(self) -> None:
347
+ def _basic_init(module: nn.Module):
348
+ if isinstance(module, (nn.Linear, nn.Conv2d)):
349
+ torch.nn.init.xavier_uniform_(module.weight)
350
+ if module.bias is not None:
351
+ nn.init.constant_(module.bias, 0)
352
+
353
+ self.apply(_basic_init)
354
+ w = self.x_embedder.proj.weight.data
355
+ nn.init.xavier_uniform_(w.view([w.shape[0], -1]))
356
+ nn.init.constant_(self.x_embedder.proj.bias, 0)
357
+ nn.init.normal_(self.y_embedder.embedding_table_0.weight, std=0.02)
358
+ nn.init.normal_(self.y_embedder.embedding_table_1.weight, std=0.02)
359
+ nn.init.normal_(self.y_embedder.embedding_table_2.weight, std=0.02)
360
+ for embedder in (self.t_embedder_1, self.t_embedder_2, self.t_embedder_3):
361
+ nn.init.normal_(embedder.mlp[0].weight, std=0.02)
362
+ nn.init.normal_(embedder.mlp[2].weight, std=0.02)
363
+
364
+ blocks = (
365
+ self.encoder_level_1
366
+ + self.encoder_level_2
367
+ + self.latent
368
+ + self.decoder_level_2
369
+ + self.decoder_level_1
370
+ )
371
+ for block in blocks:
372
+ nn.init.constant_(block.adaLN_modulation[-1].weight, 0)
373
+ nn.init.constant_(block.adaLN_modulation[-1].bias, 0)
374
+ nn.init.constant_(self.final_layer.adaLN_modulation[-1].weight, 0)
375
+ nn.init.constant_(self.final_layer.adaLN_modulation[-1].bias, 0)
376
+ nn.init.constant_(self.final_layer.out_proj.weight, 0)
377
+ nn.init.constant_(self.final_layer.out_proj.bias, 0)
378
+
379
+ def _run_block(self, block: DiCoBlock, x: torch.Tensor, c: torch.Tensor) -> torch.Tensor:
380
+ if self.training and self.gradient_checkpointing:
381
+ return torch.utils.checkpoint.checkpoint(block, x, c, use_reentrant=False)
382
+ return block(x, c)
383
+
384
+ def forward(
385
+ self,
386
+ hidden_states: torch.Tensor,
387
+ timestep: torch.LongTensor,
388
+ class_labels: torch.LongTensor,
389
+ force_drop_ids: Optional[torch.Tensor] = None,
390
+ return_dict: bool = True,
391
+ ) -> Transformer2DModelOutput | Tuple:
392
+ timestep = torch.as_tensor(timestep, device=hidden_states.device)
393
+ if timestep.ndim == 0:
394
+ timestep = timestep.repeat(hidden_states.shape[0])
395
+ else:
396
+ timestep = timestep.reshape(-1)
397
+ if timestep.shape[0] == 1 and hidden_states.shape[0] > 1:
398
+ timestep = timestep.repeat(hidden_states.shape[0])
399
+
400
+ x = self.x_embedder(hidden_states)
401
+ t1 = self.t_embedder_1(timestep)
402
+ y1, y2, y3 = self.y_embedder(class_labels, self.training, force_drop_ids=force_drop_ids)
403
+ c1 = t1 + y1
404
+ c2 = self.t_embedder_2(timestep) + y2
405
+ c3 = self.t_embedder_3(timestep) + y3
406
+
407
+ out_enc_level1 = x
408
+ for block in self.encoder_level_1:
409
+ out_enc_level1 = self._run_block(block, out_enc_level1, c1)
410
+ out_enc_level2 = self.down1_2(out_enc_level1)
411
+ for block in self.encoder_level_2:
412
+ out_enc_level2 = self._run_block(block, out_enc_level2, c2)
413
+ latent = self.down2_3(out_enc_level2)
414
+ for block in self.latent:
415
+ latent = self._run_block(block, latent, c3)
416
+
417
+ inp_dec_level2 = self.reduce_chan_level2(torch.cat([self.up3_2(latent), out_enc_level2], dim=1))
418
+ for block in self.decoder_level_2:
419
+ inp_dec_level2 = self._run_block(block, inp_dec_level2, c2)
420
+ inp_dec_level1 = self.reduce_chan_level1(torch.cat([self.up2_1(inp_dec_level2), out_enc_level1], dim=1))
421
+ for block in self.decoder_level_1:
422
+ inp_dec_level1 = self._run_block(block, inp_dec_level1, c2)
423
+
424
+ output = self.final_layer(inp_dec_level1, c2)
425
+ if not return_dict:
426
+ return (output,)
427
+ return Transformer2DModelOutput(sample=output)
428
+
429
+ @classmethod
430
+ def from_dico_checkpoint(
431
+ cls,
432
+ checkpoint_path: str,
433
+ weights: Literal["model", "ema"] = "ema",
434
+ map_location: str = "cpu",
435
+ strict: bool = True,
436
+ model_type: str | None = None,
437
+ ) -> Tuple["DiCoTransformer2DModel", Dict[str, object]]:
438
+ checkpoint = torch.load(checkpoint_path, map_location=map_location, weights_only=False)
439
+ state_dict = checkpoint
440
+ if isinstance(checkpoint, Mapping):
441
+ if weights in checkpoint:
442
+ state_dict = checkpoint[weights]
443
+ elif "state_dict" in checkpoint:
444
+ state_dict = checkpoint["state_dict"]
445
+
446
+ state_dict = remap_legacy_state_dict(state_dict)
447
+
448
+ ckpt_args = checkpoint.get("args") if isinstance(checkpoint, Mapping) else None
449
+ args_dict: Dict[str, object] = {}
450
+ if ckpt_args is not None:
451
+ if isinstance(ckpt_args, argparse.Namespace):
452
+ args_dict = vars(ckpt_args)
453
+ elif isinstance(ckpt_args, Mapping):
454
+ args_dict = dict(ckpt_args)
455
+
456
+ resolved_model_type = model_type or args_dict.get("model") or args_dict.get("model_type")
457
+ image_size = int(args_dict.get("image_size") or 256)
458
+ num_classes = int(args_dict.get("num_classes") or 1000)
459
+
460
+ config: Dict[str, object] = {
461
+ "input_size": image_size // 8,
462
+ "num_classes": num_classes,
463
+ "learn_sigma": infer_learn_sigma(state_dict),
464
+ }
465
+ if resolved_model_type in DICO_PRESET_CONFIGS:
466
+ config["model_type"] = resolved_model_type
467
+
468
+ model = cls(**config)
469
+ model.load_state_dict(state_dict, strict=strict)
470
+ metadata = {
471
+ "checkpoint_path": checkpoint_path,
472
+ "weights": weights,
473
+ "model_type": resolved_model_type,
474
+ "source_args": ckpt_args,
475
+ }
476
+ return model, metadata
477
+
478
+
479
+ DiCoDiffusersModel = DiCoTransformer2DModel
DiCo-B-256/vae/config.json ADDED
@@ -0,0 +1,38 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "_class_name": "AutoencoderKL",
3
+ "_diffusers_version": "0.38.0",
4
+ "_name_or_path": "stabilityai/sd-vae-ft-ema",
5
+ "act_fn": "silu",
6
+ "block_out_channels": [
7
+ 128,
8
+ 256,
9
+ 512,
10
+ 512
11
+ ],
12
+ "down_block_types": [
13
+ "DownEncoderBlock2D",
14
+ "DownEncoderBlock2D",
15
+ "DownEncoderBlock2D",
16
+ "DownEncoderBlock2D"
17
+ ],
18
+ "force_upcast": true,
19
+ "in_channels": 3,
20
+ "latent_channels": 4,
21
+ "latents_mean": null,
22
+ "latents_std": null,
23
+ "layers_per_block": 2,
24
+ "mid_block_add_attention": true,
25
+ "norm_num_groups": 32,
26
+ "out_channels": 3,
27
+ "sample_size": 256,
28
+ "scaling_factor": 0.18215,
29
+ "shift_factor": null,
30
+ "up_block_types": [
31
+ "UpDecoderBlock2D",
32
+ "UpDecoderBlock2D",
33
+ "UpDecoderBlock2D",
34
+ "UpDecoderBlock2D"
35
+ ],
36
+ "use_post_quant_conv": true,
37
+ "use_quant_conv": true
38
+ }
DiCo-B-256/vae/diffusion_pytorch_model.safetensors ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:703abdcd7c389316b5128faa9b750a530ea1680b453170b27afebac5e4db30c4
3
+ size 334643268
DiCo-L-256/model_index.json ADDED
@@ -0,0 +1,1021 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "_class_name": [
3
+ "pipeline",
4
+ "DiCoPipeline"
5
+ ],
6
+ "_diffusers_version": "0.38.0",
7
+ "scheduler": [
8
+ "diffusers",
9
+ "DDIMScheduler"
10
+ ],
11
+ "transformer": [
12
+ "transformer_dico",
13
+ "DiCoTransformer2DModel"
14
+ ],
15
+ "vae": [
16
+ "diffusers",
17
+ "AutoencoderKL"
18
+ ],
19
+ "id2label": {
20
+ "0": "tench, Tinca tinca",
21
+ "1": "goldfish, Carassius auratus",
22
+ "2": "great white shark, white shark, man-eater, man-eating shark, Carcharodon carcharias",
23
+ "3": "tiger shark, Galeocerdo cuvieri",
24
+ "4": "hammerhead, hammerhead shark",
25
+ "5": "electric ray, crampfish, numbfish, torpedo",
26
+ "6": "stingray",
27
+ "7": "cock",
28
+ "8": "hen",
29
+ "9": "ostrich, Struthio camelus",
30
+ "10": "brambling, Fringilla montifringilla",
31
+ "11": "goldfinch, Carduelis carduelis",
32
+ "12": "house finch, linnet, Carpodacus mexicanus",
33
+ "13": "junco, snowbird",
34
+ "14": "indigo bunting, indigo finch, indigo bird, Passerina cyanea",
35
+ "15": "robin, American robin, Turdus migratorius",
36
+ "16": "bulbul",
37
+ "17": "jay",
38
+ "18": "magpie",
39
+ "19": "chickadee",
40
+ "20": "water ouzel, dipper",
41
+ "21": "kite",
42
+ "22": "bald eagle, American eagle, Haliaeetus leucocephalus",
43
+ "23": "vulture",
44
+ "24": "great grey owl, great gray owl, Strix nebulosa",
45
+ "25": "European fire salamander, Salamandra salamandra",
46
+ "26": "common newt, Triturus vulgaris",
47
+ "27": "eft",
48
+ "28": "spotted salamander, Ambystoma maculatum",
49
+ "29": "axolotl, mud puppy, Ambystoma mexicanum",
50
+ "30": "bullfrog, Rana catesbeiana",
51
+ "31": "tree frog, tree-frog",
52
+ "32": "tailed frog, bell toad, ribbed toad, tailed toad, Ascaphus trui",
53
+ "33": "loggerhead, loggerhead turtle, Caretta caretta",
54
+ "34": "leatherback turtle, leatherback, leathery turtle, Dermochelys coriacea",
55
+ "35": "mud turtle",
56
+ "36": "terrapin",
57
+ "37": "box turtle, box tortoise",
58
+ "38": "banded gecko",
59
+ "39": "common iguana, iguana, Iguana iguana",
60
+ "40": "American chameleon, anole, Anolis carolinensis",
61
+ "41": "whiptail, whiptail lizard",
62
+ "42": "agama",
63
+ "43": "frilled lizard, Chlamydosaurus kingi",
64
+ "44": "alligator lizard",
65
+ "45": "Gila monster, Heloderma suspectum",
66
+ "46": "green lizard, Lacerta viridis",
67
+ "47": "African chameleon, Chamaeleo chamaeleon",
68
+ "48": "Komodo dragon, Komodo lizard, dragon lizard, giant lizard, Varanus komodoensis",
69
+ "49": "African crocodile, Nile crocodile, Crocodylus niloticus",
70
+ "50": "American alligator, Alligator mississipiensis",
71
+ "51": "triceratops",
72
+ "52": "thunder snake, worm snake, Carphophis amoenus",
73
+ "53": "ringneck snake, ring-necked snake, ring snake",
74
+ "54": "hognose snake, puff adder, sand viper",
75
+ "55": "green snake, grass snake",
76
+ "56": "king snake, kingsnake",
77
+ "57": "garter snake, grass snake",
78
+ "58": "water snake",
79
+ "59": "vine snake",
80
+ "60": "night snake, Hypsiglena torquata",
81
+ "61": "boa constrictor, Constrictor constrictor",
82
+ "62": "rock python, rock snake, Python sebae",
83
+ "63": "Indian cobra, Naja naja",
84
+ "64": "green mamba",
85
+ "65": "sea snake",
86
+ "66": "horned viper, cerastes, sand viper, horned asp, Cerastes cornutus",
87
+ "67": "diamondback, diamondback rattlesnake, Crotalus adamanteus",
88
+ "68": "sidewinder, horned rattlesnake, Crotalus cerastes",
89
+ "69": "trilobite",
90
+ "70": "harvestman, daddy longlegs, Phalangium opilio",
91
+ "71": "scorpion",
92
+ "72": "black and gold garden spider, Argiope aurantia",
93
+ "73": "barn spider, Araneus cavaticus",
94
+ "74": "garden spider, Aranea diademata",
95
+ "75": "black widow, Latrodectus mactans",
96
+ "76": "tarantula",
97
+ "77": "wolf spider, hunting spider",
98
+ "78": "tick",
99
+ "79": "centipede",
100
+ "80": "black grouse",
101
+ "81": "ptarmigan",
102
+ "82": "ruffed grouse, partridge, Bonasa umbellus",
103
+ "83": "prairie chicken, prairie grouse, prairie fowl",
104
+ "84": "peacock",
105
+ "85": "quail",
106
+ "86": "partridge",
107
+ "87": "African grey, African gray, Psittacus erithacus",
108
+ "88": "macaw",
109
+ "89": "sulphur-crested cockatoo, Kakatoe galerita, Cacatua galerita",
110
+ "90": "lorikeet",
111
+ "91": "coucal",
112
+ "92": "bee eater",
113
+ "93": "hornbill",
114
+ "94": "hummingbird",
115
+ "95": "jacamar",
116
+ "96": "toucan",
117
+ "97": "drake",
118
+ "98": "red-breasted merganser, Mergus serrator",
119
+ "99": "goose",
120
+ "100": "black swan, Cygnus atratus",
121
+ "101": "tusker",
122
+ "102": "echidna, spiny anteater, anteater",
123
+ "103": "platypus, duckbill, duckbilled platypus, duck-billed platypus, Ornithorhynchus anatinus",
124
+ "104": "wallaby, brush kangaroo",
125
+ "105": "koala, koala bear, kangaroo bear, native bear, Phascolarctos cinereus",
126
+ "106": "wombat",
127
+ "107": "jellyfish",
128
+ "108": "sea anemone, anemone",
129
+ "109": "brain coral",
130
+ "110": "flatworm, platyhelminth",
131
+ "111": "nematode, nematode worm, roundworm",
132
+ "112": "conch",
133
+ "113": "snail",
134
+ "114": "slug",
135
+ "115": "sea slug, nudibranch",
136
+ "116": "chiton, coat-of-mail shell, sea cradle, polyplacophore",
137
+ "117": "chambered nautilus, pearly nautilus, nautilus",
138
+ "118": "Dungeness crab, Cancer magister",
139
+ "119": "rock crab, Cancer irroratus",
140
+ "120": "fiddler crab",
141
+ "121": "king crab, Alaska crab, Alaskan king crab, Alaska king crab, Paralithodes camtschatica",
142
+ "122": "American lobster, Northern lobster, Maine lobster, Homarus americanus",
143
+ "123": "spiny lobster, langouste, rock lobster, crawfish, crayfish, sea crawfish",
144
+ "124": "crayfish, crawfish, crawdad, crawdaddy",
145
+ "125": "hermit crab",
146
+ "126": "isopod",
147
+ "127": "white stork, Ciconia ciconia",
148
+ "128": "black stork, Ciconia nigra",
149
+ "129": "spoonbill",
150
+ "130": "flamingo",
151
+ "131": "little blue heron, Egretta caerulea",
152
+ "132": "American egret, great white heron, Egretta albus",
153
+ "133": "bittern",
154
+ "134": "crane",
155
+ "135": "limpkin, Aramus pictus",
156
+ "136": "European gallinule, Porphyrio porphyrio",
157
+ "137": "American coot, marsh hen, mud hen, water hen, Fulica americana",
158
+ "138": "bustard",
159
+ "139": "ruddy turnstone, Arenaria interpres",
160
+ "140": "red-backed sandpiper, dunlin, Erolia alpina",
161
+ "141": "redshank, Tringa totanus",
162
+ "142": "dowitcher",
163
+ "143": "oystercatcher, oyster catcher",
164
+ "144": "pelican",
165
+ "145": "king penguin, Aptenodytes patagonica",
166
+ "146": "albatross, mollymawk",
167
+ "147": "grey whale, gray whale, devilfish, Eschrichtius gibbosus, Eschrichtius robustus",
168
+ "148": "killer whale, killer, orca, grampus, sea wolf, Orcinus orca",
169
+ "149": "dugong, Dugong dugon",
170
+ "150": "sea lion",
171
+ "151": "Chihuahua",
172
+ "152": "Japanese spaniel",
173
+ "153": "Maltese dog, Maltese terrier, Maltese",
174
+ "154": "Pekinese, Pekingese, Peke",
175
+ "155": "Shih-Tzu",
176
+ "156": "Blenheim spaniel",
177
+ "157": "papillon",
178
+ "158": "toy terrier",
179
+ "159": "Rhodesian ridgeback",
180
+ "160": "Afghan hound, Afghan",
181
+ "161": "basset, basset hound",
182
+ "162": "beagle",
183
+ "163": "bloodhound, sleuthhound",
184
+ "164": "bluetick",
185
+ "165": "black-and-tan coonhound",
186
+ "166": "Walker hound, Walker foxhound",
187
+ "167": "English foxhound",
188
+ "168": "redbone",
189
+ "169": "borzoi, Russian wolfhound",
190
+ "170": "Irish wolfhound",
191
+ "171": "Italian greyhound",
192
+ "172": "whippet",
193
+ "173": "Ibizan hound, Ibizan Podenco",
194
+ "174": "Norwegian elkhound, elkhound",
195
+ "175": "otterhound, otter hound",
196
+ "176": "Saluki, gazelle hound",
197
+ "177": "Scottish deerhound, deerhound",
198
+ "178": "Weimaraner",
199
+ "179": "Staffordshire bullterrier, Staffordshire bull terrier",
200
+ "180": "American Staffordshire terrier, Staffordshire terrier, American pit bull terrier, pit bull terrier",
201
+ "181": "Bedlington terrier",
202
+ "182": "Border terrier",
203
+ "183": "Kerry blue terrier",
204
+ "184": "Irish terrier",
205
+ "185": "Norfolk terrier",
206
+ "186": "Norwich terrier",
207
+ "187": "Yorkshire terrier",
208
+ "188": "wire-haired fox terrier",
209
+ "189": "Lakeland terrier",
210
+ "190": "Sealyham terrier, Sealyham",
211
+ "191": "Airedale, Airedale terrier",
212
+ "192": "cairn, cairn terrier",
213
+ "193": "Australian terrier",
214
+ "194": "Dandie Dinmont, Dandie Dinmont terrier",
215
+ "195": "Boston bull, Boston terrier",
216
+ "196": "miniature schnauzer",
217
+ "197": "giant schnauzer",
218
+ "198": "standard schnauzer",
219
+ "199": "Scotch terrier, Scottish terrier, Scottie",
220
+ "200": "Tibetan terrier, chrysanthemum dog",
221
+ "201": "silky terrier, Sydney silky",
222
+ "202": "soft-coated wheaten terrier",
223
+ "203": "West Highland white terrier",
224
+ "204": "Lhasa, Lhasa apso",
225
+ "205": "flat-coated retriever",
226
+ "206": "curly-coated retriever",
227
+ "207": "golden retriever",
228
+ "208": "Labrador retriever",
229
+ "209": "Chesapeake Bay retriever",
230
+ "210": "German short-haired pointer",
231
+ "211": "vizsla, Hungarian pointer",
232
+ "212": "English setter",
233
+ "213": "Irish setter, red setter",
234
+ "214": "Gordon setter",
235
+ "215": "Brittany spaniel",
236
+ "216": "clumber, clumber spaniel",
237
+ "217": "English springer, English springer spaniel",
238
+ "218": "Welsh springer spaniel",
239
+ "219": "cocker spaniel, English cocker spaniel, cocker",
240
+ "220": "Sussex spaniel",
241
+ "221": "Irish water spaniel",
242
+ "222": "kuvasz",
243
+ "223": "schipperke",
244
+ "224": "groenendael",
245
+ "225": "malinois",
246
+ "226": "briard",
247
+ "227": "kelpie",
248
+ "228": "komondor",
249
+ "229": "Old English sheepdog, bobtail",
250
+ "230": "Shetland sheepdog, Shetland sheep dog, Shetland",
251
+ "231": "collie",
252
+ "232": "Border collie",
253
+ "233": "Bouvier des Flandres, Bouviers des Flandres",
254
+ "234": "Rottweiler",
255
+ "235": "German shepherd, German shepherd dog, German police dog, alsatian",
256
+ "236": "Doberman, Doberman pinscher",
257
+ "237": "miniature pinscher",
258
+ "238": "Greater Swiss Mountain dog",
259
+ "239": "Bernese mountain dog",
260
+ "240": "Appenzeller",
261
+ "241": "EntleBucher",
262
+ "242": "boxer",
263
+ "243": "bull mastiff",
264
+ "244": "Tibetan mastiff",
265
+ "245": "French bulldog",
266
+ "246": "Great Dane",
267
+ "247": "Saint Bernard, St Bernard",
268
+ "248": "Eskimo dog, husky",
269
+ "249": "malamute, malemute, Alaskan malamute",
270
+ "250": "Siberian husky",
271
+ "251": "dalmatian, coach dog, carriage dog",
272
+ "252": "affenpinscher, monkey pinscher, monkey dog",
273
+ "253": "basenji",
274
+ "254": "pug, pug-dog",
275
+ "255": "Leonberg",
276
+ "256": "Newfoundland, Newfoundland dog",
277
+ "257": "Great Pyrenees",
278
+ "258": "Samoyed, Samoyede",
279
+ "259": "Pomeranian",
280
+ "260": "chow, chow chow",
281
+ "261": "keeshond",
282
+ "262": "Brabancon griffon",
283
+ "263": "Pembroke, Pembroke Welsh corgi",
284
+ "264": "Cardigan, Cardigan Welsh corgi",
285
+ "265": "toy poodle",
286
+ "266": "miniature poodle",
287
+ "267": "standard poodle",
288
+ "268": "Mexican hairless",
289
+ "269": "timber wolf, grey wolf, gray wolf, Canis lupus",
290
+ "270": "white wolf, Arctic wolf, Canis lupus tundrarum",
291
+ "271": "red wolf, maned wolf, Canis rufus, Canis niger",
292
+ "272": "coyote, prairie wolf, brush wolf, Canis latrans",
293
+ "273": "dingo, warrigal, warragal, Canis dingo",
294
+ "274": "dhole, Cuon alpinus",
295
+ "275": "African hunting dog, hyena dog, Cape hunting dog, Lycaon pictus",
296
+ "276": "hyena, hyaena",
297
+ "277": "red fox, Vulpes vulpes",
298
+ "278": "kit fox, Vulpes macrotis",
299
+ "279": "Arctic fox, white fox, Alopex lagopus",
300
+ "280": "grey fox, gray fox, Urocyon cinereoargenteus",
301
+ "281": "tabby, tabby cat",
302
+ "282": "tiger cat",
303
+ "283": "Persian cat",
304
+ "284": "Siamese cat, Siamese",
305
+ "285": "Egyptian cat",
306
+ "286": "cougar, puma, catamount, mountain lion, painter, panther, Felis concolor",
307
+ "287": "lynx, catamount",
308
+ "288": "leopard, Panthera pardus",
309
+ "289": "snow leopard, ounce, Panthera uncia",
310
+ "290": "jaguar, panther, Panthera onca, Felis onca",
311
+ "291": "lion, king of beasts, Panthera leo",
312
+ "292": "tiger, Panthera tigris",
313
+ "293": "cheetah, chetah, Acinonyx jubatus",
314
+ "294": "brown bear, bruin, Ursus arctos",
315
+ "295": "American black bear, black bear, Ursus americanus, Euarctos americanus",
316
+ "296": "ice bear, polar bear, Ursus Maritimus, Thalarctos maritimus",
317
+ "297": "sloth bear, Melursus ursinus, Ursus ursinus",
318
+ "298": "mongoose",
319
+ "299": "meerkat, mierkat",
320
+ "300": "tiger beetle",
321
+ "301": "ladybug, ladybeetle, lady beetle, ladybird, ladybird beetle",
322
+ "302": "ground beetle, carabid beetle",
323
+ "303": "long-horned beetle, longicorn, longicorn beetle",
324
+ "304": "leaf beetle, chrysomelid",
325
+ "305": "dung beetle",
326
+ "306": "rhinoceros beetle",
327
+ "307": "weevil",
328
+ "308": "fly",
329
+ "309": "bee",
330
+ "310": "ant, emmet, pismire",
331
+ "311": "grasshopper, hopper",
332
+ "312": "cricket",
333
+ "313": "walking stick, walkingstick, stick insect",
334
+ "314": "cockroach, roach",
335
+ "315": "mantis, mantid",
336
+ "316": "cicada, cicala",
337
+ "317": "leafhopper",
338
+ "318": "lacewing, lacewing fly",
339
+ "319": "dragonfly, darning needle, devils darning needle, sewing needle, snake feeder, snake doctor, mosquito hawk, skeeter hawk",
340
+ "320": "damselfly",
341
+ "321": "admiral",
342
+ "322": "ringlet, ringlet butterfly",
343
+ "323": "monarch, monarch butterfly, milkweed butterfly, Danaus plexippus",
344
+ "324": "cabbage butterfly",
345
+ "325": "sulphur butterfly, sulfur butterfly",
346
+ "326": "lycaenid, lycaenid butterfly",
347
+ "327": "starfish, sea star",
348
+ "328": "sea urchin",
349
+ "329": "sea cucumber, holothurian",
350
+ "330": "wood rabbit, cottontail, cottontail rabbit",
351
+ "331": "hare",
352
+ "332": "Angora, Angora rabbit",
353
+ "333": "hamster",
354
+ "334": "porcupine, hedgehog",
355
+ "335": "fox squirrel, eastern fox squirrel, Sciurus niger",
356
+ "336": "marmot",
357
+ "337": "beaver",
358
+ "338": "guinea pig, Cavia cobaya",
359
+ "339": "sorrel",
360
+ "340": "zebra",
361
+ "341": "hog, pig, grunter, squealer, Sus scrofa",
362
+ "342": "wild boar, boar, Sus scrofa",
363
+ "343": "warthog",
364
+ "344": "hippopotamus, hippo, river horse, Hippopotamus amphibius",
365
+ "345": "ox",
366
+ "346": "water buffalo, water ox, Asiatic buffalo, Bubalus bubalis",
367
+ "347": "bison",
368
+ "348": "ram, tup",
369
+ "349": "bighorn, bighorn sheep, cimarron, Rocky Mountain bighorn, Rocky Mountain sheep, Ovis canadensis",
370
+ "350": "ibex, Capra ibex",
371
+ "351": "hartebeest",
372
+ "352": "impala, Aepyceros melampus",
373
+ "353": "gazelle",
374
+ "354": "Arabian camel, dromedary, Camelus dromedarius",
375
+ "355": "llama",
376
+ "356": "weasel",
377
+ "357": "mink",
378
+ "358": "polecat, fitch, foulmart, foumart, Mustela putorius",
379
+ "359": "black-footed ferret, ferret, Mustela nigripes",
380
+ "360": "otter",
381
+ "361": "skunk, polecat, wood pussy",
382
+ "362": "badger",
383
+ "363": "armadillo",
384
+ "364": "three-toed sloth, ai, Bradypus tridactylus",
385
+ "365": "orangutan, orang, orangutang, Pongo pygmaeus",
386
+ "366": "gorilla, Gorilla gorilla",
387
+ "367": "chimpanzee, chimp, Pan troglodytes",
388
+ "368": "gibbon, Hylobates lar",
389
+ "369": "siamang, Hylobates syndactylus, Symphalangus syndactylus",
390
+ "370": "guenon, guenon monkey",
391
+ "371": "patas, hussar monkey, Erythrocebus patas",
392
+ "372": "baboon",
393
+ "373": "macaque",
394
+ "374": "langur",
395
+ "375": "colobus, colobus monkey",
396
+ "376": "proboscis monkey, Nasalis larvatus",
397
+ "377": "marmoset",
398
+ "378": "capuchin, ringtail, Cebus capucinus",
399
+ "379": "howler monkey, howler",
400
+ "380": "titi, titi monkey",
401
+ "381": "spider monkey, Ateles geoffroyi",
402
+ "382": "squirrel monkey, Saimiri sciureus",
403
+ "383": "Madagascar cat, ring-tailed lemur, Lemur catta",
404
+ "384": "indri, indris, Indri indri, Indri brevicaudatus",
405
+ "385": "Indian elephant, Elephas maximus",
406
+ "386": "African elephant, Loxodonta africana",
407
+ "387": "lesser panda, red panda, panda, bear cat, cat bear, Ailurus fulgens",
408
+ "388": "giant panda, panda, panda bear, coon bear, Ailuropoda melanoleuca",
409
+ "389": "barracouta, snoek",
410
+ "390": "eel",
411
+ "391": "coho, cohoe, coho salmon, blue jack, silver salmon, Oncorhynchus kisutch",
412
+ "392": "rock beauty, Holocanthus tricolor",
413
+ "393": "anemone fish",
414
+ "394": "sturgeon",
415
+ "395": "gar, garfish, garpike, billfish, Lepisosteus osseus",
416
+ "396": "lionfish",
417
+ "397": "puffer, pufferfish, blowfish, globefish",
418
+ "398": "abacus",
419
+ "399": "abaya",
420
+ "400": "academic gown, academic robe, judge robe",
421
+ "401": "accordion, piano accordion, squeeze box",
422
+ "402": "acoustic guitar",
423
+ "403": "aircraft carrier, carrier, flattop, attack aircraft carrier",
424
+ "404": "airliner",
425
+ "405": "airship, dirigible",
426
+ "406": "altar",
427
+ "407": "ambulance",
428
+ "408": "amphibian, amphibious vehicle",
429
+ "409": "analog clock",
430
+ "410": "apiary, bee house",
431
+ "411": "apron",
432
+ "412": "ashcan, trash can, garbage can, wastebin, ash bin, ash-bin, ashbin, dustbin, trash barrel, trash bin",
433
+ "413": "assault rifle, assault gun",
434
+ "414": "backpack, back pack, knapsack, packsack, rucksack, haversack",
435
+ "415": "bakery, bakeshop, bakehouse",
436
+ "416": "balance beam, beam",
437
+ "417": "balloon",
438
+ "418": "ballpoint, ballpoint pen, ballpen, Biro",
439
+ "419": "Band Aid",
440
+ "420": "banjo",
441
+ "421": "bannister, banister, balustrade, balusters, handrail",
442
+ "422": "barbell",
443
+ "423": "barber chair",
444
+ "424": "barbershop",
445
+ "425": "barn",
446
+ "426": "barometer",
447
+ "427": "barrel, cask",
448
+ "428": "barrow, garden cart, lawn cart, wheelbarrow",
449
+ "429": "baseball",
450
+ "430": "basketball",
451
+ "431": "bassinet",
452
+ "432": "bassoon",
453
+ "433": "bathing cap, swimming cap",
454
+ "434": "bath towel",
455
+ "435": "bathtub, bathing tub, bath, tub",
456
+ "436": "beach wagon, station wagon, wagon, estate car, beach waggon, station waggon, waggon",
457
+ "437": "beacon, lighthouse, beacon light, pharos",
458
+ "438": "beaker",
459
+ "439": "bearskin, busby, shako",
460
+ "440": "beer bottle",
461
+ "441": "beer glass",
462
+ "442": "bell cote, bell cot",
463
+ "443": "bib",
464
+ "444": "bicycle-built-for-two, tandem bicycle, tandem",
465
+ "445": "bikini, two-piece",
466
+ "446": "binder, ring-binder",
467
+ "447": "binoculars, field glasses, opera glasses",
468
+ "448": "birdhouse",
469
+ "449": "boathouse",
470
+ "450": "bobsled, bobsleigh, bob",
471
+ "451": "bolo tie, bolo, bola tie, bola",
472
+ "452": "bonnet, poke bonnet",
473
+ "453": "bookcase",
474
+ "454": "bookshop, bookstore, bookstall",
475
+ "455": "bottlecap",
476
+ "456": "bow",
477
+ "457": "bow tie, bow-tie, bowtie",
478
+ "458": "brass, memorial tablet, plaque",
479
+ "459": "brassiere, bra, bandeau",
480
+ "460": "breakwater, groin, groyne, mole, bulwark, seawall, jetty",
481
+ "461": "breastplate, aegis, egis",
482
+ "462": "broom",
483
+ "463": "bucket, pail",
484
+ "464": "buckle",
485
+ "465": "bulletproof vest",
486
+ "466": "bullet train, bullet",
487
+ "467": "butcher shop, meat market",
488
+ "468": "cab, hack, taxi, taxicab",
489
+ "469": "caldron, cauldron",
490
+ "470": "candle, taper, wax light",
491
+ "471": "cannon",
492
+ "472": "canoe",
493
+ "473": "can opener, tin opener",
494
+ "474": "cardigan",
495
+ "475": "car mirror",
496
+ "476": "carousel, carrousel, merry-go-round, roundabout, whirligig",
497
+ "477": "carpenters kit, tool kit",
498
+ "478": "carton",
499
+ "479": "car wheel",
500
+ "480": "cash machine, cash dispenser, automated teller machine, automatic teller machine, automated teller, automatic teller, ATM",
501
+ "481": "cassette",
502
+ "482": "cassette player",
503
+ "483": "castle",
504
+ "484": "catamaran",
505
+ "485": "CD player",
506
+ "486": "cello, violoncello",
507
+ "487": "cellular telephone, cellular phone, cellphone, cell, mobile phone",
508
+ "488": "chain",
509
+ "489": "chainlink fence",
510
+ "490": "chain mail, ring mail, mail, chain armor, chain armour, ring armor, ring armour",
511
+ "491": "chain saw, chainsaw",
512
+ "492": "chest",
513
+ "493": "chiffonier, commode",
514
+ "494": "chime, bell, gong",
515
+ "495": "china cabinet, china closet",
516
+ "496": "Christmas stocking",
517
+ "497": "church, church building",
518
+ "498": "cinema, movie theater, movie theatre, movie house, picture palace",
519
+ "499": "cleaver, meat cleaver, chopper",
520
+ "500": "cliff dwelling",
521
+ "501": "cloak",
522
+ "502": "clog, geta, patten, sabot",
523
+ "503": "cocktail shaker",
524
+ "504": "coffee mug",
525
+ "505": "coffeepot",
526
+ "506": "coil, spiral, volute, whorl, helix",
527
+ "507": "combination lock",
528
+ "508": "computer keyboard, keypad",
529
+ "509": "confectionery, confectionary, candy store",
530
+ "510": "container ship, containership, container vessel",
531
+ "511": "convertible",
532
+ "512": "corkscrew, bottle screw",
533
+ "513": "cornet, horn, trumpet, trump",
534
+ "514": "cowboy boot",
535
+ "515": "cowboy hat, ten-gallon hat",
536
+ "516": "cradle",
537
+ "517": "crane",
538
+ "518": "crash helmet",
539
+ "519": "crate",
540
+ "520": "crib, cot",
541
+ "521": "Crock Pot",
542
+ "522": "croquet ball",
543
+ "523": "crutch",
544
+ "524": "cuirass",
545
+ "525": "dam, dike, dyke",
546
+ "526": "desk",
547
+ "527": "desktop computer",
548
+ "528": "dial telephone, dial phone",
549
+ "529": "diaper, nappy, napkin",
550
+ "530": "digital clock",
551
+ "531": "digital watch",
552
+ "532": "dining table, board",
553
+ "533": "dishrag, dishcloth",
554
+ "534": "dishwasher, dish washer, dishwashing machine",
555
+ "535": "disk brake, disc brake",
556
+ "536": "dock, dockage, docking facility",
557
+ "537": "dogsled, dog sled, dog sleigh",
558
+ "538": "dome",
559
+ "539": "doormat, welcome mat",
560
+ "540": "drilling platform, offshore rig",
561
+ "541": "drum, membranophone, tympan",
562
+ "542": "drumstick",
563
+ "543": "dumbbell",
564
+ "544": "Dutch oven",
565
+ "545": "electric fan, blower",
566
+ "546": "electric guitar",
567
+ "547": "electric locomotive",
568
+ "548": "entertainment center",
569
+ "549": "envelope",
570
+ "550": "espresso maker",
571
+ "551": "face powder",
572
+ "552": "feather boa, boa",
573
+ "553": "file, file cabinet, filing cabinet",
574
+ "554": "fireboat",
575
+ "555": "fire engine, fire truck",
576
+ "556": "fire screen, fireguard",
577
+ "557": "flagpole, flagstaff",
578
+ "558": "flute, transverse flute",
579
+ "559": "folding chair",
580
+ "560": "football helmet",
581
+ "561": "forklift",
582
+ "562": "fountain",
583
+ "563": "fountain pen",
584
+ "564": "four-poster",
585
+ "565": "freight car",
586
+ "566": "French horn, horn",
587
+ "567": "frying pan, frypan, skillet",
588
+ "568": "fur coat",
589
+ "569": "garbage truck, dustcart",
590
+ "570": "gasmask, respirator, gas helmet",
591
+ "571": "gas pump, gasoline pump, petrol pump, island dispenser",
592
+ "572": "goblet",
593
+ "573": "go-kart",
594
+ "574": "golf ball",
595
+ "575": "golfcart, golf cart",
596
+ "576": "gondola",
597
+ "577": "gong, tam-tam",
598
+ "578": "gown",
599
+ "579": "grand piano, grand",
600
+ "580": "greenhouse, nursery, glasshouse",
601
+ "581": "grille, radiator grille",
602
+ "582": "grocery store, grocery, food market, market",
603
+ "583": "guillotine",
604
+ "584": "hair slide",
605
+ "585": "hair spray",
606
+ "586": "half track",
607
+ "587": "hammer",
608
+ "588": "hamper",
609
+ "589": "hand blower, blow dryer, blow drier, hair dryer, hair drier",
610
+ "590": "hand-held computer, hand-held microcomputer",
611
+ "591": "handkerchief, hankie, hanky, hankey",
612
+ "592": "hard disc, hard disk, fixed disk",
613
+ "593": "harmonica, mouth organ, harp, mouth harp",
614
+ "594": "harp",
615
+ "595": "harvester, reaper",
616
+ "596": "hatchet",
617
+ "597": "holster",
618
+ "598": "home theater, home theatre",
619
+ "599": "honeycomb",
620
+ "600": "hook, claw",
621
+ "601": "hoopskirt, crinoline",
622
+ "602": "horizontal bar, high bar",
623
+ "603": "horse cart, horse-cart",
624
+ "604": "hourglass",
625
+ "605": "iPod",
626
+ "606": "iron, smoothing iron",
627
+ "607": "jack-o-lantern",
628
+ "608": "jean, blue jean, denim",
629
+ "609": "jeep, landrover",
630
+ "610": "jersey, T-shirt, tee shirt",
631
+ "611": "jigsaw puzzle",
632
+ "612": "jinrikisha, ricksha, rickshaw",
633
+ "613": "joystick",
634
+ "614": "kimono",
635
+ "615": "knee pad",
636
+ "616": "knot",
637
+ "617": "lab coat, laboratory coat",
638
+ "618": "ladle",
639
+ "619": "lampshade, lamp shade",
640
+ "620": "laptop, laptop computer",
641
+ "621": "lawn mower, mower",
642
+ "622": "lens cap, lens cover",
643
+ "623": "letter opener, paper knife, paperknife",
644
+ "624": "library",
645
+ "625": "lifeboat",
646
+ "626": "lighter, light, igniter, ignitor",
647
+ "627": "limousine, limo",
648
+ "628": "liner, ocean liner",
649
+ "629": "lipstick, lip rouge",
650
+ "630": "Loafer",
651
+ "631": "lotion",
652
+ "632": "loudspeaker, speaker, speaker unit, loudspeaker system, speaker system",
653
+ "633": "loupe, jewelers loupe",
654
+ "634": "lumbermill, sawmill",
655
+ "635": "magnetic compass",
656
+ "636": "mailbag, postbag",
657
+ "637": "mailbox, letter box",
658
+ "638": "maillot",
659
+ "639": "maillot, tank suit",
660
+ "640": "manhole cover",
661
+ "641": "maraca",
662
+ "642": "marimba, xylophone",
663
+ "643": "mask",
664
+ "644": "matchstick",
665
+ "645": "maypole",
666
+ "646": "maze, labyrinth",
667
+ "647": "measuring cup",
668
+ "648": "medicine chest, medicine cabinet",
669
+ "649": "megalith, megalithic structure",
670
+ "650": "microphone, mike",
671
+ "651": "microwave, microwave oven",
672
+ "652": "military uniform",
673
+ "653": "milk can",
674
+ "654": "minibus",
675
+ "655": "miniskirt, mini",
676
+ "656": "minivan",
677
+ "657": "missile",
678
+ "658": "mitten",
679
+ "659": "mixing bowl",
680
+ "660": "mobile home, manufactured home",
681
+ "661": "Model T",
682
+ "662": "modem",
683
+ "663": "monastery",
684
+ "664": "monitor",
685
+ "665": "moped",
686
+ "666": "mortar",
687
+ "667": "mortarboard",
688
+ "668": "mosque",
689
+ "669": "mosquito net",
690
+ "670": "motor scooter, scooter",
691
+ "671": "mountain bike, all-terrain bike, off-roader",
692
+ "672": "mountain tent",
693
+ "673": "mouse, computer mouse",
694
+ "674": "mousetrap",
695
+ "675": "moving van",
696
+ "676": "muzzle",
697
+ "677": "nail",
698
+ "678": "neck brace",
699
+ "679": "necklace",
700
+ "680": "nipple",
701
+ "681": "notebook, notebook computer",
702
+ "682": "obelisk",
703
+ "683": "oboe, hautboy, hautbois",
704
+ "684": "ocarina, sweet potato",
705
+ "685": "odometer, hodometer, mileometer, milometer",
706
+ "686": "oil filter",
707
+ "687": "organ, pipe organ",
708
+ "688": "oscilloscope, scope, cathode-ray oscilloscope, CRO",
709
+ "689": "overskirt",
710
+ "690": "oxcart",
711
+ "691": "oxygen mask",
712
+ "692": "packet",
713
+ "693": "paddle, boat paddle",
714
+ "694": "paddlewheel, paddle wheel",
715
+ "695": "padlock",
716
+ "696": "paintbrush",
717
+ "697": "pajama, pyjama, pjs, jammies",
718
+ "698": "palace",
719
+ "699": "panpipe, pandean pipe, syrinx",
720
+ "700": "paper towel",
721
+ "701": "parachute, chute",
722
+ "702": "parallel bars, bars",
723
+ "703": "park bench",
724
+ "704": "parking meter",
725
+ "705": "passenger car, coach, carriage",
726
+ "706": "patio, terrace",
727
+ "707": "pay-phone, pay-station",
728
+ "708": "pedestal, plinth, footstall",
729
+ "709": "pencil box, pencil case",
730
+ "710": "pencil sharpener",
731
+ "711": "perfume, essence",
732
+ "712": "Petri dish",
733
+ "713": "photocopier",
734
+ "714": "pick, plectrum, plectron",
735
+ "715": "pickelhaube",
736
+ "716": "picket fence, paling",
737
+ "717": "pickup, pickup truck",
738
+ "718": "pier",
739
+ "719": "piggy bank, penny bank",
740
+ "720": "pill bottle",
741
+ "721": "pillow",
742
+ "722": "ping-pong ball",
743
+ "723": "pinwheel",
744
+ "724": "pirate, pirate ship",
745
+ "725": "pitcher, ewer",
746
+ "726": "plane, carpenters plane, woodworking plane",
747
+ "727": "planetarium",
748
+ "728": "plastic bag",
749
+ "729": "plate rack",
750
+ "730": "plow, plough",
751
+ "731": "plunger, plumbers helper",
752
+ "732": "Polaroid camera, Polaroid Land camera",
753
+ "733": "pole",
754
+ "734": "police van, police wagon, paddy wagon, patrol wagon, wagon, black Maria",
755
+ "735": "poncho",
756
+ "736": "pool table, billiard table, snooker table",
757
+ "737": "pop bottle, soda bottle",
758
+ "738": "pot, flowerpot",
759
+ "739": "potters wheel",
760
+ "740": "power drill",
761
+ "741": "prayer rug, prayer mat",
762
+ "742": "printer",
763
+ "743": "prison, prison house",
764
+ "744": "projectile, missile",
765
+ "745": "projector",
766
+ "746": "puck, hockey puck",
767
+ "747": "punching bag, punch bag, punching ball, punchball",
768
+ "748": "purse",
769
+ "749": "quill, quill pen",
770
+ "750": "quilt, comforter, comfort, puff",
771
+ "751": "racer, race car, racing car",
772
+ "752": "racket, racquet",
773
+ "753": "radiator",
774
+ "754": "radio, wireless",
775
+ "755": "radio telescope, radio reflector",
776
+ "756": "rain barrel",
777
+ "757": "recreational vehicle, RV, R.V.",
778
+ "758": "reel",
779
+ "759": "reflex camera",
780
+ "760": "refrigerator, icebox",
781
+ "761": "remote control, remote",
782
+ "762": "restaurant, eating house, eating place, eatery",
783
+ "763": "revolver, six-gun, six-shooter",
784
+ "764": "rifle",
785
+ "765": "rocking chair, rocker",
786
+ "766": "rotisserie",
787
+ "767": "rubber eraser, rubber, pencil eraser",
788
+ "768": "rugby ball",
789
+ "769": "rule, ruler",
790
+ "770": "running shoe",
791
+ "771": "safe",
792
+ "772": "safety pin",
793
+ "773": "saltshaker, salt shaker",
794
+ "774": "sandal",
795
+ "775": "sarong",
796
+ "776": "sax, saxophone",
797
+ "777": "scabbard",
798
+ "778": "scale, weighing machine",
799
+ "779": "school bus",
800
+ "780": "schooner",
801
+ "781": "scoreboard",
802
+ "782": "screen, CRT screen",
803
+ "783": "screw",
804
+ "784": "screwdriver",
805
+ "785": "seat belt, seatbelt",
806
+ "786": "sewing machine",
807
+ "787": "shield, buckler",
808
+ "788": "shoe shop, shoe-shop, shoe store",
809
+ "789": "shoji",
810
+ "790": "shopping basket",
811
+ "791": "shopping cart",
812
+ "792": "shovel",
813
+ "793": "shower cap",
814
+ "794": "shower curtain",
815
+ "795": "ski",
816
+ "796": "ski mask",
817
+ "797": "sleeping bag",
818
+ "798": "slide rule, slipstick",
819
+ "799": "sliding door",
820
+ "800": "slot, one-armed bandit",
821
+ "801": "snorkel",
822
+ "802": "snowmobile",
823
+ "803": "snowplow, snowplough",
824
+ "804": "soap dispenser",
825
+ "805": "soccer ball",
826
+ "806": "sock",
827
+ "807": "solar dish, solar collector, solar furnace",
828
+ "808": "sombrero",
829
+ "809": "soup bowl",
830
+ "810": "space bar",
831
+ "811": "space heater",
832
+ "812": "space shuttle",
833
+ "813": "spatula",
834
+ "814": "speedboat",
835
+ "815": "spider web, spiders web",
836
+ "816": "spindle",
837
+ "817": "sports car, sport car",
838
+ "818": "spotlight, spot",
839
+ "819": "stage",
840
+ "820": "steam locomotive",
841
+ "821": "steel arch bridge",
842
+ "822": "steel drum",
843
+ "823": "stethoscope",
844
+ "824": "stole",
845
+ "825": "stone wall",
846
+ "826": "stopwatch, stop watch",
847
+ "827": "stove",
848
+ "828": "strainer",
849
+ "829": "streetcar, tram, tramcar, trolley, trolley car",
850
+ "830": "stretcher",
851
+ "831": "studio couch, day bed",
852
+ "832": "stupa, tope",
853
+ "833": "submarine, pigboat, sub, U-boat",
854
+ "834": "suit, suit of clothes",
855
+ "835": "sundial",
856
+ "836": "sunglass",
857
+ "837": "sunglasses, dark glasses, shades",
858
+ "838": "sunscreen, sunblock, sun blocker",
859
+ "839": "suspension bridge",
860
+ "840": "swab, swob, mop",
861
+ "841": "sweatshirt",
862
+ "842": "swimming trunks, bathing trunks",
863
+ "843": "swing",
864
+ "844": "switch, electric switch, electrical switch",
865
+ "845": "syringe",
866
+ "846": "table lamp",
867
+ "847": "tank, army tank, armored combat vehicle, armoured combat vehicle",
868
+ "848": "tape player",
869
+ "849": "teapot",
870
+ "850": "teddy, teddy bear",
871
+ "851": "television, television system",
872
+ "852": "tennis ball",
873
+ "853": "thatch, thatched roof",
874
+ "854": "theater curtain, theatre curtain",
875
+ "855": "thimble",
876
+ "856": "thresher, thrasher, threshing machine",
877
+ "857": "throne",
878
+ "858": "tile roof",
879
+ "859": "toaster",
880
+ "860": "tobacco shop, tobacconist shop, tobacconist",
881
+ "861": "toilet seat",
882
+ "862": "torch",
883
+ "863": "totem pole",
884
+ "864": "tow truck, tow car, wrecker",
885
+ "865": "toyshop",
886
+ "866": "tractor",
887
+ "867": "trailer truck, tractor trailer, trucking rig, rig, articulated lorry, semi",
888
+ "868": "tray",
889
+ "869": "trench coat",
890
+ "870": "tricycle, trike, velocipede",
891
+ "871": "trimaran",
892
+ "872": "tripod",
893
+ "873": "triumphal arch",
894
+ "874": "trolleybus, trolley coach, trackless trolley",
895
+ "875": "trombone",
896
+ "876": "tub, vat",
897
+ "877": "turnstile",
898
+ "878": "typewriter keyboard",
899
+ "879": "umbrella",
900
+ "880": "unicycle, monocycle",
901
+ "881": "upright, upright piano",
902
+ "882": "vacuum, vacuum cleaner",
903
+ "883": "vase",
904
+ "884": "vault",
905
+ "885": "velvet",
906
+ "886": "vending machine",
907
+ "887": "vestment",
908
+ "888": "viaduct",
909
+ "889": "violin, fiddle",
910
+ "890": "volleyball",
911
+ "891": "waffle iron",
912
+ "892": "wall clock",
913
+ "893": "wallet, billfold, notecase, pocketbook",
914
+ "894": "wardrobe, closet, press",
915
+ "895": "warplane, military plane",
916
+ "896": "washbasin, handbasin, washbowl, lavabo, wash-hand basin",
917
+ "897": "washer, automatic washer, washing machine",
918
+ "898": "water bottle",
919
+ "899": "water jug",
920
+ "900": "water tower",
921
+ "901": "whiskey jug",
922
+ "902": "whistle",
923
+ "903": "wig",
924
+ "904": "window screen",
925
+ "905": "window shade",
926
+ "906": "Windsor tie",
927
+ "907": "wine bottle",
928
+ "908": "wing",
929
+ "909": "wok",
930
+ "910": "wooden spoon",
931
+ "911": "wool, woolen, woollen",
932
+ "912": "worm fence, snake fence, snake-rail fence, Virginia fence",
933
+ "913": "wreck",
934
+ "914": "yawl",
935
+ "915": "yurt",
936
+ "916": "web site, website, internet site, site",
937
+ "917": "comic book",
938
+ "918": "crossword puzzle, crossword",
939
+ "919": "street sign",
940
+ "920": "traffic light, traffic signal, stoplight",
941
+ "921": "book jacket, dust cover, dust jacket, dust wrapper",
942
+ "922": "menu",
943
+ "923": "plate",
944
+ "924": "guacamole",
945
+ "925": "consomme",
946
+ "926": "hot pot, hotpot",
947
+ "927": "trifle",
948
+ "928": "ice cream, icecream",
949
+ "929": "ice lolly, lolly, lollipop, popsicle",
950
+ "930": "French loaf",
951
+ "931": "bagel, beigel",
952
+ "932": "pretzel",
953
+ "933": "cheeseburger",
954
+ "934": "hotdog, hot dog, red hot",
955
+ "935": "mashed potato",
956
+ "936": "head cabbage",
957
+ "937": "broccoli",
958
+ "938": "cauliflower",
959
+ "939": "zucchini, courgette",
960
+ "940": "spaghetti squash",
961
+ "941": "acorn squash",
962
+ "942": "butternut squash",
963
+ "943": "cucumber, cuke",
964
+ "944": "artichoke, globe artichoke",
965
+ "945": "bell pepper",
966
+ "946": "cardoon",
967
+ "947": "mushroom",
968
+ "948": "Granny Smith",
969
+ "949": "strawberry",
970
+ "950": "orange",
971
+ "951": "lemon",
972
+ "952": "fig",
973
+ "953": "pineapple, ananas",
974
+ "954": "banana",
975
+ "955": "jackfruit, jak, jack",
976
+ "956": "custard apple",
977
+ "957": "pomegranate",
978
+ "958": "hay",
979
+ "959": "carbonara",
980
+ "960": "chocolate sauce, chocolate syrup",
981
+ "961": "dough",
982
+ "962": "meat loaf, meatloaf",
983
+ "963": "pizza, pizza pie",
984
+ "964": "potpie",
985
+ "965": "burrito",
986
+ "966": "red wine",
987
+ "967": "espresso",
988
+ "968": "cup",
989
+ "969": "eggnog",
990
+ "970": "alp",
991
+ "971": "bubble",
992
+ "972": "cliff, drop, drop-off",
993
+ "973": "coral reef",
994
+ "974": "geyser",
995
+ "975": "lakeside, lakeshore",
996
+ "976": "promontory, headland, head, foreland",
997
+ "977": "sandbar, sand bar",
998
+ "978": "seashore, coast, seacoast, sea-coast",
999
+ "979": "valley, vale",
1000
+ "980": "volcano",
1001
+ "981": "ballplayer, baseball player",
1002
+ "982": "groom, bridegroom",
1003
+ "983": "scuba diver",
1004
+ "984": "rapeseed",
1005
+ "985": "daisy",
1006
+ "986": "yellow ladys slipper, yellow lady-slipper, Cypripedium calceolus, Cypripedium parviflorum",
1007
+ "987": "corn",
1008
+ "988": "acorn",
1009
+ "989": "hip, rose hip, rosehip",
1010
+ "990": "buckeye, horse chestnut, conker",
1011
+ "991": "coral fungus",
1012
+ "992": "agaric",
1013
+ "993": "gyromitra",
1014
+ "994": "stinkhorn, carrion fungus",
1015
+ "995": "earthstar",
1016
+ "996": "hen-of-the-woods, hen of the woods, Polyporus frondosus, Grifola frondosa",
1017
+ "997": "bolete",
1018
+ "998": "ear, spike, capitulum",
1019
+ "999": "toilet tissue, toilet paper, bathroom tissue"
1020
+ }
1021
+ }
DiCo-L-256/pipeline.py ADDED
@@ -0,0 +1,398 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """Hub custom pipeline: DiCoPipeline.
2
+ Load with native Hugging Face diffusers and trust_remote_code=True.
3
+ """
4
+
5
+ # Copyright 2026 The HuggingFace Team. All rights reserved.
6
+ #
7
+ # Licensed under the Apache License, Version 2.0 (the "License");
8
+ # you may not use this file except in compliance with the License.
9
+ # You may obtain a copy of the License at
10
+ #
11
+ # http://www.apache.org/licenses/LICENSE-2.0
12
+ #
13
+ # Unless required by applicable law or agreed to in writing, software
14
+ # distributed under the License is distributed on an "AS IS" BASIS,
15
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16
+ # See the License for the specific language governing permissions and
17
+ # limitations under the License.
18
+
19
+ from __future__ import annotations
20
+
21
+ import inspect
22
+ import json
23
+ from pathlib import Path
24
+ from typing import Dict, List, Optional, Tuple, Union
25
+
26
+ import torch
27
+ from diffusers.image_processor import VaeImageProcessor
28
+ from diffusers.models import AutoencoderKL
29
+ from diffusers.pipelines.pipeline_utils import DiffusionPipeline, ImagePipelineOutput
30
+ from diffusers.schedulers import DDIMScheduler, KarrasDiffusionSchedulers
31
+ from diffusers.utils.torch_utils import randn_tensor
32
+
33
+
34
+ EXAMPLE_DOC_STRING = """
35
+ Examples:
36
+ ```py
37
+ >>> from pathlib import Path
38
+ >>> from diffusers import DiffusionPipeline
39
+ >>> import torch
40
+
41
+ >>> model_dir = Path("./DiCo-XL-256").resolve()
42
+ >>> pipe = DiffusionPipeline.from_pretrained(
43
+ ... str(model_dir),
44
+ ... local_files_only=True,
45
+ ... custom_pipeline=str(model_dir / "pipeline.py"),
46
+ ... trust_remote_code=True,
47
+ ... torch_dtype=torch.bfloat16,
48
+ ... )
49
+ >>> pipe.to("cuda")
50
+
51
+ >>> image = pipe(
52
+ ... class_labels="golden retriever",
53
+ ... num_inference_steps=250,
54
+ ... guidance_scale=1.4,
55
+ ... generator=torch.Generator("cuda").manual_seed(0),
56
+ ... ).images[0]
57
+ ```
58
+ """
59
+
60
+
61
+ class DiCoPipeline(DiffusionPipeline):
62
+ r"""
63
+ Pipeline for class-conditional image generation with DiCo (Diffusion ConvNet).
64
+
65
+ Parameters:
66
+ transformer ([`DiCoTransformer2DModel`]):
67
+ Class-conditional DiCo denoiser operating in VAE latent space.
68
+ vae ([`AutoencoderKL`]):
69
+ Variational autoencoder used to decode latents to pixels.
70
+ scheduler ([`DDIMScheduler`]):
71
+ Diffusion scheduler. Other [`KarrasDiffusionSchedulers`] can be swapped at inference time.
72
+ id2label (`dict[int, str]`, *optional*):
73
+ ImageNet class id to English label mapping. Values may contain comma-separated synonyms.
74
+ """
75
+
76
+ model_cpu_offload_seq = "transformer->vae"
77
+
78
+ @staticmethod
79
+ def prepare_extra_step_kwargs(
80
+ scheduler: KarrasDiffusionSchedulers,
81
+ generator: Optional[Union[torch.Generator, List[torch.Generator]]] = None,
82
+ eta: float = 0.0,
83
+ ) -> Dict[str, object]:
84
+ kwargs: Dict[str, object] = {}
85
+ step_params = set(inspect.signature(scheduler.step).parameters.keys())
86
+ if "generator" in step_params:
87
+ kwargs["generator"] = generator
88
+ if "eta" in step_params:
89
+ kwargs["eta"] = eta
90
+ return kwargs
91
+
92
+ def __init__(
93
+ self,
94
+ transformer,
95
+ vae: AutoencoderKL,
96
+ scheduler: KarrasDiffusionSchedulers,
97
+ id2label: Optional[Dict[Union[int, str], str]] = None,
98
+ ):
99
+ super().__init__()
100
+ if scheduler is None:
101
+ scheduler = DDIMScheduler(
102
+ num_train_timesteps=1000,
103
+ beta_start=0.0001,
104
+ beta_end=0.02,
105
+ beta_schedule="linear",
106
+ clip_sample=False,
107
+ set_alpha_to_one=True,
108
+ steps_offset=0,
109
+ prediction_type="epsilon",
110
+ )
111
+ self.register_modules(transformer=transformer, vae=vae, scheduler=scheduler)
112
+ self.vae_scale_factor = 2 ** (len(self.vae.config.block_out_channels) - 1)
113
+ self.image_processor = VaeImageProcessor(vae_scale_factor=self.vae_scale_factor)
114
+ self._id2label = self._normalize_id2label(id2label)
115
+ self.labels = self._build_label2id(self._id2label)
116
+ self._labels_loaded_from_model_index = bool(self._id2label)
117
+
118
+ @classmethod
119
+ def from_pretrained(cls, pretrained_model_name_or_path: str, **kwargs):
120
+ model_kwargs = dict(kwargs)
121
+ transformer_subfolder = model_kwargs.pop("transformer_subfolder", None)
122
+ scheduler_subfolder = model_kwargs.pop("scheduler_subfolder", None)
123
+ vae_subfolder = model_kwargs.pop("vae_subfolder", None)
124
+ scheduler_kwargs = model_kwargs.pop("scheduler_kwargs", {})
125
+ base_path = Path(pretrained_model_name_or_path)
126
+
127
+ if transformer_subfolder is None and (base_path / "transformer").exists():
128
+ transformer_subfolder = "transformer"
129
+ if scheduler_subfolder is None and (base_path / "scheduler").exists():
130
+ scheduler_subfolder = "scheduler"
131
+ if vae_subfolder is None and (base_path / "vae").exists():
132
+ vae_subfolder = "vae"
133
+
134
+ try:
135
+ return super().from_pretrained(pretrained_model_name_or_path, **kwargs)
136
+ except Exception:
137
+ transformer_path = str(base_path / transformer_subfolder) if transformer_subfolder else pretrained_model_name_or_path
138
+ from transformer.transformer_dico import DiCoTransformer2DModel
139
+ transformer = DiCoTransformer2DModel.from_pretrained(transformer_path, **model_kwargs)
140
+ try:
141
+ scheduler = DDIMScheduler.from_pretrained(
142
+ pretrained_model_name_or_path,
143
+ subfolder=scheduler_subfolder,
144
+ **scheduler_kwargs,
145
+ )
146
+ except Exception:
147
+ scheduler = DDIMScheduler(
148
+ num_train_timesteps=1000,
149
+ beta_start=0.0001,
150
+ beta_end=0.02,
151
+ beta_schedule="linear",
152
+ clip_sample=False,
153
+ set_alpha_to_one=True,
154
+ steps_offset=0,
155
+ prediction_type="epsilon",
156
+ **scheduler_kwargs,
157
+ )
158
+ try:
159
+ vae = AutoencoderKL.from_pretrained(
160
+ pretrained_model_name_or_path,
161
+ subfolder=vae_subfolder,
162
+ **model_kwargs,
163
+ )
164
+ except Exception:
165
+ vae = AutoencoderKL.from_pretrained("stabilityai/sd-vae-ft-ema", **model_kwargs)
166
+ id2label = cls._read_id2label_from_model_index(str(base_path))
167
+ return cls(transformer=transformer, vae=vae, scheduler=scheduler, id2label=id2label)
168
+
169
+ def _ensure_labels_loaded(self) -> None:
170
+ if self._labels_loaded_from_model_index:
171
+ return
172
+ loaded = self._read_id2label_from_model_index(getattr(self.config, "_name_or_path", None))
173
+ if loaded:
174
+ self._id2label = loaded
175
+ self.labels = self._build_label2id(self._id2label)
176
+ self._labels_loaded_from_model_index = True
177
+
178
+ @staticmethod
179
+ def _normalize_id2label(id2label: Optional[Dict[Union[int, str], str]]) -> Dict[int, str]:
180
+ if not id2label:
181
+ return {}
182
+ return {int(key): value for key, value in id2label.items()}
183
+
184
+ @staticmethod
185
+ def _read_id2label_from_model_index(variant_path: Optional[str]) -> Dict[int, str]:
186
+ if not variant_path:
187
+ return {}
188
+ model_index_path = Path(variant_path).resolve() / "model_index.json"
189
+ if not model_index_path.exists():
190
+ return {}
191
+ raw = json.loads(model_index_path.read_text(encoding="utf-8"))
192
+ id2label = raw.get("id2label")
193
+ if not isinstance(id2label, dict):
194
+ return {}
195
+ return {int(key): value for key, value in id2label.items()}
196
+
197
+ @staticmethod
198
+ def _build_label2id(id2label: Dict[int, str]) -> Dict[str, int]:
199
+ label2id: Dict[str, int] = {}
200
+ for class_id, value in id2label.items():
201
+ for synonym in value.split(","):
202
+ synonym = synonym.strip()
203
+ if synonym:
204
+ label2id[synonym] = int(class_id)
205
+ return dict(sorted(label2id.items()))
206
+
207
+ @property
208
+ def id2label(self) -> Dict[int, str]:
209
+ self._ensure_labels_loaded()
210
+ return self._id2label
211
+
212
+ def get_label_ids(self, label: Union[str, List[str]]) -> List[int]:
213
+ self._ensure_labels_loaded()
214
+ if not self.labels:
215
+ raise ValueError("No English labels loaded. Ensure `id2label` exists in model_index.json.")
216
+ if isinstance(label, str):
217
+ label = [label]
218
+ missing = [item for item in label if item not in self.labels]
219
+ if missing:
220
+ preview = ", ".join(list(self.labels.keys())[:8])
221
+ raise ValueError(f"Unknown English label(s): {missing}. Example valid labels: {preview}, ...")
222
+ return [self.labels[item] for item in label]
223
+
224
+ def _normalize_class_labels(
225
+ self,
226
+ class_labels: Union[int, str, List[Union[int, str]], torch.LongTensor],
227
+ ) -> torch.LongTensor:
228
+ if torch.is_tensor(class_labels):
229
+ return class_labels.to(device=self._execution_device, dtype=torch.long).reshape(-1)
230
+ if isinstance(class_labels, int):
231
+ class_label_ids = [class_labels]
232
+ elif isinstance(class_labels, str):
233
+ class_label_ids = self.get_label_ids(class_labels)
234
+ elif class_labels and isinstance(class_labels[0], str):
235
+ class_label_ids = self.get_label_ids(class_labels)
236
+ else:
237
+ class_label_ids = list(class_labels)
238
+ return torch.tensor(class_label_ids, device=self._execution_device, dtype=torch.long).reshape(-1)
239
+
240
+ def _default_image_size(self) -> int:
241
+ return int(self.transformer.config.input_size) * self.vae_scale_factor
242
+
243
+ def check_inputs(
244
+ self,
245
+ height: int,
246
+ width: int,
247
+ num_inference_steps: int,
248
+ output_type: str,
249
+ ) -> None:
250
+ if num_inference_steps < 1:
251
+ raise ValueError("num_inference_steps must be >= 1.")
252
+ if output_type not in {"pil", "np", "pt", "latent"}:
253
+ raise ValueError("output_type must be one of: 'pil', 'np', 'pt', 'latent'.")
254
+ if height % self.vae_scale_factor != 0 or width % self.vae_scale_factor != 0:
255
+ raise ValueError(
256
+ f"height and width must be divisible by the VAE downsample factor {self.vae_scale_factor}."
257
+ )
258
+ latent_height = height // self.vae_scale_factor
259
+ latent_width = width // self.vae_scale_factor
260
+ expected_size = int(self.transformer.config.input_size)
261
+ if latent_height != expected_size or latent_width != expected_size:
262
+ raise ValueError(
263
+ f"Requested latent size {(latent_height, latent_width)} does not match the pretrained "
264
+ f"transformer input_size={expected_size}. Use height=width={self._default_image_size()}."
265
+ )
266
+
267
+ def prepare_latents(
268
+ self,
269
+ batch_size: int,
270
+ height: int,
271
+ width: int,
272
+ dtype: torch.dtype,
273
+ device: torch.device,
274
+ generator: Optional[Union[torch.Generator, List[torch.Generator]]],
275
+ ) -> torch.Tensor:
276
+ latent_height = height // self.vae_scale_factor
277
+ latent_width = width // self.vae_scale_factor
278
+ return randn_tensor(
279
+ (batch_size, self.transformer.config.in_channels, latent_height, latent_width),
280
+ generator=generator,
281
+ device=device,
282
+ dtype=dtype,
283
+ )
284
+
285
+ @staticmethod
286
+ def _expand_timestep(timestep, batch: int, device: torch.device) -> torch.Tensor:
287
+ if not torch.is_tensor(timestep):
288
+ timestep = torch.tensor([timestep], dtype=torch.long, device=device)
289
+ elif timestep.ndim == 0:
290
+ timestep = timestep[None].to(device=device)
291
+ return timestep.expand(batch)
292
+
293
+ @staticmethod
294
+ def _prepare_model_output_for_scheduler(
295
+ model_output: torch.Tensor,
296
+ latent_channels: int,
297
+ scheduler: KarrasDiffusionSchedulers,
298
+ ) -> torch.Tensor:
299
+ if model_output.shape[1] != 2 * latent_channels:
300
+ return model_output
301
+ variance_type = getattr(scheduler.config, "variance_type", None)
302
+ if scheduler.__class__.__name__ == "DDPMScheduler" and variance_type in ("learned", "learned_range"):
303
+ return model_output
304
+ model_output, _ = torch.split(model_output, latent_channels, dim=1)
305
+ return model_output
306
+
307
+ def decode_latents(self, latents: torch.Tensor, output_type: str = "pil"):
308
+ if output_type == "latent":
309
+ return latents
310
+ scaling_factor = getattr(self.vae.config, "scaling_factor", 0.18215)
311
+ image = self.vae.decode(latents / scaling_factor).sample
312
+ if output_type == "pt":
313
+ return image
314
+ return self.image_processor.postprocess(image, output_type=output_type)
315
+
316
+ @torch.inference_mode()
317
+ def __call__(
318
+ self,
319
+ class_labels: Union[int, str, List[Union[int, str]], torch.LongTensor],
320
+ height: Optional[int] = None,
321
+ width: Optional[int] = None,
322
+ num_inference_steps: int = 250,
323
+ guidance_scale: float = 1.0,
324
+ eta: float = 0.0,
325
+ generator: Optional[Union[torch.Generator, List[torch.Generator]]] = None,
326
+ output_type: str = "pil",
327
+ return_dict: bool = True,
328
+ ) -> Union[ImagePipelineOutput, Tuple]:
329
+ default_size = self._default_image_size()
330
+ height = int(height or default_size)
331
+ width = int(width or default_size)
332
+ self.check_inputs(height, width, num_inference_steps, output_type)
333
+
334
+ device = self._execution_device
335
+ model_dtype = next(self.transformer.parameters()).dtype
336
+ class_labels_tensor = self._normalize_class_labels(class_labels)
337
+ batch_size = class_labels_tensor.numel()
338
+ latent_channels = int(self.transformer.config.in_channels)
339
+ null_class_val = int(self.transformer.config.num_classes)
340
+ do_cfg = guidance_scale > 1.0
341
+
342
+ latents = self.prepare_latents(
343
+ batch_size=batch_size,
344
+ height=height,
345
+ width=width,
346
+ dtype=model_dtype,
347
+ device=device,
348
+ generator=generator,
349
+ )
350
+ latent_model_input = torch.cat([latents] * 2) if do_cfg else latents
351
+
352
+ class_labels_input = class_labels_tensor
353
+ if do_cfg:
354
+ class_null = torch.full_like(class_labels_tensor, null_class_val)
355
+ class_labels_input = torch.cat([class_labels_tensor, class_null], dim=0)
356
+
357
+ self.scheduler.set_timesteps(num_inference_steps, device=device)
358
+ extra_step_kwargs = self.prepare_extra_step_kwargs(self.scheduler, generator=generator, eta=eta)
359
+
360
+ for t in self.progress_bar(self.scheduler.timesteps):
361
+ if do_cfg:
362
+ half = latent_model_input[: len(latent_model_input) // 2]
363
+ latent_model_input = torch.cat([half, half], dim=0)
364
+ latent_model_input = self.scheduler.scale_model_input(latent_model_input, t)
365
+ timesteps = self._expand_timestep(t, latent_model_input.shape[0], latent_model_input.device)
366
+
367
+ noise_pred = self.transformer(
368
+ hidden_states=latent_model_input,
369
+ timestep=timesteps,
370
+ class_labels=class_labels_input,
371
+ return_dict=True,
372
+ ).sample
373
+
374
+ if do_cfg:
375
+ eps, rest = noise_pred[:, :latent_channels], noise_pred[:, latent_channels:]
376
+ cond_eps, uncond_eps = torch.split(eps, len(eps) // 2, dim=0)
377
+ half_eps = uncond_eps + guidance_scale * (cond_eps - uncond_eps)
378
+ eps = torch.cat([half_eps, half_eps], dim=0)
379
+ noise_pred = torch.cat([eps, rest], dim=1)
380
+
381
+ model_output = self._prepare_model_output_for_scheduler(noise_pred, latent_channels, self.scheduler)
382
+ latent_model_input = self.scheduler.step(
383
+ model_output, t, latent_model_input, return_dict=True, **extra_step_kwargs
384
+ ).prev_sample
385
+
386
+ if do_cfg:
387
+ latents, _ = latent_model_input.chunk(2, dim=0)
388
+ else:
389
+ latents = latent_model_input
390
+
391
+ image = self.decode_latents(latents, output_type=output_type)
392
+ self.maybe_free_model_hooks()
393
+ if not return_dict:
394
+ return (image,)
395
+ return ImagePipelineOutput(images=image)
396
+
397
+
398
+ DiCoPipelineOutput = ImagePipelineOutput
DiCo-L-256/scheduler/scheduler_config.json ADDED
@@ -0,0 +1,12 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "_class_name": "DDIMScheduler",
3
+ "_diffusers_version": "0.35.1",
4
+ "num_train_timesteps": 1000,
5
+ "beta_start": 0.0001,
6
+ "beta_end": 0.02,
7
+ "beta_schedule": "linear",
8
+ "clip_sample": false,
9
+ "set_alpha_to_one": true,
10
+ "steps_offset": 0,
11
+ "prediction_type": "epsilon"
12
+ }
DiCo-L-256/transformer/config.json ADDED
@@ -0,0 +1,14 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "_class_name": "DiCoTransformer2DModel",
3
+ "_diffusers_version": "0.38.0",
4
+ "class_dropout_prob": 0.1,
5
+ "depth": null,
6
+ "hidden_size": 416,
7
+ "in_channels": 4,
8
+ "input_size": 32,
9
+ "learn_sigma": true,
10
+ "mlp_ratio": 2.0,
11
+ "model_type": "DiCo-L",
12
+ "num_class_embeds": null,
13
+ "num_classes": 1000
14
+ }
DiCo-L-256/transformer/diffusion_pytorch_model.safetensors ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:b7469911f0c5515536c89563c0f48110466d4c02fcdc9775ab73d4b14151ae6a
3
+ size 1855656952
DiCo-L-256/transformer/transformer_dico.py ADDED
@@ -0,0 +1,479 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Copyright 2026 The HuggingFace Team. All rights reserved.
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ from __future__ import annotations
16
+
17
+ import argparse
18
+ import math
19
+ from collections.abc import Mapping
20
+ from typing import Dict, Literal, Optional, Tuple
21
+
22
+ import torch
23
+ import torch.nn as nn
24
+ import torch.nn.functional as F
25
+
26
+ from diffusers.configuration_utils import ConfigMixin, register_to_config
27
+ from diffusers.models.modeling_outputs import Transformer2DModelOutput
28
+ from diffusers.models.modeling_utils import ModelMixin
29
+
30
+
31
+ DICO_PRESET_CONFIGS: Dict[str, Dict[str, object]] = {
32
+ "DiCo-S": {
33
+ "hidden_size": 128,
34
+ "depth": [5, 4, 4, 4, 4],
35
+ "mlp_ratio": 2.0,
36
+ },
37
+ "DiCo-B": {
38
+ "hidden_size": 256,
39
+ "depth": [5, 4, 4, 4, 4],
40
+ "mlp_ratio": 2.0,
41
+ },
42
+ "DiCo-L": {
43
+ "hidden_size": 352,
44
+ "depth": [9, 8, 9, 8, 9],
45
+ "mlp_ratio": 2.0,
46
+ },
47
+ "DiCo-XL": {
48
+ "hidden_size": 416,
49
+ "depth": [9, 9, 10, 9, 9],
50
+ "mlp_ratio": 2.0,
51
+ },
52
+ "DiCo-H": {
53
+ "hidden_size": 416,
54
+ "depth": [14, 12, 10, 12, 14],
55
+ "mlp_ratio": 4.0,
56
+ },
57
+ }
58
+
59
+
60
+ def remap_legacy_state_dict(state_dict: Dict[str, torch.Tensor]) -> Dict[str, torch.Tensor]:
61
+ """Map wrapper/backbone keys from legacy checkpoints to native model keys."""
62
+ remapped: Dict[str, torch.Tensor] = {}
63
+ for key, value in state_dict.items():
64
+ new_key = key
65
+ for prefix in ("transformer.", "model.", "net."):
66
+ if new_key.startswith(prefix):
67
+ new_key = new_key[len(prefix) :]
68
+ break
69
+ remapped[new_key] = value
70
+ return remapped
71
+
72
+
73
+ def infer_learn_sigma(state_dict: Dict[str, torch.Tensor], in_channels: int = 4) -> bool:
74
+ weight = state_dict.get("final_layer.out_proj.weight")
75
+ if weight is None:
76
+ return True
77
+ return int(weight.shape[0]) == in_channels * 2
78
+
79
+
80
+ def config_from_legacy(config: Dict[str, object]) -> Dict[str, object]:
81
+ """Build native config kwargs from a legacy config.json dict."""
82
+ model_type = config.get("model_type") or config.get("model_name") or config.get("model")
83
+ if model_type not in DICO_PRESET_CONFIGS:
84
+ raise ValueError(f"Unknown DiCo preset '{model_type}'. Known: {list(DICO_PRESET_CONFIGS)}")
85
+
86
+ preset = dict(DICO_PRESET_CONFIGS[model_type])
87
+ preset["num_classes"] = int(config.get("num_class_embeds") or config.get("num_classes") or 1000)
88
+ preset["model_type"] = model_type
89
+ preset["input_size"] = int(config.get("input_size") or config.get("sample_size") or 32)
90
+ if config.get("learn_sigma") is not None:
91
+ preset["learn_sigma"] = bool(config["learn_sigma"])
92
+ return preset
93
+
94
+
95
+ def modulate(x: torch.Tensor, shift: torch.Tensor, scale: torch.Tensor) -> torch.Tensor:
96
+ return x * (1 + scale.unsqueeze(-1).unsqueeze(-1)) + shift.unsqueeze(-1).unsqueeze(-1)
97
+
98
+
99
+ class LayerNorm2d(nn.LayerNorm):
100
+ def __init__(self, num_channels: int, eps: float = 1e-6, affine: bool = True):
101
+ super().__init__(num_channels, eps=eps, elementwise_affine=affine)
102
+
103
+ def forward(self, x: torch.Tensor) -> torch.Tensor:
104
+ x = x.permute(0, 2, 3, 1)
105
+ x = F.layer_norm(x, self.normalized_shape, self.weight, self.bias, self.eps)
106
+ return x.permute(0, 3, 1, 2)
107
+
108
+
109
+ class DiCoTimestepEmbedder(nn.Module):
110
+ def __init__(self, hidden_size: int, frequency_embedding_size: int = 256):
111
+ super().__init__()
112
+ self.mlp = nn.Sequential(
113
+ nn.Linear(frequency_embedding_size, hidden_size, bias=True),
114
+ nn.SiLU(),
115
+ nn.Linear(hidden_size, hidden_size, bias=True),
116
+ )
117
+ self.frequency_embedding_size = frequency_embedding_size
118
+
119
+ @staticmethod
120
+ def timestep_embedding(t: torch.Tensor, dim: int, max_period: int = 10000) -> torch.Tensor:
121
+ half = dim // 2
122
+ freqs = torch.exp(
123
+ -math.log(max_period) * torch.arange(start=0, end=half, dtype=torch.float32) / half
124
+ ).to(device=t.device)
125
+ args = t[:, None].float() * freqs[None]
126
+ embedding = torch.cat([torch.cos(args), torch.sin(args)], dim=-1)
127
+ if dim % 2:
128
+ embedding = torch.cat([embedding, torch.zeros_like(embedding[:, :1])], dim=-1)
129
+ return embedding
130
+
131
+ def forward(self, t: torch.Tensor) -> torch.Tensor:
132
+ t_freq = self.timestep_embedding(t, self.frequency_embedding_size)
133
+ weight_dtype = self.mlp[0].weight.dtype
134
+ return self.mlp(t_freq.to(dtype=weight_dtype))
135
+
136
+
137
+ class DiCoLabelEmbedder(nn.Module):
138
+ def __init__(self, num_classes: int, hidden_size: int, dropout_prob: float):
139
+ super().__init__()
140
+ use_cfg_embedding = dropout_prob > 0
141
+ self.embedding_table = nn.Embedding(num_classes + use_cfg_embedding, hidden_size)
142
+ self.num_classes = num_classes
143
+ self.dropout_prob = dropout_prob
144
+
145
+ def token_drop(self, labels: torch.Tensor, force_drop_ids: Optional[torch.Tensor] = None) -> torch.Tensor:
146
+ if force_drop_ids is None:
147
+ drop_ids = torch.rand(labels.shape[0], device=labels.device) < self.dropout_prob
148
+ else:
149
+ drop_ids = force_drop_ids == 1
150
+ return torch.where(drop_ids, self.num_classes, labels)
151
+
152
+ def forward(
153
+ self,
154
+ labels: torch.Tensor,
155
+ train: bool,
156
+ force_drop_ids: Optional[torch.Tensor] = None,
157
+ ) -> torch.Tensor:
158
+ use_dropout = self.dropout_prob > 0
159
+ if (train and use_dropout) or (force_drop_ids is not None):
160
+ labels = self.token_drop(labels, force_drop_ids)
161
+ return self.embedding_table(labels)
162
+
163
+
164
+ class DiCoMultiScaleLabelEmbedder(nn.Module):
165
+ def __init__(
166
+ self,
167
+ num_classes: int,
168
+ hidden_size_0: int,
169
+ hidden_size_1: int,
170
+ hidden_size_2: int,
171
+ dropout_prob: float,
172
+ ):
173
+ super().__init__()
174
+ use_cfg_embedding = dropout_prob > 0
175
+ self.embedding_table_0 = nn.Embedding(num_classes + use_cfg_embedding, hidden_size_0)
176
+ self.embedding_table_1 = nn.Embedding(num_classes + use_cfg_embedding, hidden_size_1)
177
+ self.embedding_table_2 = nn.Embedding(num_classes + use_cfg_embedding, hidden_size_2)
178
+ self.num_classes = num_classes
179
+ self.dropout_prob = dropout_prob
180
+
181
+ def token_drop(self, labels: torch.Tensor, force_drop_ids: Optional[torch.Tensor] = None) -> torch.Tensor:
182
+ if force_drop_ids is None:
183
+ drop_ids = torch.rand(labels.shape[0], device=labels.device) < self.dropout_prob
184
+ else:
185
+ drop_ids = force_drop_ids == 1
186
+ return torch.where(drop_ids, self.num_classes, labels)
187
+
188
+ def forward(
189
+ self,
190
+ labels: torch.Tensor,
191
+ train: bool,
192
+ force_drop_ids: Optional[torch.Tensor] = None,
193
+ ) -> Tuple[torch.Tensor, torch.Tensor, torch.Tensor]:
194
+ use_dropout = self.dropout_prob > 0
195
+ if (train and use_dropout) or (force_drop_ids is not None):
196
+ labels = self.token_drop(labels, force_drop_ids)
197
+ return (
198
+ self.embedding_table_0(labels),
199
+ self.embedding_table_1(labels),
200
+ self.embedding_table_2(labels),
201
+ )
202
+
203
+
204
+ class DiCoBlock(nn.Module):
205
+ def __init__(self, hidden_size: int, mlp_ratio: float = 4.0):
206
+ super().__init__()
207
+ self.conv1 = nn.Conv2d(hidden_size, hidden_size, kernel_size=1, padding=0, stride=1, groups=1, bias=True)
208
+ self.conv2 = nn.Conv2d(
209
+ hidden_size, hidden_size, kernel_size=3, padding=1, stride=1, groups=hidden_size, bias=True
210
+ )
211
+ self.conv3 = nn.Conv2d(hidden_size, hidden_size, kernel_size=1, padding=0, stride=1, groups=1, bias=True)
212
+ self.ca = nn.Sequential(
213
+ nn.AdaptiveAvgPool2d(1),
214
+ nn.Conv2d(hidden_size, hidden_size, kernel_size=1, padding=0, stride=1, groups=1, bias=True),
215
+ nn.Sigmoid(),
216
+ )
217
+ ffn_channel = int(mlp_ratio * hidden_size)
218
+ self.conv4 = nn.Conv2d(hidden_size, ffn_channel, kernel_size=1, padding=0, stride=1, groups=1, bias=True)
219
+ self.conv5 = nn.Conv2d(ffn_channel, hidden_size, kernel_size=1, padding=0, stride=1, groups=1, bias=True)
220
+ self.norm1 = LayerNorm2d(hidden_size, affine=False, eps=1e-6)
221
+ self.norm2 = LayerNorm2d(hidden_size, affine=False, eps=1e-6)
222
+ self.adaLN_modulation = nn.Sequential(nn.SiLU(), nn.Linear(hidden_size, 6 * hidden_size, bias=True))
223
+
224
+ def forward(self, inp: torch.Tensor, c: torch.Tensor) -> torch.Tensor:
225
+ shift_msa, scale_msa, gate_msa, shift_mlp, scale_mlp, gate_mlp = self.adaLN_modulation(c).chunk(6, dim=1)
226
+ x = modulate(self.norm1(inp), shift_msa, scale_msa)
227
+ x = F.gelu(self.conv2(self.conv1(x)))
228
+ x = x * self.ca(x)
229
+ x = self.conv3(x)
230
+ x = inp + gate_msa.unsqueeze(-1).unsqueeze(-1) * x
231
+ x = x + gate_mlp.unsqueeze(-1).unsqueeze(-1) * self.conv5(
232
+ F.gelu(self.conv4(modulate(self.norm2(x), shift_mlp, scale_mlp)))
233
+ )
234
+ return x
235
+
236
+
237
+ class DiCoFinalLayer(nn.Module):
238
+ def __init__(self, hidden_size: int, out_channels: int):
239
+ super().__init__()
240
+ self.norm_final = LayerNorm2d(hidden_size, affine=False, eps=1e-6)
241
+ self.out_proj = nn.Conv2d(hidden_size, out_channels, kernel_size=3, stride=1, padding=1, bias=True)
242
+ self.adaLN_modulation = nn.Sequential(nn.SiLU(), nn.Linear(hidden_size, 2 * hidden_size, bias=True))
243
+
244
+ def forward(self, x: torch.Tensor, c: torch.Tensor) -> torch.Tensor:
245
+ shift, scale = self.adaLN_modulation(c).chunk(2, dim=1)
246
+ x = modulate(self.norm_final(x), shift, scale)
247
+ return self.out_proj(x)
248
+
249
+
250
+ class OverlapPatchEmbed(nn.Module):
251
+ def __init__(self, in_c: int = 3, embed_dim: int = 48, bias: bool = False):
252
+ super().__init__()
253
+ self.proj = nn.Conv2d(in_c, embed_dim, kernel_size=3, stride=1, padding=1, bias=bias)
254
+
255
+ def forward(self, x: torch.Tensor) -> torch.Tensor:
256
+ return self.proj(x)
257
+
258
+
259
+ class Downsample(nn.Module):
260
+ def __init__(self, n_feat: int):
261
+ super().__init__()
262
+ self.body = nn.Sequential(
263
+ nn.Conv2d(n_feat, n_feat // 2, kernel_size=3, stride=1, padding=1, bias=False),
264
+ nn.PixelUnshuffle(2),
265
+ )
266
+
267
+ def forward(self, x: torch.Tensor) -> torch.Tensor:
268
+ return self.body(x)
269
+
270
+
271
+ class Upsample(nn.Module):
272
+ def __init__(self, n_feat: int):
273
+ super().__init__()
274
+ self.body = nn.Sequential(
275
+ nn.Conv2d(n_feat, n_feat * 2, kernel_size=3, stride=1, padding=1, bias=False),
276
+ nn.PixelShuffle(2),
277
+ )
278
+
279
+ def forward(self, x: torch.Tensor) -> torch.Tensor:
280
+ return self.body(x)
281
+
282
+
283
+ class DiCoTransformer2DModel(ModelMixin, ConfigMixin):
284
+ r"""
285
+ DiCo (Diffusion ConvNet) denoiser for class-conditional latent diffusion.
286
+
287
+ ConvNet U-Net backbone with multi-scale adaLN conditioning, operating on VAE latents.
288
+ """
289
+
290
+ _supports_gradient_checkpointing = True
291
+
292
+ @register_to_config
293
+ def __init__(
294
+ self,
295
+ input_size: int = 32,
296
+ in_channels: int = 4,
297
+ hidden_size: int = 416,
298
+ depth: Optional[list[int]] = None,
299
+ mlp_ratio: float = 2.0,
300
+ class_dropout_prob: float = 0.1,
301
+ num_classes: int = 1000,
302
+ learn_sigma: bool = True,
303
+ model_type: str | None = None,
304
+ num_class_embeds: int | None = None,
305
+ ):
306
+ super().__init__()
307
+ if num_class_embeds is not None:
308
+ num_classes = int(num_class_embeds)
309
+ if model_type in DICO_PRESET_CONFIGS:
310
+ preset = DICO_PRESET_CONFIGS[model_type]
311
+ hidden_size = int(preset["hidden_size"])
312
+ depth = list(preset["depth"])
313
+ mlp_ratio = float(preset["mlp_ratio"])
314
+
315
+ if depth is None:
316
+ depth = [9, 9, 10, 9, 9]
317
+
318
+ self.learn_sigma = learn_sigma
319
+ self.in_channels = in_channels
320
+ self.out_channels = in_channels * 2 if learn_sigma else in_channels
321
+ self.num_classes = num_classes
322
+ self.gradient_checkpointing = False
323
+
324
+ self.x_embedder = OverlapPatchEmbed(in_channels, hidden_size, bias=True)
325
+ self.t_embedder_1 = DiCoTimestepEmbedder(hidden_size)
326
+ self.y_embedder = DiCoMultiScaleLabelEmbedder(
327
+ num_classes, hidden_size, hidden_size * 2, hidden_size * 4, class_dropout_prob
328
+ )
329
+ self.t_embedder_2 = DiCoTimestepEmbedder(hidden_size * 2)
330
+ self.t_embedder_3 = DiCoTimestepEmbedder(hidden_size * 4)
331
+
332
+ self.encoder_level_1 = nn.ModuleList([DiCoBlock(hidden_size, mlp_ratio) for _ in range(depth[0])])
333
+ self.down1_2 = Downsample(hidden_size)
334
+ self.encoder_level_2 = nn.ModuleList([DiCoBlock(hidden_size * 2, mlp_ratio) for _ in range(depth[1])])
335
+ self.down2_3 = Downsample(hidden_size * 2)
336
+ self.latent = nn.ModuleList([DiCoBlock(hidden_size * 4, mlp_ratio) for _ in range(depth[2])])
337
+ self.up3_2 = Upsample(int(hidden_size * 4))
338
+ self.reduce_chan_level2 = nn.Conv2d(int(hidden_size * 4), int(hidden_size * 2), kernel_size=1, bias=True)
339
+ self.decoder_level_2 = nn.ModuleList([DiCoBlock(hidden_size * 2, mlp_ratio) for _ in range(depth[3])])
340
+ self.up2_1 = Upsample(int(hidden_size * 2))
341
+ self.reduce_chan_level1 = nn.Conv2d(int(hidden_size * 2), int(hidden_size * 2), kernel_size=1, bias=True)
342
+ self.decoder_level_1 = nn.ModuleList([DiCoBlock(hidden_size * 2, mlp_ratio) for _ in range(depth[4])])
343
+ self.final_layer = DiCoFinalLayer(hidden_size * 2, self.out_channels)
344
+ self.initialize_weights()
345
+
346
+ def initialize_weights(self) -> None:
347
+ def _basic_init(module: nn.Module):
348
+ if isinstance(module, (nn.Linear, nn.Conv2d)):
349
+ torch.nn.init.xavier_uniform_(module.weight)
350
+ if module.bias is not None:
351
+ nn.init.constant_(module.bias, 0)
352
+
353
+ self.apply(_basic_init)
354
+ w = self.x_embedder.proj.weight.data
355
+ nn.init.xavier_uniform_(w.view([w.shape[0], -1]))
356
+ nn.init.constant_(self.x_embedder.proj.bias, 0)
357
+ nn.init.normal_(self.y_embedder.embedding_table_0.weight, std=0.02)
358
+ nn.init.normal_(self.y_embedder.embedding_table_1.weight, std=0.02)
359
+ nn.init.normal_(self.y_embedder.embedding_table_2.weight, std=0.02)
360
+ for embedder in (self.t_embedder_1, self.t_embedder_2, self.t_embedder_3):
361
+ nn.init.normal_(embedder.mlp[0].weight, std=0.02)
362
+ nn.init.normal_(embedder.mlp[2].weight, std=0.02)
363
+
364
+ blocks = (
365
+ self.encoder_level_1
366
+ + self.encoder_level_2
367
+ + self.latent
368
+ + self.decoder_level_2
369
+ + self.decoder_level_1
370
+ )
371
+ for block in blocks:
372
+ nn.init.constant_(block.adaLN_modulation[-1].weight, 0)
373
+ nn.init.constant_(block.adaLN_modulation[-1].bias, 0)
374
+ nn.init.constant_(self.final_layer.adaLN_modulation[-1].weight, 0)
375
+ nn.init.constant_(self.final_layer.adaLN_modulation[-1].bias, 0)
376
+ nn.init.constant_(self.final_layer.out_proj.weight, 0)
377
+ nn.init.constant_(self.final_layer.out_proj.bias, 0)
378
+
379
+ def _run_block(self, block: DiCoBlock, x: torch.Tensor, c: torch.Tensor) -> torch.Tensor:
380
+ if self.training and self.gradient_checkpointing:
381
+ return torch.utils.checkpoint.checkpoint(block, x, c, use_reentrant=False)
382
+ return block(x, c)
383
+
384
+ def forward(
385
+ self,
386
+ hidden_states: torch.Tensor,
387
+ timestep: torch.LongTensor,
388
+ class_labels: torch.LongTensor,
389
+ force_drop_ids: Optional[torch.Tensor] = None,
390
+ return_dict: bool = True,
391
+ ) -> Transformer2DModelOutput | Tuple:
392
+ timestep = torch.as_tensor(timestep, device=hidden_states.device)
393
+ if timestep.ndim == 0:
394
+ timestep = timestep.repeat(hidden_states.shape[0])
395
+ else:
396
+ timestep = timestep.reshape(-1)
397
+ if timestep.shape[0] == 1 and hidden_states.shape[0] > 1:
398
+ timestep = timestep.repeat(hidden_states.shape[0])
399
+
400
+ x = self.x_embedder(hidden_states)
401
+ t1 = self.t_embedder_1(timestep)
402
+ y1, y2, y3 = self.y_embedder(class_labels, self.training, force_drop_ids=force_drop_ids)
403
+ c1 = t1 + y1
404
+ c2 = self.t_embedder_2(timestep) + y2
405
+ c3 = self.t_embedder_3(timestep) + y3
406
+
407
+ out_enc_level1 = x
408
+ for block in self.encoder_level_1:
409
+ out_enc_level1 = self._run_block(block, out_enc_level1, c1)
410
+ out_enc_level2 = self.down1_2(out_enc_level1)
411
+ for block in self.encoder_level_2:
412
+ out_enc_level2 = self._run_block(block, out_enc_level2, c2)
413
+ latent = self.down2_3(out_enc_level2)
414
+ for block in self.latent:
415
+ latent = self._run_block(block, latent, c3)
416
+
417
+ inp_dec_level2 = self.reduce_chan_level2(torch.cat([self.up3_2(latent), out_enc_level2], dim=1))
418
+ for block in self.decoder_level_2:
419
+ inp_dec_level2 = self._run_block(block, inp_dec_level2, c2)
420
+ inp_dec_level1 = self.reduce_chan_level1(torch.cat([self.up2_1(inp_dec_level2), out_enc_level1], dim=1))
421
+ for block in self.decoder_level_1:
422
+ inp_dec_level1 = self._run_block(block, inp_dec_level1, c2)
423
+
424
+ output = self.final_layer(inp_dec_level1, c2)
425
+ if not return_dict:
426
+ return (output,)
427
+ return Transformer2DModelOutput(sample=output)
428
+
429
+ @classmethod
430
+ def from_dico_checkpoint(
431
+ cls,
432
+ checkpoint_path: str,
433
+ weights: Literal["model", "ema"] = "ema",
434
+ map_location: str = "cpu",
435
+ strict: bool = True,
436
+ model_type: str | None = None,
437
+ ) -> Tuple["DiCoTransformer2DModel", Dict[str, object]]:
438
+ checkpoint = torch.load(checkpoint_path, map_location=map_location, weights_only=False)
439
+ state_dict = checkpoint
440
+ if isinstance(checkpoint, Mapping):
441
+ if weights in checkpoint:
442
+ state_dict = checkpoint[weights]
443
+ elif "state_dict" in checkpoint:
444
+ state_dict = checkpoint["state_dict"]
445
+
446
+ state_dict = remap_legacy_state_dict(state_dict)
447
+
448
+ ckpt_args = checkpoint.get("args") if isinstance(checkpoint, Mapping) else None
449
+ args_dict: Dict[str, object] = {}
450
+ if ckpt_args is not None:
451
+ if isinstance(ckpt_args, argparse.Namespace):
452
+ args_dict = vars(ckpt_args)
453
+ elif isinstance(ckpt_args, Mapping):
454
+ args_dict = dict(ckpt_args)
455
+
456
+ resolved_model_type = model_type or args_dict.get("model") or args_dict.get("model_type")
457
+ image_size = int(args_dict.get("image_size") or 256)
458
+ num_classes = int(args_dict.get("num_classes") or 1000)
459
+
460
+ config: Dict[str, object] = {
461
+ "input_size": image_size // 8,
462
+ "num_classes": num_classes,
463
+ "learn_sigma": infer_learn_sigma(state_dict),
464
+ }
465
+ if resolved_model_type in DICO_PRESET_CONFIGS:
466
+ config["model_type"] = resolved_model_type
467
+
468
+ model = cls(**config)
469
+ model.load_state_dict(state_dict, strict=strict)
470
+ metadata = {
471
+ "checkpoint_path": checkpoint_path,
472
+ "weights": weights,
473
+ "model_type": resolved_model_type,
474
+ "source_args": ckpt_args,
475
+ }
476
+ return model, metadata
477
+
478
+
479
+ DiCoDiffusersModel = DiCoTransformer2DModel
DiCo-L-256/vae/config.json ADDED
@@ -0,0 +1,38 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "_class_name": "AutoencoderKL",
3
+ "_diffusers_version": "0.38.0",
4
+ "_name_or_path": "stabilityai/sd-vae-ft-ema",
5
+ "act_fn": "silu",
6
+ "block_out_channels": [
7
+ 128,
8
+ 256,
9
+ 512,
10
+ 512
11
+ ],
12
+ "down_block_types": [
13
+ "DownEncoderBlock2D",
14
+ "DownEncoderBlock2D",
15
+ "DownEncoderBlock2D",
16
+ "DownEncoderBlock2D"
17
+ ],
18
+ "force_upcast": true,
19
+ "in_channels": 3,
20
+ "latent_channels": 4,
21
+ "latents_mean": null,
22
+ "latents_std": null,
23
+ "layers_per_block": 2,
24
+ "mid_block_add_attention": true,
25
+ "norm_num_groups": 32,
26
+ "out_channels": 3,
27
+ "sample_size": 256,
28
+ "scaling_factor": 0.18215,
29
+ "shift_factor": null,
30
+ "up_block_types": [
31
+ "UpDecoderBlock2D",
32
+ "UpDecoderBlock2D",
33
+ "UpDecoderBlock2D",
34
+ "UpDecoderBlock2D"
35
+ ],
36
+ "use_post_quant_conv": true,
37
+ "use_quant_conv": true
38
+ }
DiCo-L-256/vae/diffusion_pytorch_model.safetensors ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:703abdcd7c389316b5128faa9b750a530ea1680b453170b27afebac5e4db30c4
3
+ size 334643268
DiCo-S-256/model_index.json ADDED
@@ -0,0 +1,1021 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "_class_name": [
3
+ "pipeline",
4
+ "DiCoPipeline"
5
+ ],
6
+ "_diffusers_version": "0.38.0",
7
+ "scheduler": [
8
+ "diffusers",
9
+ "DDIMScheduler"
10
+ ],
11
+ "transformer": [
12
+ "transformer_dico",
13
+ "DiCoTransformer2DModel"
14
+ ],
15
+ "vae": [
16
+ "diffusers",
17
+ "AutoencoderKL"
18
+ ],
19
+ "id2label": {
20
+ "0": "tench, Tinca tinca",
21
+ "1": "goldfish, Carassius auratus",
22
+ "2": "great white shark, white shark, man-eater, man-eating shark, Carcharodon carcharias",
23
+ "3": "tiger shark, Galeocerdo cuvieri",
24
+ "4": "hammerhead, hammerhead shark",
25
+ "5": "electric ray, crampfish, numbfish, torpedo",
26
+ "6": "stingray",
27
+ "7": "cock",
28
+ "8": "hen",
29
+ "9": "ostrich, Struthio camelus",
30
+ "10": "brambling, Fringilla montifringilla",
31
+ "11": "goldfinch, Carduelis carduelis",
32
+ "12": "house finch, linnet, Carpodacus mexicanus",
33
+ "13": "junco, snowbird",
34
+ "14": "indigo bunting, indigo finch, indigo bird, Passerina cyanea",
35
+ "15": "robin, American robin, Turdus migratorius",
36
+ "16": "bulbul",
37
+ "17": "jay",
38
+ "18": "magpie",
39
+ "19": "chickadee",
40
+ "20": "water ouzel, dipper",
41
+ "21": "kite",
42
+ "22": "bald eagle, American eagle, Haliaeetus leucocephalus",
43
+ "23": "vulture",
44
+ "24": "great grey owl, great gray owl, Strix nebulosa",
45
+ "25": "European fire salamander, Salamandra salamandra",
46
+ "26": "common newt, Triturus vulgaris",
47
+ "27": "eft",
48
+ "28": "spotted salamander, Ambystoma maculatum",
49
+ "29": "axolotl, mud puppy, Ambystoma mexicanum",
50
+ "30": "bullfrog, Rana catesbeiana",
51
+ "31": "tree frog, tree-frog",
52
+ "32": "tailed frog, bell toad, ribbed toad, tailed toad, Ascaphus trui",
53
+ "33": "loggerhead, loggerhead turtle, Caretta caretta",
54
+ "34": "leatherback turtle, leatherback, leathery turtle, Dermochelys coriacea",
55
+ "35": "mud turtle",
56
+ "36": "terrapin",
57
+ "37": "box turtle, box tortoise",
58
+ "38": "banded gecko",
59
+ "39": "common iguana, iguana, Iguana iguana",
60
+ "40": "American chameleon, anole, Anolis carolinensis",
61
+ "41": "whiptail, whiptail lizard",
62
+ "42": "agama",
63
+ "43": "frilled lizard, Chlamydosaurus kingi",
64
+ "44": "alligator lizard",
65
+ "45": "Gila monster, Heloderma suspectum",
66
+ "46": "green lizard, Lacerta viridis",
67
+ "47": "African chameleon, Chamaeleo chamaeleon",
68
+ "48": "Komodo dragon, Komodo lizard, dragon lizard, giant lizard, Varanus komodoensis",
69
+ "49": "African crocodile, Nile crocodile, Crocodylus niloticus",
70
+ "50": "American alligator, Alligator mississipiensis",
71
+ "51": "triceratops",
72
+ "52": "thunder snake, worm snake, Carphophis amoenus",
73
+ "53": "ringneck snake, ring-necked snake, ring snake",
74
+ "54": "hognose snake, puff adder, sand viper",
75
+ "55": "green snake, grass snake",
76
+ "56": "king snake, kingsnake",
77
+ "57": "garter snake, grass snake",
78
+ "58": "water snake",
79
+ "59": "vine snake",
80
+ "60": "night snake, Hypsiglena torquata",
81
+ "61": "boa constrictor, Constrictor constrictor",
82
+ "62": "rock python, rock snake, Python sebae",
83
+ "63": "Indian cobra, Naja naja",
84
+ "64": "green mamba",
85
+ "65": "sea snake",
86
+ "66": "horned viper, cerastes, sand viper, horned asp, Cerastes cornutus",
87
+ "67": "diamondback, diamondback rattlesnake, Crotalus adamanteus",
88
+ "68": "sidewinder, horned rattlesnake, Crotalus cerastes",
89
+ "69": "trilobite",
90
+ "70": "harvestman, daddy longlegs, Phalangium opilio",
91
+ "71": "scorpion",
92
+ "72": "black and gold garden spider, Argiope aurantia",
93
+ "73": "barn spider, Araneus cavaticus",
94
+ "74": "garden spider, Aranea diademata",
95
+ "75": "black widow, Latrodectus mactans",
96
+ "76": "tarantula",
97
+ "77": "wolf spider, hunting spider",
98
+ "78": "tick",
99
+ "79": "centipede",
100
+ "80": "black grouse",
101
+ "81": "ptarmigan",
102
+ "82": "ruffed grouse, partridge, Bonasa umbellus",
103
+ "83": "prairie chicken, prairie grouse, prairie fowl",
104
+ "84": "peacock",
105
+ "85": "quail",
106
+ "86": "partridge",
107
+ "87": "African grey, African gray, Psittacus erithacus",
108
+ "88": "macaw",
109
+ "89": "sulphur-crested cockatoo, Kakatoe galerita, Cacatua galerita",
110
+ "90": "lorikeet",
111
+ "91": "coucal",
112
+ "92": "bee eater",
113
+ "93": "hornbill",
114
+ "94": "hummingbird",
115
+ "95": "jacamar",
116
+ "96": "toucan",
117
+ "97": "drake",
118
+ "98": "red-breasted merganser, Mergus serrator",
119
+ "99": "goose",
120
+ "100": "black swan, Cygnus atratus",
121
+ "101": "tusker",
122
+ "102": "echidna, spiny anteater, anteater",
123
+ "103": "platypus, duckbill, duckbilled platypus, duck-billed platypus, Ornithorhynchus anatinus",
124
+ "104": "wallaby, brush kangaroo",
125
+ "105": "koala, koala bear, kangaroo bear, native bear, Phascolarctos cinereus",
126
+ "106": "wombat",
127
+ "107": "jellyfish",
128
+ "108": "sea anemone, anemone",
129
+ "109": "brain coral",
130
+ "110": "flatworm, platyhelminth",
131
+ "111": "nematode, nematode worm, roundworm",
132
+ "112": "conch",
133
+ "113": "snail",
134
+ "114": "slug",
135
+ "115": "sea slug, nudibranch",
136
+ "116": "chiton, coat-of-mail shell, sea cradle, polyplacophore",
137
+ "117": "chambered nautilus, pearly nautilus, nautilus",
138
+ "118": "Dungeness crab, Cancer magister",
139
+ "119": "rock crab, Cancer irroratus",
140
+ "120": "fiddler crab",
141
+ "121": "king crab, Alaska crab, Alaskan king crab, Alaska king crab, Paralithodes camtschatica",
142
+ "122": "American lobster, Northern lobster, Maine lobster, Homarus americanus",
143
+ "123": "spiny lobster, langouste, rock lobster, crawfish, crayfish, sea crawfish",
144
+ "124": "crayfish, crawfish, crawdad, crawdaddy",
145
+ "125": "hermit crab",
146
+ "126": "isopod",
147
+ "127": "white stork, Ciconia ciconia",
148
+ "128": "black stork, Ciconia nigra",
149
+ "129": "spoonbill",
150
+ "130": "flamingo",
151
+ "131": "little blue heron, Egretta caerulea",
152
+ "132": "American egret, great white heron, Egretta albus",
153
+ "133": "bittern",
154
+ "134": "crane",
155
+ "135": "limpkin, Aramus pictus",
156
+ "136": "European gallinule, Porphyrio porphyrio",
157
+ "137": "American coot, marsh hen, mud hen, water hen, Fulica americana",
158
+ "138": "bustard",
159
+ "139": "ruddy turnstone, Arenaria interpres",
160
+ "140": "red-backed sandpiper, dunlin, Erolia alpina",
161
+ "141": "redshank, Tringa totanus",
162
+ "142": "dowitcher",
163
+ "143": "oystercatcher, oyster catcher",
164
+ "144": "pelican",
165
+ "145": "king penguin, Aptenodytes patagonica",
166
+ "146": "albatross, mollymawk",
167
+ "147": "grey whale, gray whale, devilfish, Eschrichtius gibbosus, Eschrichtius robustus",
168
+ "148": "killer whale, killer, orca, grampus, sea wolf, Orcinus orca",
169
+ "149": "dugong, Dugong dugon",
170
+ "150": "sea lion",
171
+ "151": "Chihuahua",
172
+ "152": "Japanese spaniel",
173
+ "153": "Maltese dog, Maltese terrier, Maltese",
174
+ "154": "Pekinese, Pekingese, Peke",
175
+ "155": "Shih-Tzu",
176
+ "156": "Blenheim spaniel",
177
+ "157": "papillon",
178
+ "158": "toy terrier",
179
+ "159": "Rhodesian ridgeback",
180
+ "160": "Afghan hound, Afghan",
181
+ "161": "basset, basset hound",
182
+ "162": "beagle",
183
+ "163": "bloodhound, sleuthhound",
184
+ "164": "bluetick",
185
+ "165": "black-and-tan coonhound",
186
+ "166": "Walker hound, Walker foxhound",
187
+ "167": "English foxhound",
188
+ "168": "redbone",
189
+ "169": "borzoi, Russian wolfhound",
190
+ "170": "Irish wolfhound",
191
+ "171": "Italian greyhound",
192
+ "172": "whippet",
193
+ "173": "Ibizan hound, Ibizan Podenco",
194
+ "174": "Norwegian elkhound, elkhound",
195
+ "175": "otterhound, otter hound",
196
+ "176": "Saluki, gazelle hound",
197
+ "177": "Scottish deerhound, deerhound",
198
+ "178": "Weimaraner",
199
+ "179": "Staffordshire bullterrier, Staffordshire bull terrier",
200
+ "180": "American Staffordshire terrier, Staffordshire terrier, American pit bull terrier, pit bull terrier",
201
+ "181": "Bedlington terrier",
202
+ "182": "Border terrier",
203
+ "183": "Kerry blue terrier",
204
+ "184": "Irish terrier",
205
+ "185": "Norfolk terrier",
206
+ "186": "Norwich terrier",
207
+ "187": "Yorkshire terrier",
208
+ "188": "wire-haired fox terrier",
209
+ "189": "Lakeland terrier",
210
+ "190": "Sealyham terrier, Sealyham",
211
+ "191": "Airedale, Airedale terrier",
212
+ "192": "cairn, cairn terrier",
213
+ "193": "Australian terrier",
214
+ "194": "Dandie Dinmont, Dandie Dinmont terrier",
215
+ "195": "Boston bull, Boston terrier",
216
+ "196": "miniature schnauzer",
217
+ "197": "giant schnauzer",
218
+ "198": "standard schnauzer",
219
+ "199": "Scotch terrier, Scottish terrier, Scottie",
220
+ "200": "Tibetan terrier, chrysanthemum dog",
221
+ "201": "silky terrier, Sydney silky",
222
+ "202": "soft-coated wheaten terrier",
223
+ "203": "West Highland white terrier",
224
+ "204": "Lhasa, Lhasa apso",
225
+ "205": "flat-coated retriever",
226
+ "206": "curly-coated retriever",
227
+ "207": "golden retriever",
228
+ "208": "Labrador retriever",
229
+ "209": "Chesapeake Bay retriever",
230
+ "210": "German short-haired pointer",
231
+ "211": "vizsla, Hungarian pointer",
232
+ "212": "English setter",
233
+ "213": "Irish setter, red setter",
234
+ "214": "Gordon setter",
235
+ "215": "Brittany spaniel",
236
+ "216": "clumber, clumber spaniel",
237
+ "217": "English springer, English springer spaniel",
238
+ "218": "Welsh springer spaniel",
239
+ "219": "cocker spaniel, English cocker spaniel, cocker",
240
+ "220": "Sussex spaniel",
241
+ "221": "Irish water spaniel",
242
+ "222": "kuvasz",
243
+ "223": "schipperke",
244
+ "224": "groenendael",
245
+ "225": "malinois",
246
+ "226": "briard",
247
+ "227": "kelpie",
248
+ "228": "komondor",
249
+ "229": "Old English sheepdog, bobtail",
250
+ "230": "Shetland sheepdog, Shetland sheep dog, Shetland",
251
+ "231": "collie",
252
+ "232": "Border collie",
253
+ "233": "Bouvier des Flandres, Bouviers des Flandres",
254
+ "234": "Rottweiler",
255
+ "235": "German shepherd, German shepherd dog, German police dog, alsatian",
256
+ "236": "Doberman, Doberman pinscher",
257
+ "237": "miniature pinscher",
258
+ "238": "Greater Swiss Mountain dog",
259
+ "239": "Bernese mountain dog",
260
+ "240": "Appenzeller",
261
+ "241": "EntleBucher",
262
+ "242": "boxer",
263
+ "243": "bull mastiff",
264
+ "244": "Tibetan mastiff",
265
+ "245": "French bulldog",
266
+ "246": "Great Dane",
267
+ "247": "Saint Bernard, St Bernard",
268
+ "248": "Eskimo dog, husky",
269
+ "249": "malamute, malemute, Alaskan malamute",
270
+ "250": "Siberian husky",
271
+ "251": "dalmatian, coach dog, carriage dog",
272
+ "252": "affenpinscher, monkey pinscher, monkey dog",
273
+ "253": "basenji",
274
+ "254": "pug, pug-dog",
275
+ "255": "Leonberg",
276
+ "256": "Newfoundland, Newfoundland dog",
277
+ "257": "Great Pyrenees",
278
+ "258": "Samoyed, Samoyede",
279
+ "259": "Pomeranian",
280
+ "260": "chow, chow chow",
281
+ "261": "keeshond",
282
+ "262": "Brabancon griffon",
283
+ "263": "Pembroke, Pembroke Welsh corgi",
284
+ "264": "Cardigan, Cardigan Welsh corgi",
285
+ "265": "toy poodle",
286
+ "266": "miniature poodle",
287
+ "267": "standard poodle",
288
+ "268": "Mexican hairless",
289
+ "269": "timber wolf, grey wolf, gray wolf, Canis lupus",
290
+ "270": "white wolf, Arctic wolf, Canis lupus tundrarum",
291
+ "271": "red wolf, maned wolf, Canis rufus, Canis niger",
292
+ "272": "coyote, prairie wolf, brush wolf, Canis latrans",
293
+ "273": "dingo, warrigal, warragal, Canis dingo",
294
+ "274": "dhole, Cuon alpinus",
295
+ "275": "African hunting dog, hyena dog, Cape hunting dog, Lycaon pictus",
296
+ "276": "hyena, hyaena",
297
+ "277": "red fox, Vulpes vulpes",
298
+ "278": "kit fox, Vulpes macrotis",
299
+ "279": "Arctic fox, white fox, Alopex lagopus",
300
+ "280": "grey fox, gray fox, Urocyon cinereoargenteus",
301
+ "281": "tabby, tabby cat",
302
+ "282": "tiger cat",
303
+ "283": "Persian cat",
304
+ "284": "Siamese cat, Siamese",
305
+ "285": "Egyptian cat",
306
+ "286": "cougar, puma, catamount, mountain lion, painter, panther, Felis concolor",
307
+ "287": "lynx, catamount",
308
+ "288": "leopard, Panthera pardus",
309
+ "289": "snow leopard, ounce, Panthera uncia",
310
+ "290": "jaguar, panther, Panthera onca, Felis onca",
311
+ "291": "lion, king of beasts, Panthera leo",
312
+ "292": "tiger, Panthera tigris",
313
+ "293": "cheetah, chetah, Acinonyx jubatus",
314
+ "294": "brown bear, bruin, Ursus arctos",
315
+ "295": "American black bear, black bear, Ursus americanus, Euarctos americanus",
316
+ "296": "ice bear, polar bear, Ursus Maritimus, Thalarctos maritimus",
317
+ "297": "sloth bear, Melursus ursinus, Ursus ursinus",
318
+ "298": "mongoose",
319
+ "299": "meerkat, mierkat",
320
+ "300": "tiger beetle",
321
+ "301": "ladybug, ladybeetle, lady beetle, ladybird, ladybird beetle",
322
+ "302": "ground beetle, carabid beetle",
323
+ "303": "long-horned beetle, longicorn, longicorn beetle",
324
+ "304": "leaf beetle, chrysomelid",
325
+ "305": "dung beetle",
326
+ "306": "rhinoceros beetle",
327
+ "307": "weevil",
328
+ "308": "fly",
329
+ "309": "bee",
330
+ "310": "ant, emmet, pismire",
331
+ "311": "grasshopper, hopper",
332
+ "312": "cricket",
333
+ "313": "walking stick, walkingstick, stick insect",
334
+ "314": "cockroach, roach",
335
+ "315": "mantis, mantid",
336
+ "316": "cicada, cicala",
337
+ "317": "leafhopper",
338
+ "318": "lacewing, lacewing fly",
339
+ "319": "dragonfly, darning needle, devils darning needle, sewing needle, snake feeder, snake doctor, mosquito hawk, skeeter hawk",
340
+ "320": "damselfly",
341
+ "321": "admiral",
342
+ "322": "ringlet, ringlet butterfly",
343
+ "323": "monarch, monarch butterfly, milkweed butterfly, Danaus plexippus",
344
+ "324": "cabbage butterfly",
345
+ "325": "sulphur butterfly, sulfur butterfly",
346
+ "326": "lycaenid, lycaenid butterfly",
347
+ "327": "starfish, sea star",
348
+ "328": "sea urchin",
349
+ "329": "sea cucumber, holothurian",
350
+ "330": "wood rabbit, cottontail, cottontail rabbit",
351
+ "331": "hare",
352
+ "332": "Angora, Angora rabbit",
353
+ "333": "hamster",
354
+ "334": "porcupine, hedgehog",
355
+ "335": "fox squirrel, eastern fox squirrel, Sciurus niger",
356
+ "336": "marmot",
357
+ "337": "beaver",
358
+ "338": "guinea pig, Cavia cobaya",
359
+ "339": "sorrel",
360
+ "340": "zebra",
361
+ "341": "hog, pig, grunter, squealer, Sus scrofa",
362
+ "342": "wild boar, boar, Sus scrofa",
363
+ "343": "warthog",
364
+ "344": "hippopotamus, hippo, river horse, Hippopotamus amphibius",
365
+ "345": "ox",
366
+ "346": "water buffalo, water ox, Asiatic buffalo, Bubalus bubalis",
367
+ "347": "bison",
368
+ "348": "ram, tup",
369
+ "349": "bighorn, bighorn sheep, cimarron, Rocky Mountain bighorn, Rocky Mountain sheep, Ovis canadensis",
370
+ "350": "ibex, Capra ibex",
371
+ "351": "hartebeest",
372
+ "352": "impala, Aepyceros melampus",
373
+ "353": "gazelle",
374
+ "354": "Arabian camel, dromedary, Camelus dromedarius",
375
+ "355": "llama",
376
+ "356": "weasel",
377
+ "357": "mink",
378
+ "358": "polecat, fitch, foulmart, foumart, Mustela putorius",
379
+ "359": "black-footed ferret, ferret, Mustela nigripes",
380
+ "360": "otter",
381
+ "361": "skunk, polecat, wood pussy",
382
+ "362": "badger",
383
+ "363": "armadillo",
384
+ "364": "three-toed sloth, ai, Bradypus tridactylus",
385
+ "365": "orangutan, orang, orangutang, Pongo pygmaeus",
386
+ "366": "gorilla, Gorilla gorilla",
387
+ "367": "chimpanzee, chimp, Pan troglodytes",
388
+ "368": "gibbon, Hylobates lar",
389
+ "369": "siamang, Hylobates syndactylus, Symphalangus syndactylus",
390
+ "370": "guenon, guenon monkey",
391
+ "371": "patas, hussar monkey, Erythrocebus patas",
392
+ "372": "baboon",
393
+ "373": "macaque",
394
+ "374": "langur",
395
+ "375": "colobus, colobus monkey",
396
+ "376": "proboscis monkey, Nasalis larvatus",
397
+ "377": "marmoset",
398
+ "378": "capuchin, ringtail, Cebus capucinus",
399
+ "379": "howler monkey, howler",
400
+ "380": "titi, titi monkey",
401
+ "381": "spider monkey, Ateles geoffroyi",
402
+ "382": "squirrel monkey, Saimiri sciureus",
403
+ "383": "Madagascar cat, ring-tailed lemur, Lemur catta",
404
+ "384": "indri, indris, Indri indri, Indri brevicaudatus",
405
+ "385": "Indian elephant, Elephas maximus",
406
+ "386": "African elephant, Loxodonta africana",
407
+ "387": "lesser panda, red panda, panda, bear cat, cat bear, Ailurus fulgens",
408
+ "388": "giant panda, panda, panda bear, coon bear, Ailuropoda melanoleuca",
409
+ "389": "barracouta, snoek",
410
+ "390": "eel",
411
+ "391": "coho, cohoe, coho salmon, blue jack, silver salmon, Oncorhynchus kisutch",
412
+ "392": "rock beauty, Holocanthus tricolor",
413
+ "393": "anemone fish",
414
+ "394": "sturgeon",
415
+ "395": "gar, garfish, garpike, billfish, Lepisosteus osseus",
416
+ "396": "lionfish",
417
+ "397": "puffer, pufferfish, blowfish, globefish",
418
+ "398": "abacus",
419
+ "399": "abaya",
420
+ "400": "academic gown, academic robe, judge robe",
421
+ "401": "accordion, piano accordion, squeeze box",
422
+ "402": "acoustic guitar",
423
+ "403": "aircraft carrier, carrier, flattop, attack aircraft carrier",
424
+ "404": "airliner",
425
+ "405": "airship, dirigible",
426
+ "406": "altar",
427
+ "407": "ambulance",
428
+ "408": "amphibian, amphibious vehicle",
429
+ "409": "analog clock",
430
+ "410": "apiary, bee house",
431
+ "411": "apron",
432
+ "412": "ashcan, trash can, garbage can, wastebin, ash bin, ash-bin, ashbin, dustbin, trash barrel, trash bin",
433
+ "413": "assault rifle, assault gun",
434
+ "414": "backpack, back pack, knapsack, packsack, rucksack, haversack",
435
+ "415": "bakery, bakeshop, bakehouse",
436
+ "416": "balance beam, beam",
437
+ "417": "balloon",
438
+ "418": "ballpoint, ballpoint pen, ballpen, Biro",
439
+ "419": "Band Aid",
440
+ "420": "banjo",
441
+ "421": "bannister, banister, balustrade, balusters, handrail",
442
+ "422": "barbell",
443
+ "423": "barber chair",
444
+ "424": "barbershop",
445
+ "425": "barn",
446
+ "426": "barometer",
447
+ "427": "barrel, cask",
448
+ "428": "barrow, garden cart, lawn cart, wheelbarrow",
449
+ "429": "baseball",
450
+ "430": "basketball",
451
+ "431": "bassinet",
452
+ "432": "bassoon",
453
+ "433": "bathing cap, swimming cap",
454
+ "434": "bath towel",
455
+ "435": "bathtub, bathing tub, bath, tub",
456
+ "436": "beach wagon, station wagon, wagon, estate car, beach waggon, station waggon, waggon",
457
+ "437": "beacon, lighthouse, beacon light, pharos",
458
+ "438": "beaker",
459
+ "439": "bearskin, busby, shako",
460
+ "440": "beer bottle",
461
+ "441": "beer glass",
462
+ "442": "bell cote, bell cot",
463
+ "443": "bib",
464
+ "444": "bicycle-built-for-two, tandem bicycle, tandem",
465
+ "445": "bikini, two-piece",
466
+ "446": "binder, ring-binder",
467
+ "447": "binoculars, field glasses, opera glasses",
468
+ "448": "birdhouse",
469
+ "449": "boathouse",
470
+ "450": "bobsled, bobsleigh, bob",
471
+ "451": "bolo tie, bolo, bola tie, bola",
472
+ "452": "bonnet, poke bonnet",
473
+ "453": "bookcase",
474
+ "454": "bookshop, bookstore, bookstall",
475
+ "455": "bottlecap",
476
+ "456": "bow",
477
+ "457": "bow tie, bow-tie, bowtie",
478
+ "458": "brass, memorial tablet, plaque",
479
+ "459": "brassiere, bra, bandeau",
480
+ "460": "breakwater, groin, groyne, mole, bulwark, seawall, jetty",
481
+ "461": "breastplate, aegis, egis",
482
+ "462": "broom",
483
+ "463": "bucket, pail",
484
+ "464": "buckle",
485
+ "465": "bulletproof vest",
486
+ "466": "bullet train, bullet",
487
+ "467": "butcher shop, meat market",
488
+ "468": "cab, hack, taxi, taxicab",
489
+ "469": "caldron, cauldron",
490
+ "470": "candle, taper, wax light",
491
+ "471": "cannon",
492
+ "472": "canoe",
493
+ "473": "can opener, tin opener",
494
+ "474": "cardigan",
495
+ "475": "car mirror",
496
+ "476": "carousel, carrousel, merry-go-round, roundabout, whirligig",
497
+ "477": "carpenters kit, tool kit",
498
+ "478": "carton",
499
+ "479": "car wheel",
500
+ "480": "cash machine, cash dispenser, automated teller machine, automatic teller machine, automated teller, automatic teller, ATM",
501
+ "481": "cassette",
502
+ "482": "cassette player",
503
+ "483": "castle",
504
+ "484": "catamaran",
505
+ "485": "CD player",
506
+ "486": "cello, violoncello",
507
+ "487": "cellular telephone, cellular phone, cellphone, cell, mobile phone",
508
+ "488": "chain",
509
+ "489": "chainlink fence",
510
+ "490": "chain mail, ring mail, mail, chain armor, chain armour, ring armor, ring armour",
511
+ "491": "chain saw, chainsaw",
512
+ "492": "chest",
513
+ "493": "chiffonier, commode",
514
+ "494": "chime, bell, gong",
515
+ "495": "china cabinet, china closet",
516
+ "496": "Christmas stocking",
517
+ "497": "church, church building",
518
+ "498": "cinema, movie theater, movie theatre, movie house, picture palace",
519
+ "499": "cleaver, meat cleaver, chopper",
520
+ "500": "cliff dwelling",
521
+ "501": "cloak",
522
+ "502": "clog, geta, patten, sabot",
523
+ "503": "cocktail shaker",
524
+ "504": "coffee mug",
525
+ "505": "coffeepot",
526
+ "506": "coil, spiral, volute, whorl, helix",
527
+ "507": "combination lock",
528
+ "508": "computer keyboard, keypad",
529
+ "509": "confectionery, confectionary, candy store",
530
+ "510": "container ship, containership, container vessel",
531
+ "511": "convertible",
532
+ "512": "corkscrew, bottle screw",
533
+ "513": "cornet, horn, trumpet, trump",
534
+ "514": "cowboy boot",
535
+ "515": "cowboy hat, ten-gallon hat",
536
+ "516": "cradle",
537
+ "517": "crane",
538
+ "518": "crash helmet",
539
+ "519": "crate",
540
+ "520": "crib, cot",
541
+ "521": "Crock Pot",
542
+ "522": "croquet ball",
543
+ "523": "crutch",
544
+ "524": "cuirass",
545
+ "525": "dam, dike, dyke",
546
+ "526": "desk",
547
+ "527": "desktop computer",
548
+ "528": "dial telephone, dial phone",
549
+ "529": "diaper, nappy, napkin",
550
+ "530": "digital clock",
551
+ "531": "digital watch",
552
+ "532": "dining table, board",
553
+ "533": "dishrag, dishcloth",
554
+ "534": "dishwasher, dish washer, dishwashing machine",
555
+ "535": "disk brake, disc brake",
556
+ "536": "dock, dockage, docking facility",
557
+ "537": "dogsled, dog sled, dog sleigh",
558
+ "538": "dome",
559
+ "539": "doormat, welcome mat",
560
+ "540": "drilling platform, offshore rig",
561
+ "541": "drum, membranophone, tympan",
562
+ "542": "drumstick",
563
+ "543": "dumbbell",
564
+ "544": "Dutch oven",
565
+ "545": "electric fan, blower",
566
+ "546": "electric guitar",
567
+ "547": "electric locomotive",
568
+ "548": "entertainment center",
569
+ "549": "envelope",
570
+ "550": "espresso maker",
571
+ "551": "face powder",
572
+ "552": "feather boa, boa",
573
+ "553": "file, file cabinet, filing cabinet",
574
+ "554": "fireboat",
575
+ "555": "fire engine, fire truck",
576
+ "556": "fire screen, fireguard",
577
+ "557": "flagpole, flagstaff",
578
+ "558": "flute, transverse flute",
579
+ "559": "folding chair",
580
+ "560": "football helmet",
581
+ "561": "forklift",
582
+ "562": "fountain",
583
+ "563": "fountain pen",
584
+ "564": "four-poster",
585
+ "565": "freight car",
586
+ "566": "French horn, horn",
587
+ "567": "frying pan, frypan, skillet",
588
+ "568": "fur coat",
589
+ "569": "garbage truck, dustcart",
590
+ "570": "gasmask, respirator, gas helmet",
591
+ "571": "gas pump, gasoline pump, petrol pump, island dispenser",
592
+ "572": "goblet",
593
+ "573": "go-kart",
594
+ "574": "golf ball",
595
+ "575": "golfcart, golf cart",
596
+ "576": "gondola",
597
+ "577": "gong, tam-tam",
598
+ "578": "gown",
599
+ "579": "grand piano, grand",
600
+ "580": "greenhouse, nursery, glasshouse",
601
+ "581": "grille, radiator grille",
602
+ "582": "grocery store, grocery, food market, market",
603
+ "583": "guillotine",
604
+ "584": "hair slide",
605
+ "585": "hair spray",
606
+ "586": "half track",
607
+ "587": "hammer",
608
+ "588": "hamper",
609
+ "589": "hand blower, blow dryer, blow drier, hair dryer, hair drier",
610
+ "590": "hand-held computer, hand-held microcomputer",
611
+ "591": "handkerchief, hankie, hanky, hankey",
612
+ "592": "hard disc, hard disk, fixed disk",
613
+ "593": "harmonica, mouth organ, harp, mouth harp",
614
+ "594": "harp",
615
+ "595": "harvester, reaper",
616
+ "596": "hatchet",
617
+ "597": "holster",
618
+ "598": "home theater, home theatre",
619
+ "599": "honeycomb",
620
+ "600": "hook, claw",
621
+ "601": "hoopskirt, crinoline",
622
+ "602": "horizontal bar, high bar",
623
+ "603": "horse cart, horse-cart",
624
+ "604": "hourglass",
625
+ "605": "iPod",
626
+ "606": "iron, smoothing iron",
627
+ "607": "jack-o-lantern",
628
+ "608": "jean, blue jean, denim",
629
+ "609": "jeep, landrover",
630
+ "610": "jersey, T-shirt, tee shirt",
631
+ "611": "jigsaw puzzle",
632
+ "612": "jinrikisha, ricksha, rickshaw",
633
+ "613": "joystick",
634
+ "614": "kimono",
635
+ "615": "knee pad",
636
+ "616": "knot",
637
+ "617": "lab coat, laboratory coat",
638
+ "618": "ladle",
639
+ "619": "lampshade, lamp shade",
640
+ "620": "laptop, laptop computer",
641
+ "621": "lawn mower, mower",
642
+ "622": "lens cap, lens cover",
643
+ "623": "letter opener, paper knife, paperknife",
644
+ "624": "library",
645
+ "625": "lifeboat",
646
+ "626": "lighter, light, igniter, ignitor",
647
+ "627": "limousine, limo",
648
+ "628": "liner, ocean liner",
649
+ "629": "lipstick, lip rouge",
650
+ "630": "Loafer",
651
+ "631": "lotion",
652
+ "632": "loudspeaker, speaker, speaker unit, loudspeaker system, speaker system",
653
+ "633": "loupe, jewelers loupe",
654
+ "634": "lumbermill, sawmill",
655
+ "635": "magnetic compass",
656
+ "636": "mailbag, postbag",
657
+ "637": "mailbox, letter box",
658
+ "638": "maillot",
659
+ "639": "maillot, tank suit",
660
+ "640": "manhole cover",
661
+ "641": "maraca",
662
+ "642": "marimba, xylophone",
663
+ "643": "mask",
664
+ "644": "matchstick",
665
+ "645": "maypole",
666
+ "646": "maze, labyrinth",
667
+ "647": "measuring cup",
668
+ "648": "medicine chest, medicine cabinet",
669
+ "649": "megalith, megalithic structure",
670
+ "650": "microphone, mike",
671
+ "651": "microwave, microwave oven",
672
+ "652": "military uniform",
673
+ "653": "milk can",
674
+ "654": "minibus",
675
+ "655": "miniskirt, mini",
676
+ "656": "minivan",
677
+ "657": "missile",
678
+ "658": "mitten",
679
+ "659": "mixing bowl",
680
+ "660": "mobile home, manufactured home",
681
+ "661": "Model T",
682
+ "662": "modem",
683
+ "663": "monastery",
684
+ "664": "monitor",
685
+ "665": "moped",
686
+ "666": "mortar",
687
+ "667": "mortarboard",
688
+ "668": "mosque",
689
+ "669": "mosquito net",
690
+ "670": "motor scooter, scooter",
691
+ "671": "mountain bike, all-terrain bike, off-roader",
692
+ "672": "mountain tent",
693
+ "673": "mouse, computer mouse",
694
+ "674": "mousetrap",
695
+ "675": "moving van",
696
+ "676": "muzzle",
697
+ "677": "nail",
698
+ "678": "neck brace",
699
+ "679": "necklace",
700
+ "680": "nipple",
701
+ "681": "notebook, notebook computer",
702
+ "682": "obelisk",
703
+ "683": "oboe, hautboy, hautbois",
704
+ "684": "ocarina, sweet potato",
705
+ "685": "odometer, hodometer, mileometer, milometer",
706
+ "686": "oil filter",
707
+ "687": "organ, pipe organ",
708
+ "688": "oscilloscope, scope, cathode-ray oscilloscope, CRO",
709
+ "689": "overskirt",
710
+ "690": "oxcart",
711
+ "691": "oxygen mask",
712
+ "692": "packet",
713
+ "693": "paddle, boat paddle",
714
+ "694": "paddlewheel, paddle wheel",
715
+ "695": "padlock",
716
+ "696": "paintbrush",
717
+ "697": "pajama, pyjama, pjs, jammies",
718
+ "698": "palace",
719
+ "699": "panpipe, pandean pipe, syrinx",
720
+ "700": "paper towel",
721
+ "701": "parachute, chute",
722
+ "702": "parallel bars, bars",
723
+ "703": "park bench",
724
+ "704": "parking meter",
725
+ "705": "passenger car, coach, carriage",
726
+ "706": "patio, terrace",
727
+ "707": "pay-phone, pay-station",
728
+ "708": "pedestal, plinth, footstall",
729
+ "709": "pencil box, pencil case",
730
+ "710": "pencil sharpener",
731
+ "711": "perfume, essence",
732
+ "712": "Petri dish",
733
+ "713": "photocopier",
734
+ "714": "pick, plectrum, plectron",
735
+ "715": "pickelhaube",
736
+ "716": "picket fence, paling",
737
+ "717": "pickup, pickup truck",
738
+ "718": "pier",
739
+ "719": "piggy bank, penny bank",
740
+ "720": "pill bottle",
741
+ "721": "pillow",
742
+ "722": "ping-pong ball",
743
+ "723": "pinwheel",
744
+ "724": "pirate, pirate ship",
745
+ "725": "pitcher, ewer",
746
+ "726": "plane, carpenters plane, woodworking plane",
747
+ "727": "planetarium",
748
+ "728": "plastic bag",
749
+ "729": "plate rack",
750
+ "730": "plow, plough",
751
+ "731": "plunger, plumbers helper",
752
+ "732": "Polaroid camera, Polaroid Land camera",
753
+ "733": "pole",
754
+ "734": "police van, police wagon, paddy wagon, patrol wagon, wagon, black Maria",
755
+ "735": "poncho",
756
+ "736": "pool table, billiard table, snooker table",
757
+ "737": "pop bottle, soda bottle",
758
+ "738": "pot, flowerpot",
759
+ "739": "potters wheel",
760
+ "740": "power drill",
761
+ "741": "prayer rug, prayer mat",
762
+ "742": "printer",
763
+ "743": "prison, prison house",
764
+ "744": "projectile, missile",
765
+ "745": "projector",
766
+ "746": "puck, hockey puck",
767
+ "747": "punching bag, punch bag, punching ball, punchball",
768
+ "748": "purse",
769
+ "749": "quill, quill pen",
770
+ "750": "quilt, comforter, comfort, puff",
771
+ "751": "racer, race car, racing car",
772
+ "752": "racket, racquet",
773
+ "753": "radiator",
774
+ "754": "radio, wireless",
775
+ "755": "radio telescope, radio reflector",
776
+ "756": "rain barrel",
777
+ "757": "recreational vehicle, RV, R.V.",
778
+ "758": "reel",
779
+ "759": "reflex camera",
780
+ "760": "refrigerator, icebox",
781
+ "761": "remote control, remote",
782
+ "762": "restaurant, eating house, eating place, eatery",
783
+ "763": "revolver, six-gun, six-shooter",
784
+ "764": "rifle",
785
+ "765": "rocking chair, rocker",
786
+ "766": "rotisserie",
787
+ "767": "rubber eraser, rubber, pencil eraser",
788
+ "768": "rugby ball",
789
+ "769": "rule, ruler",
790
+ "770": "running shoe",
791
+ "771": "safe",
792
+ "772": "safety pin",
793
+ "773": "saltshaker, salt shaker",
794
+ "774": "sandal",
795
+ "775": "sarong",
796
+ "776": "sax, saxophone",
797
+ "777": "scabbard",
798
+ "778": "scale, weighing machine",
799
+ "779": "school bus",
800
+ "780": "schooner",
801
+ "781": "scoreboard",
802
+ "782": "screen, CRT screen",
803
+ "783": "screw",
804
+ "784": "screwdriver",
805
+ "785": "seat belt, seatbelt",
806
+ "786": "sewing machine",
807
+ "787": "shield, buckler",
808
+ "788": "shoe shop, shoe-shop, shoe store",
809
+ "789": "shoji",
810
+ "790": "shopping basket",
811
+ "791": "shopping cart",
812
+ "792": "shovel",
813
+ "793": "shower cap",
814
+ "794": "shower curtain",
815
+ "795": "ski",
816
+ "796": "ski mask",
817
+ "797": "sleeping bag",
818
+ "798": "slide rule, slipstick",
819
+ "799": "sliding door",
820
+ "800": "slot, one-armed bandit",
821
+ "801": "snorkel",
822
+ "802": "snowmobile",
823
+ "803": "snowplow, snowplough",
824
+ "804": "soap dispenser",
825
+ "805": "soccer ball",
826
+ "806": "sock",
827
+ "807": "solar dish, solar collector, solar furnace",
828
+ "808": "sombrero",
829
+ "809": "soup bowl",
830
+ "810": "space bar",
831
+ "811": "space heater",
832
+ "812": "space shuttle",
833
+ "813": "spatula",
834
+ "814": "speedboat",
835
+ "815": "spider web, spiders web",
836
+ "816": "spindle",
837
+ "817": "sports car, sport car",
838
+ "818": "spotlight, spot",
839
+ "819": "stage",
840
+ "820": "steam locomotive",
841
+ "821": "steel arch bridge",
842
+ "822": "steel drum",
843
+ "823": "stethoscope",
844
+ "824": "stole",
845
+ "825": "stone wall",
846
+ "826": "stopwatch, stop watch",
847
+ "827": "stove",
848
+ "828": "strainer",
849
+ "829": "streetcar, tram, tramcar, trolley, trolley car",
850
+ "830": "stretcher",
851
+ "831": "studio couch, day bed",
852
+ "832": "stupa, tope",
853
+ "833": "submarine, pigboat, sub, U-boat",
854
+ "834": "suit, suit of clothes",
855
+ "835": "sundial",
856
+ "836": "sunglass",
857
+ "837": "sunglasses, dark glasses, shades",
858
+ "838": "sunscreen, sunblock, sun blocker",
859
+ "839": "suspension bridge",
860
+ "840": "swab, swob, mop",
861
+ "841": "sweatshirt",
862
+ "842": "swimming trunks, bathing trunks",
863
+ "843": "swing",
864
+ "844": "switch, electric switch, electrical switch",
865
+ "845": "syringe",
866
+ "846": "table lamp",
867
+ "847": "tank, army tank, armored combat vehicle, armoured combat vehicle",
868
+ "848": "tape player",
869
+ "849": "teapot",
870
+ "850": "teddy, teddy bear",
871
+ "851": "television, television system",
872
+ "852": "tennis ball",
873
+ "853": "thatch, thatched roof",
874
+ "854": "theater curtain, theatre curtain",
875
+ "855": "thimble",
876
+ "856": "thresher, thrasher, threshing machine",
877
+ "857": "throne",
878
+ "858": "tile roof",
879
+ "859": "toaster",
880
+ "860": "tobacco shop, tobacconist shop, tobacconist",
881
+ "861": "toilet seat",
882
+ "862": "torch",
883
+ "863": "totem pole",
884
+ "864": "tow truck, tow car, wrecker",
885
+ "865": "toyshop",
886
+ "866": "tractor",
887
+ "867": "trailer truck, tractor trailer, trucking rig, rig, articulated lorry, semi",
888
+ "868": "tray",
889
+ "869": "trench coat",
890
+ "870": "tricycle, trike, velocipede",
891
+ "871": "trimaran",
892
+ "872": "tripod",
893
+ "873": "triumphal arch",
894
+ "874": "trolleybus, trolley coach, trackless trolley",
895
+ "875": "trombone",
896
+ "876": "tub, vat",
897
+ "877": "turnstile",
898
+ "878": "typewriter keyboard",
899
+ "879": "umbrella",
900
+ "880": "unicycle, monocycle",
901
+ "881": "upright, upright piano",
902
+ "882": "vacuum, vacuum cleaner",
903
+ "883": "vase",
904
+ "884": "vault",
905
+ "885": "velvet",
906
+ "886": "vending machine",
907
+ "887": "vestment",
908
+ "888": "viaduct",
909
+ "889": "violin, fiddle",
910
+ "890": "volleyball",
911
+ "891": "waffle iron",
912
+ "892": "wall clock",
913
+ "893": "wallet, billfold, notecase, pocketbook",
914
+ "894": "wardrobe, closet, press",
915
+ "895": "warplane, military plane",
916
+ "896": "washbasin, handbasin, washbowl, lavabo, wash-hand basin",
917
+ "897": "washer, automatic washer, washing machine",
918
+ "898": "water bottle",
919
+ "899": "water jug",
920
+ "900": "water tower",
921
+ "901": "whiskey jug",
922
+ "902": "whistle",
923
+ "903": "wig",
924
+ "904": "window screen",
925
+ "905": "window shade",
926
+ "906": "Windsor tie",
927
+ "907": "wine bottle",
928
+ "908": "wing",
929
+ "909": "wok",
930
+ "910": "wooden spoon",
931
+ "911": "wool, woolen, woollen",
932
+ "912": "worm fence, snake fence, snake-rail fence, Virginia fence",
933
+ "913": "wreck",
934
+ "914": "yawl",
935
+ "915": "yurt",
936
+ "916": "web site, website, internet site, site",
937
+ "917": "comic book",
938
+ "918": "crossword puzzle, crossword",
939
+ "919": "street sign",
940
+ "920": "traffic light, traffic signal, stoplight",
941
+ "921": "book jacket, dust cover, dust jacket, dust wrapper",
942
+ "922": "menu",
943
+ "923": "plate",
944
+ "924": "guacamole",
945
+ "925": "consomme",
946
+ "926": "hot pot, hotpot",
947
+ "927": "trifle",
948
+ "928": "ice cream, icecream",
949
+ "929": "ice lolly, lolly, lollipop, popsicle",
950
+ "930": "French loaf",
951
+ "931": "bagel, beigel",
952
+ "932": "pretzel",
953
+ "933": "cheeseburger",
954
+ "934": "hotdog, hot dog, red hot",
955
+ "935": "mashed potato",
956
+ "936": "head cabbage",
957
+ "937": "broccoli",
958
+ "938": "cauliflower",
959
+ "939": "zucchini, courgette",
960
+ "940": "spaghetti squash",
961
+ "941": "acorn squash",
962
+ "942": "butternut squash",
963
+ "943": "cucumber, cuke",
964
+ "944": "artichoke, globe artichoke",
965
+ "945": "bell pepper",
966
+ "946": "cardoon",
967
+ "947": "mushroom",
968
+ "948": "Granny Smith",
969
+ "949": "strawberry",
970
+ "950": "orange",
971
+ "951": "lemon",
972
+ "952": "fig",
973
+ "953": "pineapple, ananas",
974
+ "954": "banana",
975
+ "955": "jackfruit, jak, jack",
976
+ "956": "custard apple",
977
+ "957": "pomegranate",
978
+ "958": "hay",
979
+ "959": "carbonara",
980
+ "960": "chocolate sauce, chocolate syrup",
981
+ "961": "dough",
982
+ "962": "meat loaf, meatloaf",
983
+ "963": "pizza, pizza pie",
984
+ "964": "potpie",
985
+ "965": "burrito",
986
+ "966": "red wine",
987
+ "967": "espresso",
988
+ "968": "cup",
989
+ "969": "eggnog",
990
+ "970": "alp",
991
+ "971": "bubble",
992
+ "972": "cliff, drop, drop-off",
993
+ "973": "coral reef",
994
+ "974": "geyser",
995
+ "975": "lakeside, lakeshore",
996
+ "976": "promontory, headland, head, foreland",
997
+ "977": "sandbar, sand bar",
998
+ "978": "seashore, coast, seacoast, sea-coast",
999
+ "979": "valley, vale",
1000
+ "980": "volcano",
1001
+ "981": "ballplayer, baseball player",
1002
+ "982": "groom, bridegroom",
1003
+ "983": "scuba diver",
1004
+ "984": "rapeseed",
1005
+ "985": "daisy",
1006
+ "986": "yellow ladys slipper, yellow lady-slipper, Cypripedium calceolus, Cypripedium parviflorum",
1007
+ "987": "corn",
1008
+ "988": "acorn",
1009
+ "989": "hip, rose hip, rosehip",
1010
+ "990": "buckeye, horse chestnut, conker",
1011
+ "991": "coral fungus",
1012
+ "992": "agaric",
1013
+ "993": "gyromitra",
1014
+ "994": "stinkhorn, carrion fungus",
1015
+ "995": "earthstar",
1016
+ "996": "hen-of-the-woods, hen of the woods, Polyporus frondosus, Grifola frondosa",
1017
+ "997": "bolete",
1018
+ "998": "ear, spike, capitulum",
1019
+ "999": "toilet tissue, toilet paper, bathroom tissue"
1020
+ }
1021
+ }
DiCo-S-256/pipeline.py ADDED
@@ -0,0 +1,398 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """Hub custom pipeline: DiCoPipeline.
2
+ Load with native Hugging Face diffusers and trust_remote_code=True.
3
+ """
4
+
5
+ # Copyright 2026 The HuggingFace Team. All rights reserved.
6
+ #
7
+ # Licensed under the Apache License, Version 2.0 (the "License");
8
+ # you may not use this file except in compliance with the License.
9
+ # You may obtain a copy of the License at
10
+ #
11
+ # http://www.apache.org/licenses/LICENSE-2.0
12
+ #
13
+ # Unless required by applicable law or agreed to in writing, software
14
+ # distributed under the License is distributed on an "AS IS" BASIS,
15
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16
+ # See the License for the specific language governing permissions and
17
+ # limitations under the License.
18
+
19
+ from __future__ import annotations
20
+
21
+ import inspect
22
+ import json
23
+ from pathlib import Path
24
+ from typing import Dict, List, Optional, Tuple, Union
25
+
26
+ import torch
27
+ from diffusers.image_processor import VaeImageProcessor
28
+ from diffusers.models import AutoencoderKL
29
+ from diffusers.pipelines.pipeline_utils import DiffusionPipeline, ImagePipelineOutput
30
+ from diffusers.schedulers import DDIMScheduler, KarrasDiffusionSchedulers
31
+ from diffusers.utils.torch_utils import randn_tensor
32
+
33
+
34
+ EXAMPLE_DOC_STRING = """
35
+ Examples:
36
+ ```py
37
+ >>> from pathlib import Path
38
+ >>> from diffusers import DiffusionPipeline
39
+ >>> import torch
40
+
41
+ >>> model_dir = Path("./DiCo-XL-256").resolve()
42
+ >>> pipe = DiffusionPipeline.from_pretrained(
43
+ ... str(model_dir),
44
+ ... local_files_only=True,
45
+ ... custom_pipeline=str(model_dir / "pipeline.py"),
46
+ ... trust_remote_code=True,
47
+ ... torch_dtype=torch.bfloat16,
48
+ ... )
49
+ >>> pipe.to("cuda")
50
+
51
+ >>> image = pipe(
52
+ ... class_labels="golden retriever",
53
+ ... num_inference_steps=250,
54
+ ... guidance_scale=1.4,
55
+ ... generator=torch.Generator("cuda").manual_seed(0),
56
+ ... ).images[0]
57
+ ```
58
+ """
59
+
60
+
61
+ class DiCoPipeline(DiffusionPipeline):
62
+ r"""
63
+ Pipeline for class-conditional image generation with DiCo (Diffusion ConvNet).
64
+
65
+ Parameters:
66
+ transformer ([`DiCoTransformer2DModel`]):
67
+ Class-conditional DiCo denoiser operating in VAE latent space.
68
+ vae ([`AutoencoderKL`]):
69
+ Variational autoencoder used to decode latents to pixels.
70
+ scheduler ([`DDIMScheduler`]):
71
+ Diffusion scheduler. Other [`KarrasDiffusionSchedulers`] can be swapped at inference time.
72
+ id2label (`dict[int, str]`, *optional*):
73
+ ImageNet class id to English label mapping. Values may contain comma-separated synonyms.
74
+ """
75
+
76
+ model_cpu_offload_seq = "transformer->vae"
77
+
78
+ @staticmethod
79
+ def prepare_extra_step_kwargs(
80
+ scheduler: KarrasDiffusionSchedulers,
81
+ generator: Optional[Union[torch.Generator, List[torch.Generator]]] = None,
82
+ eta: float = 0.0,
83
+ ) -> Dict[str, object]:
84
+ kwargs: Dict[str, object] = {}
85
+ step_params = set(inspect.signature(scheduler.step).parameters.keys())
86
+ if "generator" in step_params:
87
+ kwargs["generator"] = generator
88
+ if "eta" in step_params:
89
+ kwargs["eta"] = eta
90
+ return kwargs
91
+
92
+ def __init__(
93
+ self,
94
+ transformer,
95
+ vae: AutoencoderKL,
96
+ scheduler: KarrasDiffusionSchedulers,
97
+ id2label: Optional[Dict[Union[int, str], str]] = None,
98
+ ):
99
+ super().__init__()
100
+ if scheduler is None:
101
+ scheduler = DDIMScheduler(
102
+ num_train_timesteps=1000,
103
+ beta_start=0.0001,
104
+ beta_end=0.02,
105
+ beta_schedule="linear",
106
+ clip_sample=False,
107
+ set_alpha_to_one=True,
108
+ steps_offset=0,
109
+ prediction_type="epsilon",
110
+ )
111
+ self.register_modules(transformer=transformer, vae=vae, scheduler=scheduler)
112
+ self.vae_scale_factor = 2 ** (len(self.vae.config.block_out_channels) - 1)
113
+ self.image_processor = VaeImageProcessor(vae_scale_factor=self.vae_scale_factor)
114
+ self._id2label = self._normalize_id2label(id2label)
115
+ self.labels = self._build_label2id(self._id2label)
116
+ self._labels_loaded_from_model_index = bool(self._id2label)
117
+
118
+ @classmethod
119
+ def from_pretrained(cls, pretrained_model_name_or_path: str, **kwargs):
120
+ model_kwargs = dict(kwargs)
121
+ transformer_subfolder = model_kwargs.pop("transformer_subfolder", None)
122
+ scheduler_subfolder = model_kwargs.pop("scheduler_subfolder", None)
123
+ vae_subfolder = model_kwargs.pop("vae_subfolder", None)
124
+ scheduler_kwargs = model_kwargs.pop("scheduler_kwargs", {})
125
+ base_path = Path(pretrained_model_name_or_path)
126
+
127
+ if transformer_subfolder is None and (base_path / "transformer").exists():
128
+ transformer_subfolder = "transformer"
129
+ if scheduler_subfolder is None and (base_path / "scheduler").exists():
130
+ scheduler_subfolder = "scheduler"
131
+ if vae_subfolder is None and (base_path / "vae").exists():
132
+ vae_subfolder = "vae"
133
+
134
+ try:
135
+ return super().from_pretrained(pretrained_model_name_or_path, **kwargs)
136
+ except Exception:
137
+ transformer_path = str(base_path / transformer_subfolder) if transformer_subfolder else pretrained_model_name_or_path
138
+ from transformer.transformer_dico import DiCoTransformer2DModel
139
+ transformer = DiCoTransformer2DModel.from_pretrained(transformer_path, **model_kwargs)
140
+ try:
141
+ scheduler = DDIMScheduler.from_pretrained(
142
+ pretrained_model_name_or_path,
143
+ subfolder=scheduler_subfolder,
144
+ **scheduler_kwargs,
145
+ )
146
+ except Exception:
147
+ scheduler = DDIMScheduler(
148
+ num_train_timesteps=1000,
149
+ beta_start=0.0001,
150
+ beta_end=0.02,
151
+ beta_schedule="linear",
152
+ clip_sample=False,
153
+ set_alpha_to_one=True,
154
+ steps_offset=0,
155
+ prediction_type="epsilon",
156
+ **scheduler_kwargs,
157
+ )
158
+ try:
159
+ vae = AutoencoderKL.from_pretrained(
160
+ pretrained_model_name_or_path,
161
+ subfolder=vae_subfolder,
162
+ **model_kwargs,
163
+ )
164
+ except Exception:
165
+ vae = AutoencoderKL.from_pretrained("stabilityai/sd-vae-ft-ema", **model_kwargs)
166
+ id2label = cls._read_id2label_from_model_index(str(base_path))
167
+ return cls(transformer=transformer, vae=vae, scheduler=scheduler, id2label=id2label)
168
+
169
+ def _ensure_labels_loaded(self) -> None:
170
+ if self._labels_loaded_from_model_index:
171
+ return
172
+ loaded = self._read_id2label_from_model_index(getattr(self.config, "_name_or_path", None))
173
+ if loaded:
174
+ self._id2label = loaded
175
+ self.labels = self._build_label2id(self._id2label)
176
+ self._labels_loaded_from_model_index = True
177
+
178
+ @staticmethod
179
+ def _normalize_id2label(id2label: Optional[Dict[Union[int, str], str]]) -> Dict[int, str]:
180
+ if not id2label:
181
+ return {}
182
+ return {int(key): value for key, value in id2label.items()}
183
+
184
+ @staticmethod
185
+ def _read_id2label_from_model_index(variant_path: Optional[str]) -> Dict[int, str]:
186
+ if not variant_path:
187
+ return {}
188
+ model_index_path = Path(variant_path).resolve() / "model_index.json"
189
+ if not model_index_path.exists():
190
+ return {}
191
+ raw = json.loads(model_index_path.read_text(encoding="utf-8"))
192
+ id2label = raw.get("id2label")
193
+ if not isinstance(id2label, dict):
194
+ return {}
195
+ return {int(key): value for key, value in id2label.items()}
196
+
197
+ @staticmethod
198
+ def _build_label2id(id2label: Dict[int, str]) -> Dict[str, int]:
199
+ label2id: Dict[str, int] = {}
200
+ for class_id, value in id2label.items():
201
+ for synonym in value.split(","):
202
+ synonym = synonym.strip()
203
+ if synonym:
204
+ label2id[synonym] = int(class_id)
205
+ return dict(sorted(label2id.items()))
206
+
207
+ @property
208
+ def id2label(self) -> Dict[int, str]:
209
+ self._ensure_labels_loaded()
210
+ return self._id2label
211
+
212
+ def get_label_ids(self, label: Union[str, List[str]]) -> List[int]:
213
+ self._ensure_labels_loaded()
214
+ if not self.labels:
215
+ raise ValueError("No English labels loaded. Ensure `id2label` exists in model_index.json.")
216
+ if isinstance(label, str):
217
+ label = [label]
218
+ missing = [item for item in label if item not in self.labels]
219
+ if missing:
220
+ preview = ", ".join(list(self.labels.keys())[:8])
221
+ raise ValueError(f"Unknown English label(s): {missing}. Example valid labels: {preview}, ...")
222
+ return [self.labels[item] for item in label]
223
+
224
+ def _normalize_class_labels(
225
+ self,
226
+ class_labels: Union[int, str, List[Union[int, str]], torch.LongTensor],
227
+ ) -> torch.LongTensor:
228
+ if torch.is_tensor(class_labels):
229
+ return class_labels.to(device=self._execution_device, dtype=torch.long).reshape(-1)
230
+ if isinstance(class_labels, int):
231
+ class_label_ids = [class_labels]
232
+ elif isinstance(class_labels, str):
233
+ class_label_ids = self.get_label_ids(class_labels)
234
+ elif class_labels and isinstance(class_labels[0], str):
235
+ class_label_ids = self.get_label_ids(class_labels)
236
+ else:
237
+ class_label_ids = list(class_labels)
238
+ return torch.tensor(class_label_ids, device=self._execution_device, dtype=torch.long).reshape(-1)
239
+
240
+ def _default_image_size(self) -> int:
241
+ return int(self.transformer.config.input_size) * self.vae_scale_factor
242
+
243
+ def check_inputs(
244
+ self,
245
+ height: int,
246
+ width: int,
247
+ num_inference_steps: int,
248
+ output_type: str,
249
+ ) -> None:
250
+ if num_inference_steps < 1:
251
+ raise ValueError("num_inference_steps must be >= 1.")
252
+ if output_type not in {"pil", "np", "pt", "latent"}:
253
+ raise ValueError("output_type must be one of: 'pil', 'np', 'pt', 'latent'.")
254
+ if height % self.vae_scale_factor != 0 or width % self.vae_scale_factor != 0:
255
+ raise ValueError(
256
+ f"height and width must be divisible by the VAE downsample factor {self.vae_scale_factor}."
257
+ )
258
+ latent_height = height // self.vae_scale_factor
259
+ latent_width = width // self.vae_scale_factor
260
+ expected_size = int(self.transformer.config.input_size)
261
+ if latent_height != expected_size or latent_width != expected_size:
262
+ raise ValueError(
263
+ f"Requested latent size {(latent_height, latent_width)} does not match the pretrained "
264
+ f"transformer input_size={expected_size}. Use height=width={self._default_image_size()}."
265
+ )
266
+
267
+ def prepare_latents(
268
+ self,
269
+ batch_size: int,
270
+ height: int,
271
+ width: int,
272
+ dtype: torch.dtype,
273
+ device: torch.device,
274
+ generator: Optional[Union[torch.Generator, List[torch.Generator]]],
275
+ ) -> torch.Tensor:
276
+ latent_height = height // self.vae_scale_factor
277
+ latent_width = width // self.vae_scale_factor
278
+ return randn_tensor(
279
+ (batch_size, self.transformer.config.in_channels, latent_height, latent_width),
280
+ generator=generator,
281
+ device=device,
282
+ dtype=dtype,
283
+ )
284
+
285
+ @staticmethod
286
+ def _expand_timestep(timestep, batch: int, device: torch.device) -> torch.Tensor:
287
+ if not torch.is_tensor(timestep):
288
+ timestep = torch.tensor([timestep], dtype=torch.long, device=device)
289
+ elif timestep.ndim == 0:
290
+ timestep = timestep[None].to(device=device)
291
+ return timestep.expand(batch)
292
+
293
+ @staticmethod
294
+ def _prepare_model_output_for_scheduler(
295
+ model_output: torch.Tensor,
296
+ latent_channels: int,
297
+ scheduler: KarrasDiffusionSchedulers,
298
+ ) -> torch.Tensor:
299
+ if model_output.shape[1] != 2 * latent_channels:
300
+ return model_output
301
+ variance_type = getattr(scheduler.config, "variance_type", None)
302
+ if scheduler.__class__.__name__ == "DDPMScheduler" and variance_type in ("learned", "learned_range"):
303
+ return model_output
304
+ model_output, _ = torch.split(model_output, latent_channels, dim=1)
305
+ return model_output
306
+
307
+ def decode_latents(self, latents: torch.Tensor, output_type: str = "pil"):
308
+ if output_type == "latent":
309
+ return latents
310
+ scaling_factor = getattr(self.vae.config, "scaling_factor", 0.18215)
311
+ image = self.vae.decode(latents / scaling_factor).sample
312
+ if output_type == "pt":
313
+ return image
314
+ return self.image_processor.postprocess(image, output_type=output_type)
315
+
316
+ @torch.inference_mode()
317
+ def __call__(
318
+ self,
319
+ class_labels: Union[int, str, List[Union[int, str]], torch.LongTensor],
320
+ height: Optional[int] = None,
321
+ width: Optional[int] = None,
322
+ num_inference_steps: int = 250,
323
+ guidance_scale: float = 1.0,
324
+ eta: float = 0.0,
325
+ generator: Optional[Union[torch.Generator, List[torch.Generator]]] = None,
326
+ output_type: str = "pil",
327
+ return_dict: bool = True,
328
+ ) -> Union[ImagePipelineOutput, Tuple]:
329
+ default_size = self._default_image_size()
330
+ height = int(height or default_size)
331
+ width = int(width or default_size)
332
+ self.check_inputs(height, width, num_inference_steps, output_type)
333
+
334
+ device = self._execution_device
335
+ model_dtype = next(self.transformer.parameters()).dtype
336
+ class_labels_tensor = self._normalize_class_labels(class_labels)
337
+ batch_size = class_labels_tensor.numel()
338
+ latent_channels = int(self.transformer.config.in_channels)
339
+ null_class_val = int(self.transformer.config.num_classes)
340
+ do_cfg = guidance_scale > 1.0
341
+
342
+ latents = self.prepare_latents(
343
+ batch_size=batch_size,
344
+ height=height,
345
+ width=width,
346
+ dtype=model_dtype,
347
+ device=device,
348
+ generator=generator,
349
+ )
350
+ latent_model_input = torch.cat([latents] * 2) if do_cfg else latents
351
+
352
+ class_labels_input = class_labels_tensor
353
+ if do_cfg:
354
+ class_null = torch.full_like(class_labels_tensor, null_class_val)
355
+ class_labels_input = torch.cat([class_labels_tensor, class_null], dim=0)
356
+
357
+ self.scheduler.set_timesteps(num_inference_steps, device=device)
358
+ extra_step_kwargs = self.prepare_extra_step_kwargs(self.scheduler, generator=generator, eta=eta)
359
+
360
+ for t in self.progress_bar(self.scheduler.timesteps):
361
+ if do_cfg:
362
+ half = latent_model_input[: len(latent_model_input) // 2]
363
+ latent_model_input = torch.cat([half, half], dim=0)
364
+ latent_model_input = self.scheduler.scale_model_input(latent_model_input, t)
365
+ timesteps = self._expand_timestep(t, latent_model_input.shape[0], latent_model_input.device)
366
+
367
+ noise_pred = self.transformer(
368
+ hidden_states=latent_model_input,
369
+ timestep=timesteps,
370
+ class_labels=class_labels_input,
371
+ return_dict=True,
372
+ ).sample
373
+
374
+ if do_cfg:
375
+ eps, rest = noise_pred[:, :latent_channels], noise_pred[:, latent_channels:]
376
+ cond_eps, uncond_eps = torch.split(eps, len(eps) // 2, dim=0)
377
+ half_eps = uncond_eps + guidance_scale * (cond_eps - uncond_eps)
378
+ eps = torch.cat([half_eps, half_eps], dim=0)
379
+ noise_pred = torch.cat([eps, rest], dim=1)
380
+
381
+ model_output = self._prepare_model_output_for_scheduler(noise_pred, latent_channels, self.scheduler)
382
+ latent_model_input = self.scheduler.step(
383
+ model_output, t, latent_model_input, return_dict=True, **extra_step_kwargs
384
+ ).prev_sample
385
+
386
+ if do_cfg:
387
+ latents, _ = latent_model_input.chunk(2, dim=0)
388
+ else:
389
+ latents = latent_model_input
390
+
391
+ image = self.decode_latents(latents, output_type=output_type)
392
+ self.maybe_free_model_hooks()
393
+ if not return_dict:
394
+ return (image,)
395
+ return ImagePipelineOutput(images=image)
396
+
397
+
398
+ DiCoPipelineOutput = ImagePipelineOutput
DiCo-S-256/scheduler/scheduler_config.json ADDED
@@ -0,0 +1,12 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "_class_name": "DDIMScheduler",
3
+ "_diffusers_version": "0.35.1",
4
+ "num_train_timesteps": 1000,
5
+ "beta_start": 0.0001,
6
+ "beta_end": 0.02,
7
+ "beta_schedule": "linear",
8
+ "clip_sample": false,
9
+ "set_alpha_to_one": true,
10
+ "steps_offset": 0,
11
+ "prediction_type": "epsilon"
12
+ }
DiCo-S-256/transformer/config.json ADDED
@@ -0,0 +1,14 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "_class_name": "DiCoTransformer2DModel",
3
+ "_diffusers_version": "0.38.0",
4
+ "class_dropout_prob": 0.1,
5
+ "depth": null,
6
+ "hidden_size": 416,
7
+ "in_channels": 4,
8
+ "input_size": 32,
9
+ "learn_sigma": true,
10
+ "mlp_ratio": 2.0,
11
+ "model_type": "DiCo-S",
12
+ "num_class_embeds": null,
13
+ "num_classes": 1000
14
+ }
DiCo-S-256/transformer/diffusion_pytorch_model.safetensors ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:a6965a778752599a0eef69505c7b603340ce74073d88e6c5dc7bb0ce4580e99a
3
+ size 132583104
DiCo-S-256/transformer/transformer_dico.py ADDED
@@ -0,0 +1,479 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Copyright 2026 The HuggingFace Team. All rights reserved.
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ from __future__ import annotations
16
+
17
+ import argparse
18
+ import math
19
+ from collections.abc import Mapping
20
+ from typing import Dict, Literal, Optional, Tuple
21
+
22
+ import torch
23
+ import torch.nn as nn
24
+ import torch.nn.functional as F
25
+
26
+ from diffusers.configuration_utils import ConfigMixin, register_to_config
27
+ from diffusers.models.modeling_outputs import Transformer2DModelOutput
28
+ from diffusers.models.modeling_utils import ModelMixin
29
+
30
+
31
+ DICO_PRESET_CONFIGS: Dict[str, Dict[str, object]] = {
32
+ "DiCo-S": {
33
+ "hidden_size": 128,
34
+ "depth": [5, 4, 4, 4, 4],
35
+ "mlp_ratio": 2.0,
36
+ },
37
+ "DiCo-B": {
38
+ "hidden_size": 256,
39
+ "depth": [5, 4, 4, 4, 4],
40
+ "mlp_ratio": 2.0,
41
+ },
42
+ "DiCo-L": {
43
+ "hidden_size": 352,
44
+ "depth": [9, 8, 9, 8, 9],
45
+ "mlp_ratio": 2.0,
46
+ },
47
+ "DiCo-XL": {
48
+ "hidden_size": 416,
49
+ "depth": [9, 9, 10, 9, 9],
50
+ "mlp_ratio": 2.0,
51
+ },
52
+ "DiCo-H": {
53
+ "hidden_size": 416,
54
+ "depth": [14, 12, 10, 12, 14],
55
+ "mlp_ratio": 4.0,
56
+ },
57
+ }
58
+
59
+
60
+ def remap_legacy_state_dict(state_dict: Dict[str, torch.Tensor]) -> Dict[str, torch.Tensor]:
61
+ """Map wrapper/backbone keys from legacy checkpoints to native model keys."""
62
+ remapped: Dict[str, torch.Tensor] = {}
63
+ for key, value in state_dict.items():
64
+ new_key = key
65
+ for prefix in ("transformer.", "model.", "net."):
66
+ if new_key.startswith(prefix):
67
+ new_key = new_key[len(prefix) :]
68
+ break
69
+ remapped[new_key] = value
70
+ return remapped
71
+
72
+
73
+ def infer_learn_sigma(state_dict: Dict[str, torch.Tensor], in_channels: int = 4) -> bool:
74
+ weight = state_dict.get("final_layer.out_proj.weight")
75
+ if weight is None:
76
+ return True
77
+ return int(weight.shape[0]) == in_channels * 2
78
+
79
+
80
+ def config_from_legacy(config: Dict[str, object]) -> Dict[str, object]:
81
+ """Build native config kwargs from a legacy config.json dict."""
82
+ model_type = config.get("model_type") or config.get("model_name") or config.get("model")
83
+ if model_type not in DICO_PRESET_CONFIGS:
84
+ raise ValueError(f"Unknown DiCo preset '{model_type}'. Known: {list(DICO_PRESET_CONFIGS)}")
85
+
86
+ preset = dict(DICO_PRESET_CONFIGS[model_type])
87
+ preset["num_classes"] = int(config.get("num_class_embeds") or config.get("num_classes") or 1000)
88
+ preset["model_type"] = model_type
89
+ preset["input_size"] = int(config.get("input_size") or config.get("sample_size") or 32)
90
+ if config.get("learn_sigma") is not None:
91
+ preset["learn_sigma"] = bool(config["learn_sigma"])
92
+ return preset
93
+
94
+
95
+ def modulate(x: torch.Tensor, shift: torch.Tensor, scale: torch.Tensor) -> torch.Tensor:
96
+ return x * (1 + scale.unsqueeze(-1).unsqueeze(-1)) + shift.unsqueeze(-1).unsqueeze(-1)
97
+
98
+
99
+ class LayerNorm2d(nn.LayerNorm):
100
+ def __init__(self, num_channels: int, eps: float = 1e-6, affine: bool = True):
101
+ super().__init__(num_channels, eps=eps, elementwise_affine=affine)
102
+
103
+ def forward(self, x: torch.Tensor) -> torch.Tensor:
104
+ x = x.permute(0, 2, 3, 1)
105
+ x = F.layer_norm(x, self.normalized_shape, self.weight, self.bias, self.eps)
106
+ return x.permute(0, 3, 1, 2)
107
+
108
+
109
+ class DiCoTimestepEmbedder(nn.Module):
110
+ def __init__(self, hidden_size: int, frequency_embedding_size: int = 256):
111
+ super().__init__()
112
+ self.mlp = nn.Sequential(
113
+ nn.Linear(frequency_embedding_size, hidden_size, bias=True),
114
+ nn.SiLU(),
115
+ nn.Linear(hidden_size, hidden_size, bias=True),
116
+ )
117
+ self.frequency_embedding_size = frequency_embedding_size
118
+
119
+ @staticmethod
120
+ def timestep_embedding(t: torch.Tensor, dim: int, max_period: int = 10000) -> torch.Tensor:
121
+ half = dim // 2
122
+ freqs = torch.exp(
123
+ -math.log(max_period) * torch.arange(start=0, end=half, dtype=torch.float32) / half
124
+ ).to(device=t.device)
125
+ args = t[:, None].float() * freqs[None]
126
+ embedding = torch.cat([torch.cos(args), torch.sin(args)], dim=-1)
127
+ if dim % 2:
128
+ embedding = torch.cat([embedding, torch.zeros_like(embedding[:, :1])], dim=-1)
129
+ return embedding
130
+
131
+ def forward(self, t: torch.Tensor) -> torch.Tensor:
132
+ t_freq = self.timestep_embedding(t, self.frequency_embedding_size)
133
+ weight_dtype = self.mlp[0].weight.dtype
134
+ return self.mlp(t_freq.to(dtype=weight_dtype))
135
+
136
+
137
+ class DiCoLabelEmbedder(nn.Module):
138
+ def __init__(self, num_classes: int, hidden_size: int, dropout_prob: float):
139
+ super().__init__()
140
+ use_cfg_embedding = dropout_prob > 0
141
+ self.embedding_table = nn.Embedding(num_classes + use_cfg_embedding, hidden_size)
142
+ self.num_classes = num_classes
143
+ self.dropout_prob = dropout_prob
144
+
145
+ def token_drop(self, labels: torch.Tensor, force_drop_ids: Optional[torch.Tensor] = None) -> torch.Tensor:
146
+ if force_drop_ids is None:
147
+ drop_ids = torch.rand(labels.shape[0], device=labels.device) < self.dropout_prob
148
+ else:
149
+ drop_ids = force_drop_ids == 1
150
+ return torch.where(drop_ids, self.num_classes, labels)
151
+
152
+ def forward(
153
+ self,
154
+ labels: torch.Tensor,
155
+ train: bool,
156
+ force_drop_ids: Optional[torch.Tensor] = None,
157
+ ) -> torch.Tensor:
158
+ use_dropout = self.dropout_prob > 0
159
+ if (train and use_dropout) or (force_drop_ids is not None):
160
+ labels = self.token_drop(labels, force_drop_ids)
161
+ return self.embedding_table(labels)
162
+
163
+
164
+ class DiCoMultiScaleLabelEmbedder(nn.Module):
165
+ def __init__(
166
+ self,
167
+ num_classes: int,
168
+ hidden_size_0: int,
169
+ hidden_size_1: int,
170
+ hidden_size_2: int,
171
+ dropout_prob: float,
172
+ ):
173
+ super().__init__()
174
+ use_cfg_embedding = dropout_prob > 0
175
+ self.embedding_table_0 = nn.Embedding(num_classes + use_cfg_embedding, hidden_size_0)
176
+ self.embedding_table_1 = nn.Embedding(num_classes + use_cfg_embedding, hidden_size_1)
177
+ self.embedding_table_2 = nn.Embedding(num_classes + use_cfg_embedding, hidden_size_2)
178
+ self.num_classes = num_classes
179
+ self.dropout_prob = dropout_prob
180
+
181
+ def token_drop(self, labels: torch.Tensor, force_drop_ids: Optional[torch.Tensor] = None) -> torch.Tensor:
182
+ if force_drop_ids is None:
183
+ drop_ids = torch.rand(labels.shape[0], device=labels.device) < self.dropout_prob
184
+ else:
185
+ drop_ids = force_drop_ids == 1
186
+ return torch.where(drop_ids, self.num_classes, labels)
187
+
188
+ def forward(
189
+ self,
190
+ labels: torch.Tensor,
191
+ train: bool,
192
+ force_drop_ids: Optional[torch.Tensor] = None,
193
+ ) -> Tuple[torch.Tensor, torch.Tensor, torch.Tensor]:
194
+ use_dropout = self.dropout_prob > 0
195
+ if (train and use_dropout) or (force_drop_ids is not None):
196
+ labels = self.token_drop(labels, force_drop_ids)
197
+ return (
198
+ self.embedding_table_0(labels),
199
+ self.embedding_table_1(labels),
200
+ self.embedding_table_2(labels),
201
+ )
202
+
203
+
204
+ class DiCoBlock(nn.Module):
205
+ def __init__(self, hidden_size: int, mlp_ratio: float = 4.0):
206
+ super().__init__()
207
+ self.conv1 = nn.Conv2d(hidden_size, hidden_size, kernel_size=1, padding=0, stride=1, groups=1, bias=True)
208
+ self.conv2 = nn.Conv2d(
209
+ hidden_size, hidden_size, kernel_size=3, padding=1, stride=1, groups=hidden_size, bias=True
210
+ )
211
+ self.conv3 = nn.Conv2d(hidden_size, hidden_size, kernel_size=1, padding=0, stride=1, groups=1, bias=True)
212
+ self.ca = nn.Sequential(
213
+ nn.AdaptiveAvgPool2d(1),
214
+ nn.Conv2d(hidden_size, hidden_size, kernel_size=1, padding=0, stride=1, groups=1, bias=True),
215
+ nn.Sigmoid(),
216
+ )
217
+ ffn_channel = int(mlp_ratio * hidden_size)
218
+ self.conv4 = nn.Conv2d(hidden_size, ffn_channel, kernel_size=1, padding=0, stride=1, groups=1, bias=True)
219
+ self.conv5 = nn.Conv2d(ffn_channel, hidden_size, kernel_size=1, padding=0, stride=1, groups=1, bias=True)
220
+ self.norm1 = LayerNorm2d(hidden_size, affine=False, eps=1e-6)
221
+ self.norm2 = LayerNorm2d(hidden_size, affine=False, eps=1e-6)
222
+ self.adaLN_modulation = nn.Sequential(nn.SiLU(), nn.Linear(hidden_size, 6 * hidden_size, bias=True))
223
+
224
+ def forward(self, inp: torch.Tensor, c: torch.Tensor) -> torch.Tensor:
225
+ shift_msa, scale_msa, gate_msa, shift_mlp, scale_mlp, gate_mlp = self.adaLN_modulation(c).chunk(6, dim=1)
226
+ x = modulate(self.norm1(inp), shift_msa, scale_msa)
227
+ x = F.gelu(self.conv2(self.conv1(x)))
228
+ x = x * self.ca(x)
229
+ x = self.conv3(x)
230
+ x = inp + gate_msa.unsqueeze(-1).unsqueeze(-1) * x
231
+ x = x + gate_mlp.unsqueeze(-1).unsqueeze(-1) * self.conv5(
232
+ F.gelu(self.conv4(modulate(self.norm2(x), shift_mlp, scale_mlp)))
233
+ )
234
+ return x
235
+
236
+
237
+ class DiCoFinalLayer(nn.Module):
238
+ def __init__(self, hidden_size: int, out_channels: int):
239
+ super().__init__()
240
+ self.norm_final = LayerNorm2d(hidden_size, affine=False, eps=1e-6)
241
+ self.out_proj = nn.Conv2d(hidden_size, out_channels, kernel_size=3, stride=1, padding=1, bias=True)
242
+ self.adaLN_modulation = nn.Sequential(nn.SiLU(), nn.Linear(hidden_size, 2 * hidden_size, bias=True))
243
+
244
+ def forward(self, x: torch.Tensor, c: torch.Tensor) -> torch.Tensor:
245
+ shift, scale = self.adaLN_modulation(c).chunk(2, dim=1)
246
+ x = modulate(self.norm_final(x), shift, scale)
247
+ return self.out_proj(x)
248
+
249
+
250
+ class OverlapPatchEmbed(nn.Module):
251
+ def __init__(self, in_c: int = 3, embed_dim: int = 48, bias: bool = False):
252
+ super().__init__()
253
+ self.proj = nn.Conv2d(in_c, embed_dim, kernel_size=3, stride=1, padding=1, bias=bias)
254
+
255
+ def forward(self, x: torch.Tensor) -> torch.Tensor:
256
+ return self.proj(x)
257
+
258
+
259
+ class Downsample(nn.Module):
260
+ def __init__(self, n_feat: int):
261
+ super().__init__()
262
+ self.body = nn.Sequential(
263
+ nn.Conv2d(n_feat, n_feat // 2, kernel_size=3, stride=1, padding=1, bias=False),
264
+ nn.PixelUnshuffle(2),
265
+ )
266
+
267
+ def forward(self, x: torch.Tensor) -> torch.Tensor:
268
+ return self.body(x)
269
+
270
+
271
+ class Upsample(nn.Module):
272
+ def __init__(self, n_feat: int):
273
+ super().__init__()
274
+ self.body = nn.Sequential(
275
+ nn.Conv2d(n_feat, n_feat * 2, kernel_size=3, stride=1, padding=1, bias=False),
276
+ nn.PixelShuffle(2),
277
+ )
278
+
279
+ def forward(self, x: torch.Tensor) -> torch.Tensor:
280
+ return self.body(x)
281
+
282
+
283
+ class DiCoTransformer2DModel(ModelMixin, ConfigMixin):
284
+ r"""
285
+ DiCo (Diffusion ConvNet) denoiser for class-conditional latent diffusion.
286
+
287
+ ConvNet U-Net backbone with multi-scale adaLN conditioning, operating on VAE latents.
288
+ """
289
+
290
+ _supports_gradient_checkpointing = True
291
+
292
+ @register_to_config
293
+ def __init__(
294
+ self,
295
+ input_size: int = 32,
296
+ in_channels: int = 4,
297
+ hidden_size: int = 416,
298
+ depth: Optional[list[int]] = None,
299
+ mlp_ratio: float = 2.0,
300
+ class_dropout_prob: float = 0.1,
301
+ num_classes: int = 1000,
302
+ learn_sigma: bool = True,
303
+ model_type: str | None = None,
304
+ num_class_embeds: int | None = None,
305
+ ):
306
+ super().__init__()
307
+ if num_class_embeds is not None:
308
+ num_classes = int(num_class_embeds)
309
+ if model_type in DICO_PRESET_CONFIGS:
310
+ preset = DICO_PRESET_CONFIGS[model_type]
311
+ hidden_size = int(preset["hidden_size"])
312
+ depth = list(preset["depth"])
313
+ mlp_ratio = float(preset["mlp_ratio"])
314
+
315
+ if depth is None:
316
+ depth = [9, 9, 10, 9, 9]
317
+
318
+ self.learn_sigma = learn_sigma
319
+ self.in_channels = in_channels
320
+ self.out_channels = in_channels * 2 if learn_sigma else in_channels
321
+ self.num_classes = num_classes
322
+ self.gradient_checkpointing = False
323
+
324
+ self.x_embedder = OverlapPatchEmbed(in_channels, hidden_size, bias=True)
325
+ self.t_embedder_1 = DiCoTimestepEmbedder(hidden_size)
326
+ self.y_embedder = DiCoMultiScaleLabelEmbedder(
327
+ num_classes, hidden_size, hidden_size * 2, hidden_size * 4, class_dropout_prob
328
+ )
329
+ self.t_embedder_2 = DiCoTimestepEmbedder(hidden_size * 2)
330
+ self.t_embedder_3 = DiCoTimestepEmbedder(hidden_size * 4)
331
+
332
+ self.encoder_level_1 = nn.ModuleList([DiCoBlock(hidden_size, mlp_ratio) for _ in range(depth[0])])
333
+ self.down1_2 = Downsample(hidden_size)
334
+ self.encoder_level_2 = nn.ModuleList([DiCoBlock(hidden_size * 2, mlp_ratio) for _ in range(depth[1])])
335
+ self.down2_3 = Downsample(hidden_size * 2)
336
+ self.latent = nn.ModuleList([DiCoBlock(hidden_size * 4, mlp_ratio) for _ in range(depth[2])])
337
+ self.up3_2 = Upsample(int(hidden_size * 4))
338
+ self.reduce_chan_level2 = nn.Conv2d(int(hidden_size * 4), int(hidden_size * 2), kernel_size=1, bias=True)
339
+ self.decoder_level_2 = nn.ModuleList([DiCoBlock(hidden_size * 2, mlp_ratio) for _ in range(depth[3])])
340
+ self.up2_1 = Upsample(int(hidden_size * 2))
341
+ self.reduce_chan_level1 = nn.Conv2d(int(hidden_size * 2), int(hidden_size * 2), kernel_size=1, bias=True)
342
+ self.decoder_level_1 = nn.ModuleList([DiCoBlock(hidden_size * 2, mlp_ratio) for _ in range(depth[4])])
343
+ self.final_layer = DiCoFinalLayer(hidden_size * 2, self.out_channels)
344
+ self.initialize_weights()
345
+
346
+ def initialize_weights(self) -> None:
347
+ def _basic_init(module: nn.Module):
348
+ if isinstance(module, (nn.Linear, nn.Conv2d)):
349
+ torch.nn.init.xavier_uniform_(module.weight)
350
+ if module.bias is not None:
351
+ nn.init.constant_(module.bias, 0)
352
+
353
+ self.apply(_basic_init)
354
+ w = self.x_embedder.proj.weight.data
355
+ nn.init.xavier_uniform_(w.view([w.shape[0], -1]))
356
+ nn.init.constant_(self.x_embedder.proj.bias, 0)
357
+ nn.init.normal_(self.y_embedder.embedding_table_0.weight, std=0.02)
358
+ nn.init.normal_(self.y_embedder.embedding_table_1.weight, std=0.02)
359
+ nn.init.normal_(self.y_embedder.embedding_table_2.weight, std=0.02)
360
+ for embedder in (self.t_embedder_1, self.t_embedder_2, self.t_embedder_3):
361
+ nn.init.normal_(embedder.mlp[0].weight, std=0.02)
362
+ nn.init.normal_(embedder.mlp[2].weight, std=0.02)
363
+
364
+ blocks = (
365
+ self.encoder_level_1
366
+ + self.encoder_level_2
367
+ + self.latent
368
+ + self.decoder_level_2
369
+ + self.decoder_level_1
370
+ )
371
+ for block in blocks:
372
+ nn.init.constant_(block.adaLN_modulation[-1].weight, 0)
373
+ nn.init.constant_(block.adaLN_modulation[-1].bias, 0)
374
+ nn.init.constant_(self.final_layer.adaLN_modulation[-1].weight, 0)
375
+ nn.init.constant_(self.final_layer.adaLN_modulation[-1].bias, 0)
376
+ nn.init.constant_(self.final_layer.out_proj.weight, 0)
377
+ nn.init.constant_(self.final_layer.out_proj.bias, 0)
378
+
379
+ def _run_block(self, block: DiCoBlock, x: torch.Tensor, c: torch.Tensor) -> torch.Tensor:
380
+ if self.training and self.gradient_checkpointing:
381
+ return torch.utils.checkpoint.checkpoint(block, x, c, use_reentrant=False)
382
+ return block(x, c)
383
+
384
+ def forward(
385
+ self,
386
+ hidden_states: torch.Tensor,
387
+ timestep: torch.LongTensor,
388
+ class_labels: torch.LongTensor,
389
+ force_drop_ids: Optional[torch.Tensor] = None,
390
+ return_dict: bool = True,
391
+ ) -> Transformer2DModelOutput | Tuple:
392
+ timestep = torch.as_tensor(timestep, device=hidden_states.device)
393
+ if timestep.ndim == 0:
394
+ timestep = timestep.repeat(hidden_states.shape[0])
395
+ else:
396
+ timestep = timestep.reshape(-1)
397
+ if timestep.shape[0] == 1 and hidden_states.shape[0] > 1:
398
+ timestep = timestep.repeat(hidden_states.shape[0])
399
+
400
+ x = self.x_embedder(hidden_states)
401
+ t1 = self.t_embedder_1(timestep)
402
+ y1, y2, y3 = self.y_embedder(class_labels, self.training, force_drop_ids=force_drop_ids)
403
+ c1 = t1 + y1
404
+ c2 = self.t_embedder_2(timestep) + y2
405
+ c3 = self.t_embedder_3(timestep) + y3
406
+
407
+ out_enc_level1 = x
408
+ for block in self.encoder_level_1:
409
+ out_enc_level1 = self._run_block(block, out_enc_level1, c1)
410
+ out_enc_level2 = self.down1_2(out_enc_level1)
411
+ for block in self.encoder_level_2:
412
+ out_enc_level2 = self._run_block(block, out_enc_level2, c2)
413
+ latent = self.down2_3(out_enc_level2)
414
+ for block in self.latent:
415
+ latent = self._run_block(block, latent, c3)
416
+
417
+ inp_dec_level2 = self.reduce_chan_level2(torch.cat([self.up3_2(latent), out_enc_level2], dim=1))
418
+ for block in self.decoder_level_2:
419
+ inp_dec_level2 = self._run_block(block, inp_dec_level2, c2)
420
+ inp_dec_level1 = self.reduce_chan_level1(torch.cat([self.up2_1(inp_dec_level2), out_enc_level1], dim=1))
421
+ for block in self.decoder_level_1:
422
+ inp_dec_level1 = self._run_block(block, inp_dec_level1, c2)
423
+
424
+ output = self.final_layer(inp_dec_level1, c2)
425
+ if not return_dict:
426
+ return (output,)
427
+ return Transformer2DModelOutput(sample=output)
428
+
429
+ @classmethod
430
+ def from_dico_checkpoint(
431
+ cls,
432
+ checkpoint_path: str,
433
+ weights: Literal["model", "ema"] = "ema",
434
+ map_location: str = "cpu",
435
+ strict: bool = True,
436
+ model_type: str | None = None,
437
+ ) -> Tuple["DiCoTransformer2DModel", Dict[str, object]]:
438
+ checkpoint = torch.load(checkpoint_path, map_location=map_location, weights_only=False)
439
+ state_dict = checkpoint
440
+ if isinstance(checkpoint, Mapping):
441
+ if weights in checkpoint:
442
+ state_dict = checkpoint[weights]
443
+ elif "state_dict" in checkpoint:
444
+ state_dict = checkpoint["state_dict"]
445
+
446
+ state_dict = remap_legacy_state_dict(state_dict)
447
+
448
+ ckpt_args = checkpoint.get("args") if isinstance(checkpoint, Mapping) else None
449
+ args_dict: Dict[str, object] = {}
450
+ if ckpt_args is not None:
451
+ if isinstance(ckpt_args, argparse.Namespace):
452
+ args_dict = vars(ckpt_args)
453
+ elif isinstance(ckpt_args, Mapping):
454
+ args_dict = dict(ckpt_args)
455
+
456
+ resolved_model_type = model_type or args_dict.get("model") or args_dict.get("model_type")
457
+ image_size = int(args_dict.get("image_size") or 256)
458
+ num_classes = int(args_dict.get("num_classes") or 1000)
459
+
460
+ config: Dict[str, object] = {
461
+ "input_size": image_size // 8,
462
+ "num_classes": num_classes,
463
+ "learn_sigma": infer_learn_sigma(state_dict),
464
+ }
465
+ if resolved_model_type in DICO_PRESET_CONFIGS:
466
+ config["model_type"] = resolved_model_type
467
+
468
+ model = cls(**config)
469
+ model.load_state_dict(state_dict, strict=strict)
470
+ metadata = {
471
+ "checkpoint_path": checkpoint_path,
472
+ "weights": weights,
473
+ "model_type": resolved_model_type,
474
+ "source_args": ckpt_args,
475
+ }
476
+ return model, metadata
477
+
478
+
479
+ DiCoDiffusersModel = DiCoTransformer2DModel
DiCo-S-256/vae/config.json ADDED
@@ -0,0 +1,38 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "_class_name": "AutoencoderKL",
3
+ "_diffusers_version": "0.38.0",
4
+ "_name_or_path": "stabilityai/sd-vae-ft-ema",
5
+ "act_fn": "silu",
6
+ "block_out_channels": [
7
+ 128,
8
+ 256,
9
+ 512,
10
+ 512
11
+ ],
12
+ "down_block_types": [
13
+ "DownEncoderBlock2D",
14
+ "DownEncoderBlock2D",
15
+ "DownEncoderBlock2D",
16
+ "DownEncoderBlock2D"
17
+ ],
18
+ "force_upcast": true,
19
+ "in_channels": 3,
20
+ "latent_channels": 4,
21
+ "latents_mean": null,
22
+ "latents_std": null,
23
+ "layers_per_block": 2,
24
+ "mid_block_add_attention": true,
25
+ "norm_num_groups": 32,
26
+ "out_channels": 3,
27
+ "sample_size": 256,
28
+ "scaling_factor": 0.18215,
29
+ "shift_factor": null,
30
+ "up_block_types": [
31
+ "UpDecoderBlock2D",
32
+ "UpDecoderBlock2D",
33
+ "UpDecoderBlock2D",
34
+ "UpDecoderBlock2D"
35
+ ],
36
+ "use_post_quant_conv": true,
37
+ "use_quant_conv": true
38
+ }
DiCo-S-256/vae/diffusion_pytorch_model.safetensors ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:703abdcd7c389316b5128faa9b750a530ea1680b453170b27afebac5e4db30c4
3
+ size 334643268
DiCo-XL-256/demo.png ADDED

Git LFS Details

  • SHA256: a6093a73928029e09dd9a59d22ed993c66cb7be9bfd8c21e3c967947764eab95
  • Pointer size: 131 Bytes
  • Size of remote file: 117 kB
DiCo-XL-256/model_index.json ADDED
@@ -0,0 +1,1021 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "_class_name": [
3
+ "pipeline",
4
+ "DiCoPipeline"
5
+ ],
6
+ "_diffusers_version": "0.38.0",
7
+ "scheduler": [
8
+ "diffusers",
9
+ "DDIMScheduler"
10
+ ],
11
+ "transformer": [
12
+ "transformer_dico",
13
+ "DiCoTransformer2DModel"
14
+ ],
15
+ "vae": [
16
+ "diffusers",
17
+ "AutoencoderKL"
18
+ ],
19
+ "id2label": {
20
+ "0": "tench, Tinca tinca",
21
+ "1": "goldfish, Carassius auratus",
22
+ "2": "great white shark, white shark, man-eater, man-eating shark, Carcharodon carcharias",
23
+ "3": "tiger shark, Galeocerdo cuvieri",
24
+ "4": "hammerhead, hammerhead shark",
25
+ "5": "electric ray, crampfish, numbfish, torpedo",
26
+ "6": "stingray",
27
+ "7": "cock",
28
+ "8": "hen",
29
+ "9": "ostrich, Struthio camelus",
30
+ "10": "brambling, Fringilla montifringilla",
31
+ "11": "goldfinch, Carduelis carduelis",
32
+ "12": "house finch, linnet, Carpodacus mexicanus",
33
+ "13": "junco, snowbird",
34
+ "14": "indigo bunting, indigo finch, indigo bird, Passerina cyanea",
35
+ "15": "robin, American robin, Turdus migratorius",
36
+ "16": "bulbul",
37
+ "17": "jay",
38
+ "18": "magpie",
39
+ "19": "chickadee",
40
+ "20": "water ouzel, dipper",
41
+ "21": "kite",
42
+ "22": "bald eagle, American eagle, Haliaeetus leucocephalus",
43
+ "23": "vulture",
44
+ "24": "great grey owl, great gray owl, Strix nebulosa",
45
+ "25": "European fire salamander, Salamandra salamandra",
46
+ "26": "common newt, Triturus vulgaris",
47
+ "27": "eft",
48
+ "28": "spotted salamander, Ambystoma maculatum",
49
+ "29": "axolotl, mud puppy, Ambystoma mexicanum",
50
+ "30": "bullfrog, Rana catesbeiana",
51
+ "31": "tree frog, tree-frog",
52
+ "32": "tailed frog, bell toad, ribbed toad, tailed toad, Ascaphus trui",
53
+ "33": "loggerhead, loggerhead turtle, Caretta caretta",
54
+ "34": "leatherback turtle, leatherback, leathery turtle, Dermochelys coriacea",
55
+ "35": "mud turtle",
56
+ "36": "terrapin",
57
+ "37": "box turtle, box tortoise",
58
+ "38": "banded gecko",
59
+ "39": "common iguana, iguana, Iguana iguana",
60
+ "40": "American chameleon, anole, Anolis carolinensis",
61
+ "41": "whiptail, whiptail lizard",
62
+ "42": "agama",
63
+ "43": "frilled lizard, Chlamydosaurus kingi",
64
+ "44": "alligator lizard",
65
+ "45": "Gila monster, Heloderma suspectum",
66
+ "46": "green lizard, Lacerta viridis",
67
+ "47": "African chameleon, Chamaeleo chamaeleon",
68
+ "48": "Komodo dragon, Komodo lizard, dragon lizard, giant lizard, Varanus komodoensis",
69
+ "49": "African crocodile, Nile crocodile, Crocodylus niloticus",
70
+ "50": "American alligator, Alligator mississipiensis",
71
+ "51": "triceratops",
72
+ "52": "thunder snake, worm snake, Carphophis amoenus",
73
+ "53": "ringneck snake, ring-necked snake, ring snake",
74
+ "54": "hognose snake, puff adder, sand viper",
75
+ "55": "green snake, grass snake",
76
+ "56": "king snake, kingsnake",
77
+ "57": "garter snake, grass snake",
78
+ "58": "water snake",
79
+ "59": "vine snake",
80
+ "60": "night snake, Hypsiglena torquata",
81
+ "61": "boa constrictor, Constrictor constrictor",
82
+ "62": "rock python, rock snake, Python sebae",
83
+ "63": "Indian cobra, Naja naja",
84
+ "64": "green mamba",
85
+ "65": "sea snake",
86
+ "66": "horned viper, cerastes, sand viper, horned asp, Cerastes cornutus",
87
+ "67": "diamondback, diamondback rattlesnake, Crotalus adamanteus",
88
+ "68": "sidewinder, horned rattlesnake, Crotalus cerastes",
89
+ "69": "trilobite",
90
+ "70": "harvestman, daddy longlegs, Phalangium opilio",
91
+ "71": "scorpion",
92
+ "72": "black and gold garden spider, Argiope aurantia",
93
+ "73": "barn spider, Araneus cavaticus",
94
+ "74": "garden spider, Aranea diademata",
95
+ "75": "black widow, Latrodectus mactans",
96
+ "76": "tarantula",
97
+ "77": "wolf spider, hunting spider",
98
+ "78": "tick",
99
+ "79": "centipede",
100
+ "80": "black grouse",
101
+ "81": "ptarmigan",
102
+ "82": "ruffed grouse, partridge, Bonasa umbellus",
103
+ "83": "prairie chicken, prairie grouse, prairie fowl",
104
+ "84": "peacock",
105
+ "85": "quail",
106
+ "86": "partridge",
107
+ "87": "African grey, African gray, Psittacus erithacus",
108
+ "88": "macaw",
109
+ "89": "sulphur-crested cockatoo, Kakatoe galerita, Cacatua galerita",
110
+ "90": "lorikeet",
111
+ "91": "coucal",
112
+ "92": "bee eater",
113
+ "93": "hornbill",
114
+ "94": "hummingbird",
115
+ "95": "jacamar",
116
+ "96": "toucan",
117
+ "97": "drake",
118
+ "98": "red-breasted merganser, Mergus serrator",
119
+ "99": "goose",
120
+ "100": "black swan, Cygnus atratus",
121
+ "101": "tusker",
122
+ "102": "echidna, spiny anteater, anteater",
123
+ "103": "platypus, duckbill, duckbilled platypus, duck-billed platypus, Ornithorhynchus anatinus",
124
+ "104": "wallaby, brush kangaroo",
125
+ "105": "koala, koala bear, kangaroo bear, native bear, Phascolarctos cinereus",
126
+ "106": "wombat",
127
+ "107": "jellyfish",
128
+ "108": "sea anemone, anemone",
129
+ "109": "brain coral",
130
+ "110": "flatworm, platyhelminth",
131
+ "111": "nematode, nematode worm, roundworm",
132
+ "112": "conch",
133
+ "113": "snail",
134
+ "114": "slug",
135
+ "115": "sea slug, nudibranch",
136
+ "116": "chiton, coat-of-mail shell, sea cradle, polyplacophore",
137
+ "117": "chambered nautilus, pearly nautilus, nautilus",
138
+ "118": "Dungeness crab, Cancer magister",
139
+ "119": "rock crab, Cancer irroratus",
140
+ "120": "fiddler crab",
141
+ "121": "king crab, Alaska crab, Alaskan king crab, Alaska king crab, Paralithodes camtschatica",
142
+ "122": "American lobster, Northern lobster, Maine lobster, Homarus americanus",
143
+ "123": "spiny lobster, langouste, rock lobster, crawfish, crayfish, sea crawfish",
144
+ "124": "crayfish, crawfish, crawdad, crawdaddy",
145
+ "125": "hermit crab",
146
+ "126": "isopod",
147
+ "127": "white stork, Ciconia ciconia",
148
+ "128": "black stork, Ciconia nigra",
149
+ "129": "spoonbill",
150
+ "130": "flamingo",
151
+ "131": "little blue heron, Egretta caerulea",
152
+ "132": "American egret, great white heron, Egretta albus",
153
+ "133": "bittern",
154
+ "134": "crane",
155
+ "135": "limpkin, Aramus pictus",
156
+ "136": "European gallinule, Porphyrio porphyrio",
157
+ "137": "American coot, marsh hen, mud hen, water hen, Fulica americana",
158
+ "138": "bustard",
159
+ "139": "ruddy turnstone, Arenaria interpres",
160
+ "140": "red-backed sandpiper, dunlin, Erolia alpina",
161
+ "141": "redshank, Tringa totanus",
162
+ "142": "dowitcher",
163
+ "143": "oystercatcher, oyster catcher",
164
+ "144": "pelican",
165
+ "145": "king penguin, Aptenodytes patagonica",
166
+ "146": "albatross, mollymawk",
167
+ "147": "grey whale, gray whale, devilfish, Eschrichtius gibbosus, Eschrichtius robustus",
168
+ "148": "killer whale, killer, orca, grampus, sea wolf, Orcinus orca",
169
+ "149": "dugong, Dugong dugon",
170
+ "150": "sea lion",
171
+ "151": "Chihuahua",
172
+ "152": "Japanese spaniel",
173
+ "153": "Maltese dog, Maltese terrier, Maltese",
174
+ "154": "Pekinese, Pekingese, Peke",
175
+ "155": "Shih-Tzu",
176
+ "156": "Blenheim spaniel",
177
+ "157": "papillon",
178
+ "158": "toy terrier",
179
+ "159": "Rhodesian ridgeback",
180
+ "160": "Afghan hound, Afghan",
181
+ "161": "basset, basset hound",
182
+ "162": "beagle",
183
+ "163": "bloodhound, sleuthhound",
184
+ "164": "bluetick",
185
+ "165": "black-and-tan coonhound",
186
+ "166": "Walker hound, Walker foxhound",
187
+ "167": "English foxhound",
188
+ "168": "redbone",
189
+ "169": "borzoi, Russian wolfhound",
190
+ "170": "Irish wolfhound",
191
+ "171": "Italian greyhound",
192
+ "172": "whippet",
193
+ "173": "Ibizan hound, Ibizan Podenco",
194
+ "174": "Norwegian elkhound, elkhound",
195
+ "175": "otterhound, otter hound",
196
+ "176": "Saluki, gazelle hound",
197
+ "177": "Scottish deerhound, deerhound",
198
+ "178": "Weimaraner",
199
+ "179": "Staffordshire bullterrier, Staffordshire bull terrier",
200
+ "180": "American Staffordshire terrier, Staffordshire terrier, American pit bull terrier, pit bull terrier",
201
+ "181": "Bedlington terrier",
202
+ "182": "Border terrier",
203
+ "183": "Kerry blue terrier",
204
+ "184": "Irish terrier",
205
+ "185": "Norfolk terrier",
206
+ "186": "Norwich terrier",
207
+ "187": "Yorkshire terrier",
208
+ "188": "wire-haired fox terrier",
209
+ "189": "Lakeland terrier",
210
+ "190": "Sealyham terrier, Sealyham",
211
+ "191": "Airedale, Airedale terrier",
212
+ "192": "cairn, cairn terrier",
213
+ "193": "Australian terrier",
214
+ "194": "Dandie Dinmont, Dandie Dinmont terrier",
215
+ "195": "Boston bull, Boston terrier",
216
+ "196": "miniature schnauzer",
217
+ "197": "giant schnauzer",
218
+ "198": "standard schnauzer",
219
+ "199": "Scotch terrier, Scottish terrier, Scottie",
220
+ "200": "Tibetan terrier, chrysanthemum dog",
221
+ "201": "silky terrier, Sydney silky",
222
+ "202": "soft-coated wheaten terrier",
223
+ "203": "West Highland white terrier",
224
+ "204": "Lhasa, Lhasa apso",
225
+ "205": "flat-coated retriever",
226
+ "206": "curly-coated retriever",
227
+ "207": "golden retriever",
228
+ "208": "Labrador retriever",
229
+ "209": "Chesapeake Bay retriever",
230
+ "210": "German short-haired pointer",
231
+ "211": "vizsla, Hungarian pointer",
232
+ "212": "English setter",
233
+ "213": "Irish setter, red setter",
234
+ "214": "Gordon setter",
235
+ "215": "Brittany spaniel",
236
+ "216": "clumber, clumber spaniel",
237
+ "217": "English springer, English springer spaniel",
238
+ "218": "Welsh springer spaniel",
239
+ "219": "cocker spaniel, English cocker spaniel, cocker",
240
+ "220": "Sussex spaniel",
241
+ "221": "Irish water spaniel",
242
+ "222": "kuvasz",
243
+ "223": "schipperke",
244
+ "224": "groenendael",
245
+ "225": "malinois",
246
+ "226": "briard",
247
+ "227": "kelpie",
248
+ "228": "komondor",
249
+ "229": "Old English sheepdog, bobtail",
250
+ "230": "Shetland sheepdog, Shetland sheep dog, Shetland",
251
+ "231": "collie",
252
+ "232": "Border collie",
253
+ "233": "Bouvier des Flandres, Bouviers des Flandres",
254
+ "234": "Rottweiler",
255
+ "235": "German shepherd, German shepherd dog, German police dog, alsatian",
256
+ "236": "Doberman, Doberman pinscher",
257
+ "237": "miniature pinscher",
258
+ "238": "Greater Swiss Mountain dog",
259
+ "239": "Bernese mountain dog",
260
+ "240": "Appenzeller",
261
+ "241": "EntleBucher",
262
+ "242": "boxer",
263
+ "243": "bull mastiff",
264
+ "244": "Tibetan mastiff",
265
+ "245": "French bulldog",
266
+ "246": "Great Dane",
267
+ "247": "Saint Bernard, St Bernard",
268
+ "248": "Eskimo dog, husky",
269
+ "249": "malamute, malemute, Alaskan malamute",
270
+ "250": "Siberian husky",
271
+ "251": "dalmatian, coach dog, carriage dog",
272
+ "252": "affenpinscher, monkey pinscher, monkey dog",
273
+ "253": "basenji",
274
+ "254": "pug, pug-dog",
275
+ "255": "Leonberg",
276
+ "256": "Newfoundland, Newfoundland dog",
277
+ "257": "Great Pyrenees",
278
+ "258": "Samoyed, Samoyede",
279
+ "259": "Pomeranian",
280
+ "260": "chow, chow chow",
281
+ "261": "keeshond",
282
+ "262": "Brabancon griffon",
283
+ "263": "Pembroke, Pembroke Welsh corgi",
284
+ "264": "Cardigan, Cardigan Welsh corgi",
285
+ "265": "toy poodle",
286
+ "266": "miniature poodle",
287
+ "267": "standard poodle",
288
+ "268": "Mexican hairless",
289
+ "269": "timber wolf, grey wolf, gray wolf, Canis lupus",
290
+ "270": "white wolf, Arctic wolf, Canis lupus tundrarum",
291
+ "271": "red wolf, maned wolf, Canis rufus, Canis niger",
292
+ "272": "coyote, prairie wolf, brush wolf, Canis latrans",
293
+ "273": "dingo, warrigal, warragal, Canis dingo",
294
+ "274": "dhole, Cuon alpinus",
295
+ "275": "African hunting dog, hyena dog, Cape hunting dog, Lycaon pictus",
296
+ "276": "hyena, hyaena",
297
+ "277": "red fox, Vulpes vulpes",
298
+ "278": "kit fox, Vulpes macrotis",
299
+ "279": "Arctic fox, white fox, Alopex lagopus",
300
+ "280": "grey fox, gray fox, Urocyon cinereoargenteus",
301
+ "281": "tabby, tabby cat",
302
+ "282": "tiger cat",
303
+ "283": "Persian cat",
304
+ "284": "Siamese cat, Siamese",
305
+ "285": "Egyptian cat",
306
+ "286": "cougar, puma, catamount, mountain lion, painter, panther, Felis concolor",
307
+ "287": "lynx, catamount",
308
+ "288": "leopard, Panthera pardus",
309
+ "289": "snow leopard, ounce, Panthera uncia",
310
+ "290": "jaguar, panther, Panthera onca, Felis onca",
311
+ "291": "lion, king of beasts, Panthera leo",
312
+ "292": "tiger, Panthera tigris",
313
+ "293": "cheetah, chetah, Acinonyx jubatus",
314
+ "294": "brown bear, bruin, Ursus arctos",
315
+ "295": "American black bear, black bear, Ursus americanus, Euarctos americanus",
316
+ "296": "ice bear, polar bear, Ursus Maritimus, Thalarctos maritimus",
317
+ "297": "sloth bear, Melursus ursinus, Ursus ursinus",
318
+ "298": "mongoose",
319
+ "299": "meerkat, mierkat",
320
+ "300": "tiger beetle",
321
+ "301": "ladybug, ladybeetle, lady beetle, ladybird, ladybird beetle",
322
+ "302": "ground beetle, carabid beetle",
323
+ "303": "long-horned beetle, longicorn, longicorn beetle",
324
+ "304": "leaf beetle, chrysomelid",
325
+ "305": "dung beetle",
326
+ "306": "rhinoceros beetle",
327
+ "307": "weevil",
328
+ "308": "fly",
329
+ "309": "bee",
330
+ "310": "ant, emmet, pismire",
331
+ "311": "grasshopper, hopper",
332
+ "312": "cricket",
333
+ "313": "walking stick, walkingstick, stick insect",
334
+ "314": "cockroach, roach",
335
+ "315": "mantis, mantid",
336
+ "316": "cicada, cicala",
337
+ "317": "leafhopper",
338
+ "318": "lacewing, lacewing fly",
339
+ "319": "dragonfly, darning needle, devils darning needle, sewing needle, snake feeder, snake doctor, mosquito hawk, skeeter hawk",
340
+ "320": "damselfly",
341
+ "321": "admiral",
342
+ "322": "ringlet, ringlet butterfly",
343
+ "323": "monarch, monarch butterfly, milkweed butterfly, Danaus plexippus",
344
+ "324": "cabbage butterfly",
345
+ "325": "sulphur butterfly, sulfur butterfly",
346
+ "326": "lycaenid, lycaenid butterfly",
347
+ "327": "starfish, sea star",
348
+ "328": "sea urchin",
349
+ "329": "sea cucumber, holothurian",
350
+ "330": "wood rabbit, cottontail, cottontail rabbit",
351
+ "331": "hare",
352
+ "332": "Angora, Angora rabbit",
353
+ "333": "hamster",
354
+ "334": "porcupine, hedgehog",
355
+ "335": "fox squirrel, eastern fox squirrel, Sciurus niger",
356
+ "336": "marmot",
357
+ "337": "beaver",
358
+ "338": "guinea pig, Cavia cobaya",
359
+ "339": "sorrel",
360
+ "340": "zebra",
361
+ "341": "hog, pig, grunter, squealer, Sus scrofa",
362
+ "342": "wild boar, boar, Sus scrofa",
363
+ "343": "warthog",
364
+ "344": "hippopotamus, hippo, river horse, Hippopotamus amphibius",
365
+ "345": "ox",
366
+ "346": "water buffalo, water ox, Asiatic buffalo, Bubalus bubalis",
367
+ "347": "bison",
368
+ "348": "ram, tup",
369
+ "349": "bighorn, bighorn sheep, cimarron, Rocky Mountain bighorn, Rocky Mountain sheep, Ovis canadensis",
370
+ "350": "ibex, Capra ibex",
371
+ "351": "hartebeest",
372
+ "352": "impala, Aepyceros melampus",
373
+ "353": "gazelle",
374
+ "354": "Arabian camel, dromedary, Camelus dromedarius",
375
+ "355": "llama",
376
+ "356": "weasel",
377
+ "357": "mink",
378
+ "358": "polecat, fitch, foulmart, foumart, Mustela putorius",
379
+ "359": "black-footed ferret, ferret, Mustela nigripes",
380
+ "360": "otter",
381
+ "361": "skunk, polecat, wood pussy",
382
+ "362": "badger",
383
+ "363": "armadillo",
384
+ "364": "three-toed sloth, ai, Bradypus tridactylus",
385
+ "365": "orangutan, orang, orangutang, Pongo pygmaeus",
386
+ "366": "gorilla, Gorilla gorilla",
387
+ "367": "chimpanzee, chimp, Pan troglodytes",
388
+ "368": "gibbon, Hylobates lar",
389
+ "369": "siamang, Hylobates syndactylus, Symphalangus syndactylus",
390
+ "370": "guenon, guenon monkey",
391
+ "371": "patas, hussar monkey, Erythrocebus patas",
392
+ "372": "baboon",
393
+ "373": "macaque",
394
+ "374": "langur",
395
+ "375": "colobus, colobus monkey",
396
+ "376": "proboscis monkey, Nasalis larvatus",
397
+ "377": "marmoset",
398
+ "378": "capuchin, ringtail, Cebus capucinus",
399
+ "379": "howler monkey, howler",
400
+ "380": "titi, titi monkey",
401
+ "381": "spider monkey, Ateles geoffroyi",
402
+ "382": "squirrel monkey, Saimiri sciureus",
403
+ "383": "Madagascar cat, ring-tailed lemur, Lemur catta",
404
+ "384": "indri, indris, Indri indri, Indri brevicaudatus",
405
+ "385": "Indian elephant, Elephas maximus",
406
+ "386": "African elephant, Loxodonta africana",
407
+ "387": "lesser panda, red panda, panda, bear cat, cat bear, Ailurus fulgens",
408
+ "388": "giant panda, panda, panda bear, coon bear, Ailuropoda melanoleuca",
409
+ "389": "barracouta, snoek",
410
+ "390": "eel",
411
+ "391": "coho, cohoe, coho salmon, blue jack, silver salmon, Oncorhynchus kisutch",
412
+ "392": "rock beauty, Holocanthus tricolor",
413
+ "393": "anemone fish",
414
+ "394": "sturgeon",
415
+ "395": "gar, garfish, garpike, billfish, Lepisosteus osseus",
416
+ "396": "lionfish",
417
+ "397": "puffer, pufferfish, blowfish, globefish",
418
+ "398": "abacus",
419
+ "399": "abaya",
420
+ "400": "academic gown, academic robe, judge robe",
421
+ "401": "accordion, piano accordion, squeeze box",
422
+ "402": "acoustic guitar",
423
+ "403": "aircraft carrier, carrier, flattop, attack aircraft carrier",
424
+ "404": "airliner",
425
+ "405": "airship, dirigible",
426
+ "406": "altar",
427
+ "407": "ambulance",
428
+ "408": "amphibian, amphibious vehicle",
429
+ "409": "analog clock",
430
+ "410": "apiary, bee house",
431
+ "411": "apron",
432
+ "412": "ashcan, trash can, garbage can, wastebin, ash bin, ash-bin, ashbin, dustbin, trash barrel, trash bin",
433
+ "413": "assault rifle, assault gun",
434
+ "414": "backpack, back pack, knapsack, packsack, rucksack, haversack",
435
+ "415": "bakery, bakeshop, bakehouse",
436
+ "416": "balance beam, beam",
437
+ "417": "balloon",
438
+ "418": "ballpoint, ballpoint pen, ballpen, Biro",
439
+ "419": "Band Aid",
440
+ "420": "banjo",
441
+ "421": "bannister, banister, balustrade, balusters, handrail",
442
+ "422": "barbell",
443
+ "423": "barber chair",
444
+ "424": "barbershop",
445
+ "425": "barn",
446
+ "426": "barometer",
447
+ "427": "barrel, cask",
448
+ "428": "barrow, garden cart, lawn cart, wheelbarrow",
449
+ "429": "baseball",
450
+ "430": "basketball",
451
+ "431": "bassinet",
452
+ "432": "bassoon",
453
+ "433": "bathing cap, swimming cap",
454
+ "434": "bath towel",
455
+ "435": "bathtub, bathing tub, bath, tub",
456
+ "436": "beach wagon, station wagon, wagon, estate car, beach waggon, station waggon, waggon",
457
+ "437": "beacon, lighthouse, beacon light, pharos",
458
+ "438": "beaker",
459
+ "439": "bearskin, busby, shako",
460
+ "440": "beer bottle",
461
+ "441": "beer glass",
462
+ "442": "bell cote, bell cot",
463
+ "443": "bib",
464
+ "444": "bicycle-built-for-two, tandem bicycle, tandem",
465
+ "445": "bikini, two-piece",
466
+ "446": "binder, ring-binder",
467
+ "447": "binoculars, field glasses, opera glasses",
468
+ "448": "birdhouse",
469
+ "449": "boathouse",
470
+ "450": "bobsled, bobsleigh, bob",
471
+ "451": "bolo tie, bolo, bola tie, bola",
472
+ "452": "bonnet, poke bonnet",
473
+ "453": "bookcase",
474
+ "454": "bookshop, bookstore, bookstall",
475
+ "455": "bottlecap",
476
+ "456": "bow",
477
+ "457": "bow tie, bow-tie, bowtie",
478
+ "458": "brass, memorial tablet, plaque",
479
+ "459": "brassiere, bra, bandeau",
480
+ "460": "breakwater, groin, groyne, mole, bulwark, seawall, jetty",
481
+ "461": "breastplate, aegis, egis",
482
+ "462": "broom",
483
+ "463": "bucket, pail",
484
+ "464": "buckle",
485
+ "465": "bulletproof vest",
486
+ "466": "bullet train, bullet",
487
+ "467": "butcher shop, meat market",
488
+ "468": "cab, hack, taxi, taxicab",
489
+ "469": "caldron, cauldron",
490
+ "470": "candle, taper, wax light",
491
+ "471": "cannon",
492
+ "472": "canoe",
493
+ "473": "can opener, tin opener",
494
+ "474": "cardigan",
495
+ "475": "car mirror",
496
+ "476": "carousel, carrousel, merry-go-round, roundabout, whirligig",
497
+ "477": "carpenters kit, tool kit",
498
+ "478": "carton",
499
+ "479": "car wheel",
500
+ "480": "cash machine, cash dispenser, automated teller machine, automatic teller machine, automated teller, automatic teller, ATM",
501
+ "481": "cassette",
502
+ "482": "cassette player",
503
+ "483": "castle",
504
+ "484": "catamaran",
505
+ "485": "CD player",
506
+ "486": "cello, violoncello",
507
+ "487": "cellular telephone, cellular phone, cellphone, cell, mobile phone",
508
+ "488": "chain",
509
+ "489": "chainlink fence",
510
+ "490": "chain mail, ring mail, mail, chain armor, chain armour, ring armor, ring armour",
511
+ "491": "chain saw, chainsaw",
512
+ "492": "chest",
513
+ "493": "chiffonier, commode",
514
+ "494": "chime, bell, gong",
515
+ "495": "china cabinet, china closet",
516
+ "496": "Christmas stocking",
517
+ "497": "church, church building",
518
+ "498": "cinema, movie theater, movie theatre, movie house, picture palace",
519
+ "499": "cleaver, meat cleaver, chopper",
520
+ "500": "cliff dwelling",
521
+ "501": "cloak",
522
+ "502": "clog, geta, patten, sabot",
523
+ "503": "cocktail shaker",
524
+ "504": "coffee mug",
525
+ "505": "coffeepot",
526
+ "506": "coil, spiral, volute, whorl, helix",
527
+ "507": "combination lock",
528
+ "508": "computer keyboard, keypad",
529
+ "509": "confectionery, confectionary, candy store",
530
+ "510": "container ship, containership, container vessel",
531
+ "511": "convertible",
532
+ "512": "corkscrew, bottle screw",
533
+ "513": "cornet, horn, trumpet, trump",
534
+ "514": "cowboy boot",
535
+ "515": "cowboy hat, ten-gallon hat",
536
+ "516": "cradle",
537
+ "517": "crane",
538
+ "518": "crash helmet",
539
+ "519": "crate",
540
+ "520": "crib, cot",
541
+ "521": "Crock Pot",
542
+ "522": "croquet ball",
543
+ "523": "crutch",
544
+ "524": "cuirass",
545
+ "525": "dam, dike, dyke",
546
+ "526": "desk",
547
+ "527": "desktop computer",
548
+ "528": "dial telephone, dial phone",
549
+ "529": "diaper, nappy, napkin",
550
+ "530": "digital clock",
551
+ "531": "digital watch",
552
+ "532": "dining table, board",
553
+ "533": "dishrag, dishcloth",
554
+ "534": "dishwasher, dish washer, dishwashing machine",
555
+ "535": "disk brake, disc brake",
556
+ "536": "dock, dockage, docking facility",
557
+ "537": "dogsled, dog sled, dog sleigh",
558
+ "538": "dome",
559
+ "539": "doormat, welcome mat",
560
+ "540": "drilling platform, offshore rig",
561
+ "541": "drum, membranophone, tympan",
562
+ "542": "drumstick",
563
+ "543": "dumbbell",
564
+ "544": "Dutch oven",
565
+ "545": "electric fan, blower",
566
+ "546": "electric guitar",
567
+ "547": "electric locomotive",
568
+ "548": "entertainment center",
569
+ "549": "envelope",
570
+ "550": "espresso maker",
571
+ "551": "face powder",
572
+ "552": "feather boa, boa",
573
+ "553": "file, file cabinet, filing cabinet",
574
+ "554": "fireboat",
575
+ "555": "fire engine, fire truck",
576
+ "556": "fire screen, fireguard",
577
+ "557": "flagpole, flagstaff",
578
+ "558": "flute, transverse flute",
579
+ "559": "folding chair",
580
+ "560": "football helmet",
581
+ "561": "forklift",
582
+ "562": "fountain",
583
+ "563": "fountain pen",
584
+ "564": "four-poster",
585
+ "565": "freight car",
586
+ "566": "French horn, horn",
587
+ "567": "frying pan, frypan, skillet",
588
+ "568": "fur coat",
589
+ "569": "garbage truck, dustcart",
590
+ "570": "gasmask, respirator, gas helmet",
591
+ "571": "gas pump, gasoline pump, petrol pump, island dispenser",
592
+ "572": "goblet",
593
+ "573": "go-kart",
594
+ "574": "golf ball",
595
+ "575": "golfcart, golf cart",
596
+ "576": "gondola",
597
+ "577": "gong, tam-tam",
598
+ "578": "gown",
599
+ "579": "grand piano, grand",
600
+ "580": "greenhouse, nursery, glasshouse",
601
+ "581": "grille, radiator grille",
602
+ "582": "grocery store, grocery, food market, market",
603
+ "583": "guillotine",
604
+ "584": "hair slide",
605
+ "585": "hair spray",
606
+ "586": "half track",
607
+ "587": "hammer",
608
+ "588": "hamper",
609
+ "589": "hand blower, blow dryer, blow drier, hair dryer, hair drier",
610
+ "590": "hand-held computer, hand-held microcomputer",
611
+ "591": "handkerchief, hankie, hanky, hankey",
612
+ "592": "hard disc, hard disk, fixed disk",
613
+ "593": "harmonica, mouth organ, harp, mouth harp",
614
+ "594": "harp",
615
+ "595": "harvester, reaper",
616
+ "596": "hatchet",
617
+ "597": "holster",
618
+ "598": "home theater, home theatre",
619
+ "599": "honeycomb",
620
+ "600": "hook, claw",
621
+ "601": "hoopskirt, crinoline",
622
+ "602": "horizontal bar, high bar",
623
+ "603": "horse cart, horse-cart",
624
+ "604": "hourglass",
625
+ "605": "iPod",
626
+ "606": "iron, smoothing iron",
627
+ "607": "jack-o-lantern",
628
+ "608": "jean, blue jean, denim",
629
+ "609": "jeep, landrover",
630
+ "610": "jersey, T-shirt, tee shirt",
631
+ "611": "jigsaw puzzle",
632
+ "612": "jinrikisha, ricksha, rickshaw",
633
+ "613": "joystick",
634
+ "614": "kimono",
635
+ "615": "knee pad",
636
+ "616": "knot",
637
+ "617": "lab coat, laboratory coat",
638
+ "618": "ladle",
639
+ "619": "lampshade, lamp shade",
640
+ "620": "laptop, laptop computer",
641
+ "621": "lawn mower, mower",
642
+ "622": "lens cap, lens cover",
643
+ "623": "letter opener, paper knife, paperknife",
644
+ "624": "library",
645
+ "625": "lifeboat",
646
+ "626": "lighter, light, igniter, ignitor",
647
+ "627": "limousine, limo",
648
+ "628": "liner, ocean liner",
649
+ "629": "lipstick, lip rouge",
650
+ "630": "Loafer",
651
+ "631": "lotion",
652
+ "632": "loudspeaker, speaker, speaker unit, loudspeaker system, speaker system",
653
+ "633": "loupe, jewelers loupe",
654
+ "634": "lumbermill, sawmill",
655
+ "635": "magnetic compass",
656
+ "636": "mailbag, postbag",
657
+ "637": "mailbox, letter box",
658
+ "638": "maillot",
659
+ "639": "maillot, tank suit",
660
+ "640": "manhole cover",
661
+ "641": "maraca",
662
+ "642": "marimba, xylophone",
663
+ "643": "mask",
664
+ "644": "matchstick",
665
+ "645": "maypole",
666
+ "646": "maze, labyrinth",
667
+ "647": "measuring cup",
668
+ "648": "medicine chest, medicine cabinet",
669
+ "649": "megalith, megalithic structure",
670
+ "650": "microphone, mike",
671
+ "651": "microwave, microwave oven",
672
+ "652": "military uniform",
673
+ "653": "milk can",
674
+ "654": "minibus",
675
+ "655": "miniskirt, mini",
676
+ "656": "minivan",
677
+ "657": "missile",
678
+ "658": "mitten",
679
+ "659": "mixing bowl",
680
+ "660": "mobile home, manufactured home",
681
+ "661": "Model T",
682
+ "662": "modem",
683
+ "663": "monastery",
684
+ "664": "monitor",
685
+ "665": "moped",
686
+ "666": "mortar",
687
+ "667": "mortarboard",
688
+ "668": "mosque",
689
+ "669": "mosquito net",
690
+ "670": "motor scooter, scooter",
691
+ "671": "mountain bike, all-terrain bike, off-roader",
692
+ "672": "mountain tent",
693
+ "673": "mouse, computer mouse",
694
+ "674": "mousetrap",
695
+ "675": "moving van",
696
+ "676": "muzzle",
697
+ "677": "nail",
698
+ "678": "neck brace",
699
+ "679": "necklace",
700
+ "680": "nipple",
701
+ "681": "notebook, notebook computer",
702
+ "682": "obelisk",
703
+ "683": "oboe, hautboy, hautbois",
704
+ "684": "ocarina, sweet potato",
705
+ "685": "odometer, hodometer, mileometer, milometer",
706
+ "686": "oil filter",
707
+ "687": "organ, pipe organ",
708
+ "688": "oscilloscope, scope, cathode-ray oscilloscope, CRO",
709
+ "689": "overskirt",
710
+ "690": "oxcart",
711
+ "691": "oxygen mask",
712
+ "692": "packet",
713
+ "693": "paddle, boat paddle",
714
+ "694": "paddlewheel, paddle wheel",
715
+ "695": "padlock",
716
+ "696": "paintbrush",
717
+ "697": "pajama, pyjama, pjs, jammies",
718
+ "698": "palace",
719
+ "699": "panpipe, pandean pipe, syrinx",
720
+ "700": "paper towel",
721
+ "701": "parachute, chute",
722
+ "702": "parallel bars, bars",
723
+ "703": "park bench",
724
+ "704": "parking meter",
725
+ "705": "passenger car, coach, carriage",
726
+ "706": "patio, terrace",
727
+ "707": "pay-phone, pay-station",
728
+ "708": "pedestal, plinth, footstall",
729
+ "709": "pencil box, pencil case",
730
+ "710": "pencil sharpener",
731
+ "711": "perfume, essence",
732
+ "712": "Petri dish",
733
+ "713": "photocopier",
734
+ "714": "pick, plectrum, plectron",
735
+ "715": "pickelhaube",
736
+ "716": "picket fence, paling",
737
+ "717": "pickup, pickup truck",
738
+ "718": "pier",
739
+ "719": "piggy bank, penny bank",
740
+ "720": "pill bottle",
741
+ "721": "pillow",
742
+ "722": "ping-pong ball",
743
+ "723": "pinwheel",
744
+ "724": "pirate, pirate ship",
745
+ "725": "pitcher, ewer",
746
+ "726": "plane, carpenters plane, woodworking plane",
747
+ "727": "planetarium",
748
+ "728": "plastic bag",
749
+ "729": "plate rack",
750
+ "730": "plow, plough",
751
+ "731": "plunger, plumbers helper",
752
+ "732": "Polaroid camera, Polaroid Land camera",
753
+ "733": "pole",
754
+ "734": "police van, police wagon, paddy wagon, patrol wagon, wagon, black Maria",
755
+ "735": "poncho",
756
+ "736": "pool table, billiard table, snooker table",
757
+ "737": "pop bottle, soda bottle",
758
+ "738": "pot, flowerpot",
759
+ "739": "potters wheel",
760
+ "740": "power drill",
761
+ "741": "prayer rug, prayer mat",
762
+ "742": "printer",
763
+ "743": "prison, prison house",
764
+ "744": "projectile, missile",
765
+ "745": "projector",
766
+ "746": "puck, hockey puck",
767
+ "747": "punching bag, punch bag, punching ball, punchball",
768
+ "748": "purse",
769
+ "749": "quill, quill pen",
770
+ "750": "quilt, comforter, comfort, puff",
771
+ "751": "racer, race car, racing car",
772
+ "752": "racket, racquet",
773
+ "753": "radiator",
774
+ "754": "radio, wireless",
775
+ "755": "radio telescope, radio reflector",
776
+ "756": "rain barrel",
777
+ "757": "recreational vehicle, RV, R.V.",
778
+ "758": "reel",
779
+ "759": "reflex camera",
780
+ "760": "refrigerator, icebox",
781
+ "761": "remote control, remote",
782
+ "762": "restaurant, eating house, eating place, eatery",
783
+ "763": "revolver, six-gun, six-shooter",
784
+ "764": "rifle",
785
+ "765": "rocking chair, rocker",
786
+ "766": "rotisserie",
787
+ "767": "rubber eraser, rubber, pencil eraser",
788
+ "768": "rugby ball",
789
+ "769": "rule, ruler",
790
+ "770": "running shoe",
791
+ "771": "safe",
792
+ "772": "safety pin",
793
+ "773": "saltshaker, salt shaker",
794
+ "774": "sandal",
795
+ "775": "sarong",
796
+ "776": "sax, saxophone",
797
+ "777": "scabbard",
798
+ "778": "scale, weighing machine",
799
+ "779": "school bus",
800
+ "780": "schooner",
801
+ "781": "scoreboard",
802
+ "782": "screen, CRT screen",
803
+ "783": "screw",
804
+ "784": "screwdriver",
805
+ "785": "seat belt, seatbelt",
806
+ "786": "sewing machine",
807
+ "787": "shield, buckler",
808
+ "788": "shoe shop, shoe-shop, shoe store",
809
+ "789": "shoji",
810
+ "790": "shopping basket",
811
+ "791": "shopping cart",
812
+ "792": "shovel",
813
+ "793": "shower cap",
814
+ "794": "shower curtain",
815
+ "795": "ski",
816
+ "796": "ski mask",
817
+ "797": "sleeping bag",
818
+ "798": "slide rule, slipstick",
819
+ "799": "sliding door",
820
+ "800": "slot, one-armed bandit",
821
+ "801": "snorkel",
822
+ "802": "snowmobile",
823
+ "803": "snowplow, snowplough",
824
+ "804": "soap dispenser",
825
+ "805": "soccer ball",
826
+ "806": "sock",
827
+ "807": "solar dish, solar collector, solar furnace",
828
+ "808": "sombrero",
829
+ "809": "soup bowl",
830
+ "810": "space bar",
831
+ "811": "space heater",
832
+ "812": "space shuttle",
833
+ "813": "spatula",
834
+ "814": "speedboat",
835
+ "815": "spider web, spiders web",
836
+ "816": "spindle",
837
+ "817": "sports car, sport car",
838
+ "818": "spotlight, spot",
839
+ "819": "stage",
840
+ "820": "steam locomotive",
841
+ "821": "steel arch bridge",
842
+ "822": "steel drum",
843
+ "823": "stethoscope",
844
+ "824": "stole",
845
+ "825": "stone wall",
846
+ "826": "stopwatch, stop watch",
847
+ "827": "stove",
848
+ "828": "strainer",
849
+ "829": "streetcar, tram, tramcar, trolley, trolley car",
850
+ "830": "stretcher",
851
+ "831": "studio couch, day bed",
852
+ "832": "stupa, tope",
853
+ "833": "submarine, pigboat, sub, U-boat",
854
+ "834": "suit, suit of clothes",
855
+ "835": "sundial",
856
+ "836": "sunglass",
857
+ "837": "sunglasses, dark glasses, shades",
858
+ "838": "sunscreen, sunblock, sun blocker",
859
+ "839": "suspension bridge",
860
+ "840": "swab, swob, mop",
861
+ "841": "sweatshirt",
862
+ "842": "swimming trunks, bathing trunks",
863
+ "843": "swing",
864
+ "844": "switch, electric switch, electrical switch",
865
+ "845": "syringe",
866
+ "846": "table lamp",
867
+ "847": "tank, army tank, armored combat vehicle, armoured combat vehicle",
868
+ "848": "tape player",
869
+ "849": "teapot",
870
+ "850": "teddy, teddy bear",
871
+ "851": "television, television system",
872
+ "852": "tennis ball",
873
+ "853": "thatch, thatched roof",
874
+ "854": "theater curtain, theatre curtain",
875
+ "855": "thimble",
876
+ "856": "thresher, thrasher, threshing machine",
877
+ "857": "throne",
878
+ "858": "tile roof",
879
+ "859": "toaster",
880
+ "860": "tobacco shop, tobacconist shop, tobacconist",
881
+ "861": "toilet seat",
882
+ "862": "torch",
883
+ "863": "totem pole",
884
+ "864": "tow truck, tow car, wrecker",
885
+ "865": "toyshop",
886
+ "866": "tractor",
887
+ "867": "trailer truck, tractor trailer, trucking rig, rig, articulated lorry, semi",
888
+ "868": "tray",
889
+ "869": "trench coat",
890
+ "870": "tricycle, trike, velocipede",
891
+ "871": "trimaran",
892
+ "872": "tripod",
893
+ "873": "triumphal arch",
894
+ "874": "trolleybus, trolley coach, trackless trolley",
895
+ "875": "trombone",
896
+ "876": "tub, vat",
897
+ "877": "turnstile",
898
+ "878": "typewriter keyboard",
899
+ "879": "umbrella",
900
+ "880": "unicycle, monocycle",
901
+ "881": "upright, upright piano",
902
+ "882": "vacuum, vacuum cleaner",
903
+ "883": "vase",
904
+ "884": "vault",
905
+ "885": "velvet",
906
+ "886": "vending machine",
907
+ "887": "vestment",
908
+ "888": "viaduct",
909
+ "889": "violin, fiddle",
910
+ "890": "volleyball",
911
+ "891": "waffle iron",
912
+ "892": "wall clock",
913
+ "893": "wallet, billfold, notecase, pocketbook",
914
+ "894": "wardrobe, closet, press",
915
+ "895": "warplane, military plane",
916
+ "896": "washbasin, handbasin, washbowl, lavabo, wash-hand basin",
917
+ "897": "washer, automatic washer, washing machine",
918
+ "898": "water bottle",
919
+ "899": "water jug",
920
+ "900": "water tower",
921
+ "901": "whiskey jug",
922
+ "902": "whistle",
923
+ "903": "wig",
924
+ "904": "window screen",
925
+ "905": "window shade",
926
+ "906": "Windsor tie",
927
+ "907": "wine bottle",
928
+ "908": "wing",
929
+ "909": "wok",
930
+ "910": "wooden spoon",
931
+ "911": "wool, woolen, woollen",
932
+ "912": "worm fence, snake fence, snake-rail fence, Virginia fence",
933
+ "913": "wreck",
934
+ "914": "yawl",
935
+ "915": "yurt",
936
+ "916": "web site, website, internet site, site",
937
+ "917": "comic book",
938
+ "918": "crossword puzzle, crossword",
939
+ "919": "street sign",
940
+ "920": "traffic light, traffic signal, stoplight",
941
+ "921": "book jacket, dust cover, dust jacket, dust wrapper",
942
+ "922": "menu",
943
+ "923": "plate",
944
+ "924": "guacamole",
945
+ "925": "consomme",
946
+ "926": "hot pot, hotpot",
947
+ "927": "trifle",
948
+ "928": "ice cream, icecream",
949
+ "929": "ice lolly, lolly, lollipop, popsicle",
950
+ "930": "French loaf",
951
+ "931": "bagel, beigel",
952
+ "932": "pretzel",
953
+ "933": "cheeseburger",
954
+ "934": "hotdog, hot dog, red hot",
955
+ "935": "mashed potato",
956
+ "936": "head cabbage",
957
+ "937": "broccoli",
958
+ "938": "cauliflower",
959
+ "939": "zucchini, courgette",
960
+ "940": "spaghetti squash",
961
+ "941": "acorn squash",
962
+ "942": "butternut squash",
963
+ "943": "cucumber, cuke",
964
+ "944": "artichoke, globe artichoke",
965
+ "945": "bell pepper",
966
+ "946": "cardoon",
967
+ "947": "mushroom",
968
+ "948": "Granny Smith",
969
+ "949": "strawberry",
970
+ "950": "orange",
971
+ "951": "lemon",
972
+ "952": "fig",
973
+ "953": "pineapple, ananas",
974
+ "954": "banana",
975
+ "955": "jackfruit, jak, jack",
976
+ "956": "custard apple",
977
+ "957": "pomegranate",
978
+ "958": "hay",
979
+ "959": "carbonara",
980
+ "960": "chocolate sauce, chocolate syrup",
981
+ "961": "dough",
982
+ "962": "meat loaf, meatloaf",
983
+ "963": "pizza, pizza pie",
984
+ "964": "potpie",
985
+ "965": "burrito",
986
+ "966": "red wine",
987
+ "967": "espresso",
988
+ "968": "cup",
989
+ "969": "eggnog",
990
+ "970": "alp",
991
+ "971": "bubble",
992
+ "972": "cliff, drop, drop-off",
993
+ "973": "coral reef",
994
+ "974": "geyser",
995
+ "975": "lakeside, lakeshore",
996
+ "976": "promontory, headland, head, foreland",
997
+ "977": "sandbar, sand bar",
998
+ "978": "seashore, coast, seacoast, sea-coast",
999
+ "979": "valley, vale",
1000
+ "980": "volcano",
1001
+ "981": "ballplayer, baseball player",
1002
+ "982": "groom, bridegroom",
1003
+ "983": "scuba diver",
1004
+ "984": "rapeseed",
1005
+ "985": "daisy",
1006
+ "986": "yellow ladys slipper, yellow lady-slipper, Cypripedium calceolus, Cypripedium parviflorum",
1007
+ "987": "corn",
1008
+ "988": "acorn",
1009
+ "989": "hip, rose hip, rosehip",
1010
+ "990": "buckeye, horse chestnut, conker",
1011
+ "991": "coral fungus",
1012
+ "992": "agaric",
1013
+ "993": "gyromitra",
1014
+ "994": "stinkhorn, carrion fungus",
1015
+ "995": "earthstar",
1016
+ "996": "hen-of-the-woods, hen of the woods, Polyporus frondosus, Grifola frondosa",
1017
+ "997": "bolete",
1018
+ "998": "ear, spike, capitulum",
1019
+ "999": "toilet tissue, toilet paper, bathroom tissue"
1020
+ }
1021
+ }
DiCo-XL-256/pipeline.py ADDED
@@ -0,0 +1,398 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """Hub custom pipeline: DiCoPipeline.
2
+ Load with native Hugging Face diffusers and trust_remote_code=True.
3
+ """
4
+
5
+ # Copyright 2026 The HuggingFace Team. All rights reserved.
6
+ #
7
+ # Licensed under the Apache License, Version 2.0 (the "License");
8
+ # you may not use this file except in compliance with the License.
9
+ # You may obtain a copy of the License at
10
+ #
11
+ # http://www.apache.org/licenses/LICENSE-2.0
12
+ #
13
+ # Unless required by applicable law or agreed to in writing, software
14
+ # distributed under the License is distributed on an "AS IS" BASIS,
15
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16
+ # See the License for the specific language governing permissions and
17
+ # limitations under the License.
18
+
19
+ from __future__ import annotations
20
+
21
+ import inspect
22
+ import json
23
+ from pathlib import Path
24
+ from typing import Dict, List, Optional, Tuple, Union
25
+
26
+ import torch
27
+ from diffusers.image_processor import VaeImageProcessor
28
+ from diffusers.models import AutoencoderKL
29
+ from diffusers.pipelines.pipeline_utils import DiffusionPipeline, ImagePipelineOutput
30
+ from diffusers.schedulers import DDIMScheduler, KarrasDiffusionSchedulers
31
+ from diffusers.utils.torch_utils import randn_tensor
32
+
33
+
34
+ EXAMPLE_DOC_STRING = """
35
+ Examples:
36
+ ```py
37
+ >>> from pathlib import Path
38
+ >>> from diffusers import DiffusionPipeline
39
+ >>> import torch
40
+
41
+ >>> model_dir = Path("./DiCo-XL-256").resolve()
42
+ >>> pipe = DiffusionPipeline.from_pretrained(
43
+ ... str(model_dir),
44
+ ... local_files_only=True,
45
+ ... custom_pipeline=str(model_dir / "pipeline.py"),
46
+ ... trust_remote_code=True,
47
+ ... torch_dtype=torch.bfloat16,
48
+ ... )
49
+ >>> pipe.to("cuda")
50
+
51
+ >>> image = pipe(
52
+ ... class_labels="golden retriever",
53
+ ... num_inference_steps=250,
54
+ ... guidance_scale=1.4,
55
+ ... generator=torch.Generator("cuda").manual_seed(0),
56
+ ... ).images[0]
57
+ ```
58
+ """
59
+
60
+
61
+ class DiCoPipeline(DiffusionPipeline):
62
+ r"""
63
+ Pipeline for class-conditional image generation with DiCo (Diffusion ConvNet).
64
+
65
+ Parameters:
66
+ transformer ([`DiCoTransformer2DModel`]):
67
+ Class-conditional DiCo denoiser operating in VAE latent space.
68
+ vae ([`AutoencoderKL`]):
69
+ Variational autoencoder used to decode latents to pixels.
70
+ scheduler ([`DDIMScheduler`]):
71
+ Diffusion scheduler. Other [`KarrasDiffusionSchedulers`] can be swapped at inference time.
72
+ id2label (`dict[int, str]`, *optional*):
73
+ ImageNet class id to English label mapping. Values may contain comma-separated synonyms.
74
+ """
75
+
76
+ model_cpu_offload_seq = "transformer->vae"
77
+
78
+ @staticmethod
79
+ def prepare_extra_step_kwargs(
80
+ scheduler: KarrasDiffusionSchedulers,
81
+ generator: Optional[Union[torch.Generator, List[torch.Generator]]] = None,
82
+ eta: float = 0.0,
83
+ ) -> Dict[str, object]:
84
+ kwargs: Dict[str, object] = {}
85
+ step_params = set(inspect.signature(scheduler.step).parameters.keys())
86
+ if "generator" in step_params:
87
+ kwargs["generator"] = generator
88
+ if "eta" in step_params:
89
+ kwargs["eta"] = eta
90
+ return kwargs
91
+
92
+ def __init__(
93
+ self,
94
+ transformer,
95
+ vae: AutoencoderKL,
96
+ scheduler: KarrasDiffusionSchedulers,
97
+ id2label: Optional[Dict[Union[int, str], str]] = None,
98
+ ):
99
+ super().__init__()
100
+ if scheduler is None:
101
+ scheduler = DDIMScheduler(
102
+ num_train_timesteps=1000,
103
+ beta_start=0.0001,
104
+ beta_end=0.02,
105
+ beta_schedule="linear",
106
+ clip_sample=False,
107
+ set_alpha_to_one=True,
108
+ steps_offset=0,
109
+ prediction_type="epsilon",
110
+ )
111
+ self.register_modules(transformer=transformer, vae=vae, scheduler=scheduler)
112
+ self.vae_scale_factor = 2 ** (len(self.vae.config.block_out_channels) - 1)
113
+ self.image_processor = VaeImageProcessor(vae_scale_factor=self.vae_scale_factor)
114
+ self._id2label = self._normalize_id2label(id2label)
115
+ self.labels = self._build_label2id(self._id2label)
116
+ self._labels_loaded_from_model_index = bool(self._id2label)
117
+
118
+ @classmethod
119
+ def from_pretrained(cls, pretrained_model_name_or_path: str, **kwargs):
120
+ model_kwargs = dict(kwargs)
121
+ transformer_subfolder = model_kwargs.pop("transformer_subfolder", None)
122
+ scheduler_subfolder = model_kwargs.pop("scheduler_subfolder", None)
123
+ vae_subfolder = model_kwargs.pop("vae_subfolder", None)
124
+ scheduler_kwargs = model_kwargs.pop("scheduler_kwargs", {})
125
+ base_path = Path(pretrained_model_name_or_path)
126
+
127
+ if transformer_subfolder is None and (base_path / "transformer").exists():
128
+ transformer_subfolder = "transformer"
129
+ if scheduler_subfolder is None and (base_path / "scheduler").exists():
130
+ scheduler_subfolder = "scheduler"
131
+ if vae_subfolder is None and (base_path / "vae").exists():
132
+ vae_subfolder = "vae"
133
+
134
+ try:
135
+ return super().from_pretrained(pretrained_model_name_or_path, **kwargs)
136
+ except Exception:
137
+ transformer_path = str(base_path / transformer_subfolder) if transformer_subfolder else pretrained_model_name_or_path
138
+ from transformer.transformer_dico import DiCoTransformer2DModel
139
+ transformer = DiCoTransformer2DModel.from_pretrained(transformer_path, **model_kwargs)
140
+ try:
141
+ scheduler = DDIMScheduler.from_pretrained(
142
+ pretrained_model_name_or_path,
143
+ subfolder=scheduler_subfolder,
144
+ **scheduler_kwargs,
145
+ )
146
+ except Exception:
147
+ scheduler = DDIMScheduler(
148
+ num_train_timesteps=1000,
149
+ beta_start=0.0001,
150
+ beta_end=0.02,
151
+ beta_schedule="linear",
152
+ clip_sample=False,
153
+ set_alpha_to_one=True,
154
+ steps_offset=0,
155
+ prediction_type="epsilon",
156
+ **scheduler_kwargs,
157
+ )
158
+ try:
159
+ vae = AutoencoderKL.from_pretrained(
160
+ pretrained_model_name_or_path,
161
+ subfolder=vae_subfolder,
162
+ **model_kwargs,
163
+ )
164
+ except Exception:
165
+ vae = AutoencoderKL.from_pretrained("stabilityai/sd-vae-ft-ema", **model_kwargs)
166
+ id2label = cls._read_id2label_from_model_index(str(base_path))
167
+ return cls(transformer=transformer, vae=vae, scheduler=scheduler, id2label=id2label)
168
+
169
+ def _ensure_labels_loaded(self) -> None:
170
+ if self._labels_loaded_from_model_index:
171
+ return
172
+ loaded = self._read_id2label_from_model_index(getattr(self.config, "_name_or_path", None))
173
+ if loaded:
174
+ self._id2label = loaded
175
+ self.labels = self._build_label2id(self._id2label)
176
+ self._labels_loaded_from_model_index = True
177
+
178
+ @staticmethod
179
+ def _normalize_id2label(id2label: Optional[Dict[Union[int, str], str]]) -> Dict[int, str]:
180
+ if not id2label:
181
+ return {}
182
+ return {int(key): value for key, value in id2label.items()}
183
+
184
+ @staticmethod
185
+ def _read_id2label_from_model_index(variant_path: Optional[str]) -> Dict[int, str]:
186
+ if not variant_path:
187
+ return {}
188
+ model_index_path = Path(variant_path).resolve() / "model_index.json"
189
+ if not model_index_path.exists():
190
+ return {}
191
+ raw = json.loads(model_index_path.read_text(encoding="utf-8"))
192
+ id2label = raw.get("id2label")
193
+ if not isinstance(id2label, dict):
194
+ return {}
195
+ return {int(key): value for key, value in id2label.items()}
196
+
197
+ @staticmethod
198
+ def _build_label2id(id2label: Dict[int, str]) -> Dict[str, int]:
199
+ label2id: Dict[str, int] = {}
200
+ for class_id, value in id2label.items():
201
+ for synonym in value.split(","):
202
+ synonym = synonym.strip()
203
+ if synonym:
204
+ label2id[synonym] = int(class_id)
205
+ return dict(sorted(label2id.items()))
206
+
207
+ @property
208
+ def id2label(self) -> Dict[int, str]:
209
+ self._ensure_labels_loaded()
210
+ return self._id2label
211
+
212
+ def get_label_ids(self, label: Union[str, List[str]]) -> List[int]:
213
+ self._ensure_labels_loaded()
214
+ if not self.labels:
215
+ raise ValueError("No English labels loaded. Ensure `id2label` exists in model_index.json.")
216
+ if isinstance(label, str):
217
+ label = [label]
218
+ missing = [item for item in label if item not in self.labels]
219
+ if missing:
220
+ preview = ", ".join(list(self.labels.keys())[:8])
221
+ raise ValueError(f"Unknown English label(s): {missing}. Example valid labels: {preview}, ...")
222
+ return [self.labels[item] for item in label]
223
+
224
+ def _normalize_class_labels(
225
+ self,
226
+ class_labels: Union[int, str, List[Union[int, str]], torch.LongTensor],
227
+ ) -> torch.LongTensor:
228
+ if torch.is_tensor(class_labels):
229
+ return class_labels.to(device=self._execution_device, dtype=torch.long).reshape(-1)
230
+ if isinstance(class_labels, int):
231
+ class_label_ids = [class_labels]
232
+ elif isinstance(class_labels, str):
233
+ class_label_ids = self.get_label_ids(class_labels)
234
+ elif class_labels and isinstance(class_labels[0], str):
235
+ class_label_ids = self.get_label_ids(class_labels)
236
+ else:
237
+ class_label_ids = list(class_labels)
238
+ return torch.tensor(class_label_ids, device=self._execution_device, dtype=torch.long).reshape(-1)
239
+
240
+ def _default_image_size(self) -> int:
241
+ return int(self.transformer.config.input_size) * self.vae_scale_factor
242
+
243
+ def check_inputs(
244
+ self,
245
+ height: int,
246
+ width: int,
247
+ num_inference_steps: int,
248
+ output_type: str,
249
+ ) -> None:
250
+ if num_inference_steps < 1:
251
+ raise ValueError("num_inference_steps must be >= 1.")
252
+ if output_type not in {"pil", "np", "pt", "latent"}:
253
+ raise ValueError("output_type must be one of: 'pil', 'np', 'pt', 'latent'.")
254
+ if height % self.vae_scale_factor != 0 or width % self.vae_scale_factor != 0:
255
+ raise ValueError(
256
+ f"height and width must be divisible by the VAE downsample factor {self.vae_scale_factor}."
257
+ )
258
+ latent_height = height // self.vae_scale_factor
259
+ latent_width = width // self.vae_scale_factor
260
+ expected_size = int(self.transformer.config.input_size)
261
+ if latent_height != expected_size or latent_width != expected_size:
262
+ raise ValueError(
263
+ f"Requested latent size {(latent_height, latent_width)} does not match the pretrained "
264
+ f"transformer input_size={expected_size}. Use height=width={self._default_image_size()}."
265
+ )
266
+
267
+ def prepare_latents(
268
+ self,
269
+ batch_size: int,
270
+ height: int,
271
+ width: int,
272
+ dtype: torch.dtype,
273
+ device: torch.device,
274
+ generator: Optional[Union[torch.Generator, List[torch.Generator]]],
275
+ ) -> torch.Tensor:
276
+ latent_height = height // self.vae_scale_factor
277
+ latent_width = width // self.vae_scale_factor
278
+ return randn_tensor(
279
+ (batch_size, self.transformer.config.in_channels, latent_height, latent_width),
280
+ generator=generator,
281
+ device=device,
282
+ dtype=dtype,
283
+ )
284
+
285
+ @staticmethod
286
+ def _expand_timestep(timestep, batch: int, device: torch.device) -> torch.Tensor:
287
+ if not torch.is_tensor(timestep):
288
+ timestep = torch.tensor([timestep], dtype=torch.long, device=device)
289
+ elif timestep.ndim == 0:
290
+ timestep = timestep[None].to(device=device)
291
+ return timestep.expand(batch)
292
+
293
+ @staticmethod
294
+ def _prepare_model_output_for_scheduler(
295
+ model_output: torch.Tensor,
296
+ latent_channels: int,
297
+ scheduler: KarrasDiffusionSchedulers,
298
+ ) -> torch.Tensor:
299
+ if model_output.shape[1] != 2 * latent_channels:
300
+ return model_output
301
+ variance_type = getattr(scheduler.config, "variance_type", None)
302
+ if scheduler.__class__.__name__ == "DDPMScheduler" and variance_type in ("learned", "learned_range"):
303
+ return model_output
304
+ model_output, _ = torch.split(model_output, latent_channels, dim=1)
305
+ return model_output
306
+
307
+ def decode_latents(self, latents: torch.Tensor, output_type: str = "pil"):
308
+ if output_type == "latent":
309
+ return latents
310
+ scaling_factor = getattr(self.vae.config, "scaling_factor", 0.18215)
311
+ image = self.vae.decode(latents / scaling_factor).sample
312
+ if output_type == "pt":
313
+ return image
314
+ return self.image_processor.postprocess(image, output_type=output_type)
315
+
316
+ @torch.inference_mode()
317
+ def __call__(
318
+ self,
319
+ class_labels: Union[int, str, List[Union[int, str]], torch.LongTensor],
320
+ height: Optional[int] = None,
321
+ width: Optional[int] = None,
322
+ num_inference_steps: int = 250,
323
+ guidance_scale: float = 1.0,
324
+ eta: float = 0.0,
325
+ generator: Optional[Union[torch.Generator, List[torch.Generator]]] = None,
326
+ output_type: str = "pil",
327
+ return_dict: bool = True,
328
+ ) -> Union[ImagePipelineOutput, Tuple]:
329
+ default_size = self._default_image_size()
330
+ height = int(height or default_size)
331
+ width = int(width or default_size)
332
+ self.check_inputs(height, width, num_inference_steps, output_type)
333
+
334
+ device = self._execution_device
335
+ model_dtype = next(self.transformer.parameters()).dtype
336
+ class_labels_tensor = self._normalize_class_labels(class_labels)
337
+ batch_size = class_labels_tensor.numel()
338
+ latent_channels = int(self.transformer.config.in_channels)
339
+ null_class_val = int(self.transformer.config.num_classes)
340
+ do_cfg = guidance_scale > 1.0
341
+
342
+ latents = self.prepare_latents(
343
+ batch_size=batch_size,
344
+ height=height,
345
+ width=width,
346
+ dtype=model_dtype,
347
+ device=device,
348
+ generator=generator,
349
+ )
350
+ latent_model_input = torch.cat([latents] * 2) if do_cfg else latents
351
+
352
+ class_labels_input = class_labels_tensor
353
+ if do_cfg:
354
+ class_null = torch.full_like(class_labels_tensor, null_class_val)
355
+ class_labels_input = torch.cat([class_labels_tensor, class_null], dim=0)
356
+
357
+ self.scheduler.set_timesteps(num_inference_steps, device=device)
358
+ extra_step_kwargs = self.prepare_extra_step_kwargs(self.scheduler, generator=generator, eta=eta)
359
+
360
+ for t in self.progress_bar(self.scheduler.timesteps):
361
+ if do_cfg:
362
+ half = latent_model_input[: len(latent_model_input) // 2]
363
+ latent_model_input = torch.cat([half, half], dim=0)
364
+ latent_model_input = self.scheduler.scale_model_input(latent_model_input, t)
365
+ timesteps = self._expand_timestep(t, latent_model_input.shape[0], latent_model_input.device)
366
+
367
+ noise_pred = self.transformer(
368
+ hidden_states=latent_model_input,
369
+ timestep=timesteps,
370
+ class_labels=class_labels_input,
371
+ return_dict=True,
372
+ ).sample
373
+
374
+ if do_cfg:
375
+ eps, rest = noise_pred[:, :latent_channels], noise_pred[:, latent_channels:]
376
+ cond_eps, uncond_eps = torch.split(eps, len(eps) // 2, dim=0)
377
+ half_eps = uncond_eps + guidance_scale * (cond_eps - uncond_eps)
378
+ eps = torch.cat([half_eps, half_eps], dim=0)
379
+ noise_pred = torch.cat([eps, rest], dim=1)
380
+
381
+ model_output = self._prepare_model_output_for_scheduler(noise_pred, latent_channels, self.scheduler)
382
+ latent_model_input = self.scheduler.step(
383
+ model_output, t, latent_model_input, return_dict=True, **extra_step_kwargs
384
+ ).prev_sample
385
+
386
+ if do_cfg:
387
+ latents, _ = latent_model_input.chunk(2, dim=0)
388
+ else:
389
+ latents = latent_model_input
390
+
391
+ image = self.decode_latents(latents, output_type=output_type)
392
+ self.maybe_free_model_hooks()
393
+ if not return_dict:
394
+ return (image,)
395
+ return ImagePipelineOutput(images=image)
396
+
397
+
398
+ DiCoPipelineOutput = ImagePipelineOutput
DiCo-XL-256/scheduler/scheduler_config.json ADDED
@@ -0,0 +1,12 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "_class_name": "DDIMScheduler",
3
+ "_diffusers_version": "0.35.1",
4
+ "num_train_timesteps": 1000,
5
+ "beta_start": 0.0001,
6
+ "beta_end": 0.02,
7
+ "beta_schedule": "linear",
8
+ "clip_sample": false,
9
+ "set_alpha_to_one": true,
10
+ "steps_offset": 0,
11
+ "prediction_type": "epsilon"
12
+ }
DiCo-XL-256/transformer/config.json ADDED
@@ -0,0 +1,14 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "_class_name": "DiCoTransformer2DModel",
3
+ "_diffusers_version": "0.38.0",
4
+ "class_dropout_prob": 0.1,
5
+ "depth": null,
6
+ "hidden_size": 416,
7
+ "in_channels": 4,
8
+ "input_size": 32,
9
+ "learn_sigma": true,
10
+ "mlp_ratio": 2.0,
11
+ "model_type": "DiCo-XL",
12
+ "num_class_embeds": null,
13
+ "num_classes": 1000
14
+ }
DiCo-XL-256/transformer/diffusion_pytorch_model.safetensors ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:c1359b801751ee014cc0ec44912f28a1d9972f359eac05c659cd449dfa9856a8
3
+ size 2804674944
DiCo-XL-256/transformer/transformer_dico.py ADDED
@@ -0,0 +1,479 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Copyright 2026 The HuggingFace Team. All rights reserved.
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ from __future__ import annotations
16
+
17
+ import argparse
18
+ import math
19
+ from collections.abc import Mapping
20
+ from typing import Dict, Literal, Optional, Tuple
21
+
22
+ import torch
23
+ import torch.nn as nn
24
+ import torch.nn.functional as F
25
+
26
+ from diffusers.configuration_utils import ConfigMixin, register_to_config
27
+ from diffusers.models.modeling_outputs import Transformer2DModelOutput
28
+ from diffusers.models.modeling_utils import ModelMixin
29
+
30
+
31
+ DICO_PRESET_CONFIGS: Dict[str, Dict[str, object]] = {
32
+ "DiCo-S": {
33
+ "hidden_size": 128,
34
+ "depth": [5, 4, 4, 4, 4],
35
+ "mlp_ratio": 2.0,
36
+ },
37
+ "DiCo-B": {
38
+ "hidden_size": 256,
39
+ "depth": [5, 4, 4, 4, 4],
40
+ "mlp_ratio": 2.0,
41
+ },
42
+ "DiCo-L": {
43
+ "hidden_size": 352,
44
+ "depth": [9, 8, 9, 8, 9],
45
+ "mlp_ratio": 2.0,
46
+ },
47
+ "DiCo-XL": {
48
+ "hidden_size": 416,
49
+ "depth": [9, 9, 10, 9, 9],
50
+ "mlp_ratio": 2.0,
51
+ },
52
+ "DiCo-H": {
53
+ "hidden_size": 416,
54
+ "depth": [14, 12, 10, 12, 14],
55
+ "mlp_ratio": 4.0,
56
+ },
57
+ }
58
+
59
+
60
+ def remap_legacy_state_dict(state_dict: Dict[str, torch.Tensor]) -> Dict[str, torch.Tensor]:
61
+ """Map wrapper/backbone keys from legacy checkpoints to native model keys."""
62
+ remapped: Dict[str, torch.Tensor] = {}
63
+ for key, value in state_dict.items():
64
+ new_key = key
65
+ for prefix in ("transformer.", "model.", "net."):
66
+ if new_key.startswith(prefix):
67
+ new_key = new_key[len(prefix) :]
68
+ break
69
+ remapped[new_key] = value
70
+ return remapped
71
+
72
+
73
+ def infer_learn_sigma(state_dict: Dict[str, torch.Tensor], in_channels: int = 4) -> bool:
74
+ weight = state_dict.get("final_layer.out_proj.weight")
75
+ if weight is None:
76
+ return True
77
+ return int(weight.shape[0]) == in_channels * 2
78
+
79
+
80
+ def config_from_legacy(config: Dict[str, object]) -> Dict[str, object]:
81
+ """Build native config kwargs from a legacy config.json dict."""
82
+ model_type = config.get("model_type") or config.get("model_name") or config.get("model")
83
+ if model_type not in DICO_PRESET_CONFIGS:
84
+ raise ValueError(f"Unknown DiCo preset '{model_type}'. Known: {list(DICO_PRESET_CONFIGS)}")
85
+
86
+ preset = dict(DICO_PRESET_CONFIGS[model_type])
87
+ preset["num_classes"] = int(config.get("num_class_embeds") or config.get("num_classes") or 1000)
88
+ preset["model_type"] = model_type
89
+ preset["input_size"] = int(config.get("input_size") or config.get("sample_size") or 32)
90
+ if config.get("learn_sigma") is not None:
91
+ preset["learn_sigma"] = bool(config["learn_sigma"])
92
+ return preset
93
+
94
+
95
+ def modulate(x: torch.Tensor, shift: torch.Tensor, scale: torch.Tensor) -> torch.Tensor:
96
+ return x * (1 + scale.unsqueeze(-1).unsqueeze(-1)) + shift.unsqueeze(-1).unsqueeze(-1)
97
+
98
+
99
+ class LayerNorm2d(nn.LayerNorm):
100
+ def __init__(self, num_channels: int, eps: float = 1e-6, affine: bool = True):
101
+ super().__init__(num_channels, eps=eps, elementwise_affine=affine)
102
+
103
+ def forward(self, x: torch.Tensor) -> torch.Tensor:
104
+ x = x.permute(0, 2, 3, 1)
105
+ x = F.layer_norm(x, self.normalized_shape, self.weight, self.bias, self.eps)
106
+ return x.permute(0, 3, 1, 2)
107
+
108
+
109
+ class DiCoTimestepEmbedder(nn.Module):
110
+ def __init__(self, hidden_size: int, frequency_embedding_size: int = 256):
111
+ super().__init__()
112
+ self.mlp = nn.Sequential(
113
+ nn.Linear(frequency_embedding_size, hidden_size, bias=True),
114
+ nn.SiLU(),
115
+ nn.Linear(hidden_size, hidden_size, bias=True),
116
+ )
117
+ self.frequency_embedding_size = frequency_embedding_size
118
+
119
+ @staticmethod
120
+ def timestep_embedding(t: torch.Tensor, dim: int, max_period: int = 10000) -> torch.Tensor:
121
+ half = dim // 2
122
+ freqs = torch.exp(
123
+ -math.log(max_period) * torch.arange(start=0, end=half, dtype=torch.float32) / half
124
+ ).to(device=t.device)
125
+ args = t[:, None].float() * freqs[None]
126
+ embedding = torch.cat([torch.cos(args), torch.sin(args)], dim=-1)
127
+ if dim % 2:
128
+ embedding = torch.cat([embedding, torch.zeros_like(embedding[:, :1])], dim=-1)
129
+ return embedding
130
+
131
+ def forward(self, t: torch.Tensor) -> torch.Tensor:
132
+ t_freq = self.timestep_embedding(t, self.frequency_embedding_size)
133
+ weight_dtype = self.mlp[0].weight.dtype
134
+ return self.mlp(t_freq.to(dtype=weight_dtype))
135
+
136
+
137
+ class DiCoLabelEmbedder(nn.Module):
138
+ def __init__(self, num_classes: int, hidden_size: int, dropout_prob: float):
139
+ super().__init__()
140
+ use_cfg_embedding = dropout_prob > 0
141
+ self.embedding_table = nn.Embedding(num_classes + use_cfg_embedding, hidden_size)
142
+ self.num_classes = num_classes
143
+ self.dropout_prob = dropout_prob
144
+
145
+ def token_drop(self, labels: torch.Tensor, force_drop_ids: Optional[torch.Tensor] = None) -> torch.Tensor:
146
+ if force_drop_ids is None:
147
+ drop_ids = torch.rand(labels.shape[0], device=labels.device) < self.dropout_prob
148
+ else:
149
+ drop_ids = force_drop_ids == 1
150
+ return torch.where(drop_ids, self.num_classes, labels)
151
+
152
+ def forward(
153
+ self,
154
+ labels: torch.Tensor,
155
+ train: bool,
156
+ force_drop_ids: Optional[torch.Tensor] = None,
157
+ ) -> torch.Tensor:
158
+ use_dropout = self.dropout_prob > 0
159
+ if (train and use_dropout) or (force_drop_ids is not None):
160
+ labels = self.token_drop(labels, force_drop_ids)
161
+ return self.embedding_table(labels)
162
+
163
+
164
+ class DiCoMultiScaleLabelEmbedder(nn.Module):
165
+ def __init__(
166
+ self,
167
+ num_classes: int,
168
+ hidden_size_0: int,
169
+ hidden_size_1: int,
170
+ hidden_size_2: int,
171
+ dropout_prob: float,
172
+ ):
173
+ super().__init__()
174
+ use_cfg_embedding = dropout_prob > 0
175
+ self.embedding_table_0 = nn.Embedding(num_classes + use_cfg_embedding, hidden_size_0)
176
+ self.embedding_table_1 = nn.Embedding(num_classes + use_cfg_embedding, hidden_size_1)
177
+ self.embedding_table_2 = nn.Embedding(num_classes + use_cfg_embedding, hidden_size_2)
178
+ self.num_classes = num_classes
179
+ self.dropout_prob = dropout_prob
180
+
181
+ def token_drop(self, labels: torch.Tensor, force_drop_ids: Optional[torch.Tensor] = None) -> torch.Tensor:
182
+ if force_drop_ids is None:
183
+ drop_ids = torch.rand(labels.shape[0], device=labels.device) < self.dropout_prob
184
+ else:
185
+ drop_ids = force_drop_ids == 1
186
+ return torch.where(drop_ids, self.num_classes, labels)
187
+
188
+ def forward(
189
+ self,
190
+ labels: torch.Tensor,
191
+ train: bool,
192
+ force_drop_ids: Optional[torch.Tensor] = None,
193
+ ) -> Tuple[torch.Tensor, torch.Tensor, torch.Tensor]:
194
+ use_dropout = self.dropout_prob > 0
195
+ if (train and use_dropout) or (force_drop_ids is not None):
196
+ labels = self.token_drop(labels, force_drop_ids)
197
+ return (
198
+ self.embedding_table_0(labels),
199
+ self.embedding_table_1(labels),
200
+ self.embedding_table_2(labels),
201
+ )
202
+
203
+
204
+ class DiCoBlock(nn.Module):
205
+ def __init__(self, hidden_size: int, mlp_ratio: float = 4.0):
206
+ super().__init__()
207
+ self.conv1 = nn.Conv2d(hidden_size, hidden_size, kernel_size=1, padding=0, stride=1, groups=1, bias=True)
208
+ self.conv2 = nn.Conv2d(
209
+ hidden_size, hidden_size, kernel_size=3, padding=1, stride=1, groups=hidden_size, bias=True
210
+ )
211
+ self.conv3 = nn.Conv2d(hidden_size, hidden_size, kernel_size=1, padding=0, stride=1, groups=1, bias=True)
212
+ self.ca = nn.Sequential(
213
+ nn.AdaptiveAvgPool2d(1),
214
+ nn.Conv2d(hidden_size, hidden_size, kernel_size=1, padding=0, stride=1, groups=1, bias=True),
215
+ nn.Sigmoid(),
216
+ )
217
+ ffn_channel = int(mlp_ratio * hidden_size)
218
+ self.conv4 = nn.Conv2d(hidden_size, ffn_channel, kernel_size=1, padding=0, stride=1, groups=1, bias=True)
219
+ self.conv5 = nn.Conv2d(ffn_channel, hidden_size, kernel_size=1, padding=0, stride=1, groups=1, bias=True)
220
+ self.norm1 = LayerNorm2d(hidden_size, affine=False, eps=1e-6)
221
+ self.norm2 = LayerNorm2d(hidden_size, affine=False, eps=1e-6)
222
+ self.adaLN_modulation = nn.Sequential(nn.SiLU(), nn.Linear(hidden_size, 6 * hidden_size, bias=True))
223
+
224
+ def forward(self, inp: torch.Tensor, c: torch.Tensor) -> torch.Tensor:
225
+ shift_msa, scale_msa, gate_msa, shift_mlp, scale_mlp, gate_mlp = self.adaLN_modulation(c).chunk(6, dim=1)
226
+ x = modulate(self.norm1(inp), shift_msa, scale_msa)
227
+ x = F.gelu(self.conv2(self.conv1(x)))
228
+ x = x * self.ca(x)
229
+ x = self.conv3(x)
230
+ x = inp + gate_msa.unsqueeze(-1).unsqueeze(-1) * x
231
+ x = x + gate_mlp.unsqueeze(-1).unsqueeze(-1) * self.conv5(
232
+ F.gelu(self.conv4(modulate(self.norm2(x), shift_mlp, scale_mlp)))
233
+ )
234
+ return x
235
+
236
+
237
+ class DiCoFinalLayer(nn.Module):
238
+ def __init__(self, hidden_size: int, out_channels: int):
239
+ super().__init__()
240
+ self.norm_final = LayerNorm2d(hidden_size, affine=False, eps=1e-6)
241
+ self.out_proj = nn.Conv2d(hidden_size, out_channels, kernel_size=3, stride=1, padding=1, bias=True)
242
+ self.adaLN_modulation = nn.Sequential(nn.SiLU(), nn.Linear(hidden_size, 2 * hidden_size, bias=True))
243
+
244
+ def forward(self, x: torch.Tensor, c: torch.Tensor) -> torch.Tensor:
245
+ shift, scale = self.adaLN_modulation(c).chunk(2, dim=1)
246
+ x = modulate(self.norm_final(x), shift, scale)
247
+ return self.out_proj(x)
248
+
249
+
250
+ class OverlapPatchEmbed(nn.Module):
251
+ def __init__(self, in_c: int = 3, embed_dim: int = 48, bias: bool = False):
252
+ super().__init__()
253
+ self.proj = nn.Conv2d(in_c, embed_dim, kernel_size=3, stride=1, padding=1, bias=bias)
254
+
255
+ def forward(self, x: torch.Tensor) -> torch.Tensor:
256
+ return self.proj(x)
257
+
258
+
259
+ class Downsample(nn.Module):
260
+ def __init__(self, n_feat: int):
261
+ super().__init__()
262
+ self.body = nn.Sequential(
263
+ nn.Conv2d(n_feat, n_feat // 2, kernel_size=3, stride=1, padding=1, bias=False),
264
+ nn.PixelUnshuffle(2),
265
+ )
266
+
267
+ def forward(self, x: torch.Tensor) -> torch.Tensor:
268
+ return self.body(x)
269
+
270
+
271
+ class Upsample(nn.Module):
272
+ def __init__(self, n_feat: int):
273
+ super().__init__()
274
+ self.body = nn.Sequential(
275
+ nn.Conv2d(n_feat, n_feat * 2, kernel_size=3, stride=1, padding=1, bias=False),
276
+ nn.PixelShuffle(2),
277
+ )
278
+
279
+ def forward(self, x: torch.Tensor) -> torch.Tensor:
280
+ return self.body(x)
281
+
282
+
283
+ class DiCoTransformer2DModel(ModelMixin, ConfigMixin):
284
+ r"""
285
+ DiCo (Diffusion ConvNet) denoiser for class-conditional latent diffusion.
286
+
287
+ ConvNet U-Net backbone with multi-scale adaLN conditioning, operating on VAE latents.
288
+ """
289
+
290
+ _supports_gradient_checkpointing = True
291
+
292
+ @register_to_config
293
+ def __init__(
294
+ self,
295
+ input_size: int = 32,
296
+ in_channels: int = 4,
297
+ hidden_size: int = 416,
298
+ depth: Optional[list[int]] = None,
299
+ mlp_ratio: float = 2.0,
300
+ class_dropout_prob: float = 0.1,
301
+ num_classes: int = 1000,
302
+ learn_sigma: bool = True,
303
+ model_type: str | None = None,
304
+ num_class_embeds: int | None = None,
305
+ ):
306
+ super().__init__()
307
+ if num_class_embeds is not None:
308
+ num_classes = int(num_class_embeds)
309
+ if model_type in DICO_PRESET_CONFIGS:
310
+ preset = DICO_PRESET_CONFIGS[model_type]
311
+ hidden_size = int(preset["hidden_size"])
312
+ depth = list(preset["depth"])
313
+ mlp_ratio = float(preset["mlp_ratio"])
314
+
315
+ if depth is None:
316
+ depth = [9, 9, 10, 9, 9]
317
+
318
+ self.learn_sigma = learn_sigma
319
+ self.in_channels = in_channels
320
+ self.out_channels = in_channels * 2 if learn_sigma else in_channels
321
+ self.num_classes = num_classes
322
+ self.gradient_checkpointing = False
323
+
324
+ self.x_embedder = OverlapPatchEmbed(in_channels, hidden_size, bias=True)
325
+ self.t_embedder_1 = DiCoTimestepEmbedder(hidden_size)
326
+ self.y_embedder = DiCoMultiScaleLabelEmbedder(
327
+ num_classes, hidden_size, hidden_size * 2, hidden_size * 4, class_dropout_prob
328
+ )
329
+ self.t_embedder_2 = DiCoTimestepEmbedder(hidden_size * 2)
330
+ self.t_embedder_3 = DiCoTimestepEmbedder(hidden_size * 4)
331
+
332
+ self.encoder_level_1 = nn.ModuleList([DiCoBlock(hidden_size, mlp_ratio) for _ in range(depth[0])])
333
+ self.down1_2 = Downsample(hidden_size)
334
+ self.encoder_level_2 = nn.ModuleList([DiCoBlock(hidden_size * 2, mlp_ratio) for _ in range(depth[1])])
335
+ self.down2_3 = Downsample(hidden_size * 2)
336
+ self.latent = nn.ModuleList([DiCoBlock(hidden_size * 4, mlp_ratio) for _ in range(depth[2])])
337
+ self.up3_2 = Upsample(int(hidden_size * 4))
338
+ self.reduce_chan_level2 = nn.Conv2d(int(hidden_size * 4), int(hidden_size * 2), kernel_size=1, bias=True)
339
+ self.decoder_level_2 = nn.ModuleList([DiCoBlock(hidden_size * 2, mlp_ratio) for _ in range(depth[3])])
340
+ self.up2_1 = Upsample(int(hidden_size * 2))
341
+ self.reduce_chan_level1 = nn.Conv2d(int(hidden_size * 2), int(hidden_size * 2), kernel_size=1, bias=True)
342
+ self.decoder_level_1 = nn.ModuleList([DiCoBlock(hidden_size * 2, mlp_ratio) for _ in range(depth[4])])
343
+ self.final_layer = DiCoFinalLayer(hidden_size * 2, self.out_channels)
344
+ self.initialize_weights()
345
+
346
+ def initialize_weights(self) -> None:
347
+ def _basic_init(module: nn.Module):
348
+ if isinstance(module, (nn.Linear, nn.Conv2d)):
349
+ torch.nn.init.xavier_uniform_(module.weight)
350
+ if module.bias is not None:
351
+ nn.init.constant_(module.bias, 0)
352
+
353
+ self.apply(_basic_init)
354
+ w = self.x_embedder.proj.weight.data
355
+ nn.init.xavier_uniform_(w.view([w.shape[0], -1]))
356
+ nn.init.constant_(self.x_embedder.proj.bias, 0)
357
+ nn.init.normal_(self.y_embedder.embedding_table_0.weight, std=0.02)
358
+ nn.init.normal_(self.y_embedder.embedding_table_1.weight, std=0.02)
359
+ nn.init.normal_(self.y_embedder.embedding_table_2.weight, std=0.02)
360
+ for embedder in (self.t_embedder_1, self.t_embedder_2, self.t_embedder_3):
361
+ nn.init.normal_(embedder.mlp[0].weight, std=0.02)
362
+ nn.init.normal_(embedder.mlp[2].weight, std=0.02)
363
+
364
+ blocks = (
365
+ self.encoder_level_1
366
+ + self.encoder_level_2
367
+ + self.latent
368
+ + self.decoder_level_2
369
+ + self.decoder_level_1
370
+ )
371
+ for block in blocks:
372
+ nn.init.constant_(block.adaLN_modulation[-1].weight, 0)
373
+ nn.init.constant_(block.adaLN_modulation[-1].bias, 0)
374
+ nn.init.constant_(self.final_layer.adaLN_modulation[-1].weight, 0)
375
+ nn.init.constant_(self.final_layer.adaLN_modulation[-1].bias, 0)
376
+ nn.init.constant_(self.final_layer.out_proj.weight, 0)
377
+ nn.init.constant_(self.final_layer.out_proj.bias, 0)
378
+
379
+ def _run_block(self, block: DiCoBlock, x: torch.Tensor, c: torch.Tensor) -> torch.Tensor:
380
+ if self.training and self.gradient_checkpointing:
381
+ return torch.utils.checkpoint.checkpoint(block, x, c, use_reentrant=False)
382
+ return block(x, c)
383
+
384
+ def forward(
385
+ self,
386
+ hidden_states: torch.Tensor,
387
+ timestep: torch.LongTensor,
388
+ class_labels: torch.LongTensor,
389
+ force_drop_ids: Optional[torch.Tensor] = None,
390
+ return_dict: bool = True,
391
+ ) -> Transformer2DModelOutput | Tuple:
392
+ timestep = torch.as_tensor(timestep, device=hidden_states.device)
393
+ if timestep.ndim == 0:
394
+ timestep = timestep.repeat(hidden_states.shape[0])
395
+ else:
396
+ timestep = timestep.reshape(-1)
397
+ if timestep.shape[0] == 1 and hidden_states.shape[0] > 1:
398
+ timestep = timestep.repeat(hidden_states.shape[0])
399
+
400
+ x = self.x_embedder(hidden_states)
401
+ t1 = self.t_embedder_1(timestep)
402
+ y1, y2, y3 = self.y_embedder(class_labels, self.training, force_drop_ids=force_drop_ids)
403
+ c1 = t1 + y1
404
+ c2 = self.t_embedder_2(timestep) + y2
405
+ c3 = self.t_embedder_3(timestep) + y3
406
+
407
+ out_enc_level1 = x
408
+ for block in self.encoder_level_1:
409
+ out_enc_level1 = self._run_block(block, out_enc_level1, c1)
410
+ out_enc_level2 = self.down1_2(out_enc_level1)
411
+ for block in self.encoder_level_2:
412
+ out_enc_level2 = self._run_block(block, out_enc_level2, c2)
413
+ latent = self.down2_3(out_enc_level2)
414
+ for block in self.latent:
415
+ latent = self._run_block(block, latent, c3)
416
+
417
+ inp_dec_level2 = self.reduce_chan_level2(torch.cat([self.up3_2(latent), out_enc_level2], dim=1))
418
+ for block in self.decoder_level_2:
419
+ inp_dec_level2 = self._run_block(block, inp_dec_level2, c2)
420
+ inp_dec_level1 = self.reduce_chan_level1(torch.cat([self.up2_1(inp_dec_level2), out_enc_level1], dim=1))
421
+ for block in self.decoder_level_1:
422
+ inp_dec_level1 = self._run_block(block, inp_dec_level1, c2)
423
+
424
+ output = self.final_layer(inp_dec_level1, c2)
425
+ if not return_dict:
426
+ return (output,)
427
+ return Transformer2DModelOutput(sample=output)
428
+
429
+ @classmethod
430
+ def from_dico_checkpoint(
431
+ cls,
432
+ checkpoint_path: str,
433
+ weights: Literal["model", "ema"] = "ema",
434
+ map_location: str = "cpu",
435
+ strict: bool = True,
436
+ model_type: str | None = None,
437
+ ) -> Tuple["DiCoTransformer2DModel", Dict[str, object]]:
438
+ checkpoint = torch.load(checkpoint_path, map_location=map_location, weights_only=False)
439
+ state_dict = checkpoint
440
+ if isinstance(checkpoint, Mapping):
441
+ if weights in checkpoint:
442
+ state_dict = checkpoint[weights]
443
+ elif "state_dict" in checkpoint:
444
+ state_dict = checkpoint["state_dict"]
445
+
446
+ state_dict = remap_legacy_state_dict(state_dict)
447
+
448
+ ckpt_args = checkpoint.get("args") if isinstance(checkpoint, Mapping) else None
449
+ args_dict: Dict[str, object] = {}
450
+ if ckpt_args is not None:
451
+ if isinstance(ckpt_args, argparse.Namespace):
452
+ args_dict = vars(ckpt_args)
453
+ elif isinstance(ckpt_args, Mapping):
454
+ args_dict = dict(ckpt_args)
455
+
456
+ resolved_model_type = model_type or args_dict.get("model") or args_dict.get("model_type")
457
+ image_size = int(args_dict.get("image_size") or 256)
458
+ num_classes = int(args_dict.get("num_classes") or 1000)
459
+
460
+ config: Dict[str, object] = {
461
+ "input_size": image_size // 8,
462
+ "num_classes": num_classes,
463
+ "learn_sigma": infer_learn_sigma(state_dict),
464
+ }
465
+ if resolved_model_type in DICO_PRESET_CONFIGS:
466
+ config["model_type"] = resolved_model_type
467
+
468
+ model = cls(**config)
469
+ model.load_state_dict(state_dict, strict=strict)
470
+ metadata = {
471
+ "checkpoint_path": checkpoint_path,
472
+ "weights": weights,
473
+ "model_type": resolved_model_type,
474
+ "source_args": ckpt_args,
475
+ }
476
+ return model, metadata
477
+
478
+
479
+ DiCoDiffusersModel = DiCoTransformer2DModel
DiCo-XL-256/vae/config.json ADDED
@@ -0,0 +1,38 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "_class_name": "AutoencoderKL",
3
+ "_diffusers_version": "0.38.0",
4
+ "_name_or_path": "stabilityai/sd-vae-ft-ema",
5
+ "act_fn": "silu",
6
+ "block_out_channels": [
7
+ 128,
8
+ 256,
9
+ 512,
10
+ 512
11
+ ],
12
+ "down_block_types": [
13
+ "DownEncoderBlock2D",
14
+ "DownEncoderBlock2D",
15
+ "DownEncoderBlock2D",
16
+ "DownEncoderBlock2D"
17
+ ],
18
+ "force_upcast": true,
19
+ "in_channels": 3,
20
+ "latent_channels": 4,
21
+ "latents_mean": null,
22
+ "latents_std": null,
23
+ "layers_per_block": 2,
24
+ "mid_block_add_attention": true,
25
+ "norm_num_groups": 32,
26
+ "out_channels": 3,
27
+ "sample_size": 256,
28
+ "scaling_factor": 0.18215,
29
+ "shift_factor": null,
30
+ "up_block_types": [
31
+ "UpDecoderBlock2D",
32
+ "UpDecoderBlock2D",
33
+ "UpDecoderBlock2D",
34
+ "UpDecoderBlock2D"
35
+ ],
36
+ "use_post_quant_conv": true,
37
+ "use_quant_conv": true
38
+ }
DiCo-XL-256/vae/diffusion_pytorch_model.safetensors ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:703abdcd7c389316b5128faa9b750a530ea1680b453170b27afebac5e4db30c4
3
+ size 334643268
README.md ADDED
@@ -0,0 +1,150 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: apache-2.0
3
+ library_name: diffusers
4
+ pipeline_tag: unconditional-image-generation
5
+ tags:
6
+ - diffusers
7
+ - image-generation
8
+ - class-conditional
9
+ - imagenet
10
+ - dico
11
+ - latent-diffusion
12
+ - convnet
13
+ widget:
14
+ - text: golden retriever
15
+ output:
16
+ url: DiCo-XL-256/demo.png
17
+ inference: true
18
+ ---
19
+
20
+ # BiliSakura/DiCo-diffusers
21
+
22
+ Self-contained DiCo checkpoints for Hugging Face diffusers. Each variant folder ships its own `pipeline.py`, component modules, and weights.
23
+
24
+ Converted from [shallowdream204/DiCo](https://huggingface.co/shallowdream204/DiCo) using [DiCo-diffusers](https://github.com/Bili-Sakura/Visual-Generative-Foundation-Model-Collection/tree/main/libs/DiCo-diffusers).
25
+
26
+ ## Available checkpoints
27
+
28
+ | Subfolder | Pipeline | Resolution | Source checkpoint | CFG | FID | IS | Params |
29
+ | --- | --- | ---: | --- | ---: | ---: | ---: | ---: |
30
+ | [`DiCo-S-256/`](DiCo-S-256/) | `DiCoPipeline` | 256×256 | `DiCo-S-400K-256x256.pt` | 1.0 | 49.97 | 31.38 | 33M |
31
+ | [`DiCo-B-256/`](DiCo-B-256/) | `DiCoPipeline` | 256×256 | `DiCo-B-400K-256x256.pt` | 1.0 | 27.20 | 56.52 | 130M |
32
+ | [`DiCo-L-256/`](DiCo-L-256/) | `DiCoPipeline` | 256×256 | `DiCo-L-400K-256x256.pt` | 1.0 | 13.66 | 91.37 | 464M |
33
+ | [`DiCo-XL-256/`](DiCo-XL-256/) | `DiCoPipeline` | 256×256 | `DiCo-XL-3750K-256x256.pt` | 1.4 | 2.05 | 282.17 | 701M |
34
+
35
+ DiCo denoises **VAE latents** (4 channels, 32×32 for 256×256 images) with a ConvNet U-Net and multi-scale adaLN conditioning. VAE: `stabilityai/sd-vae-ft-ema`. Scheduler: `DDIMScheduler` (1000 train steps, linear betas).
36
+
37
+ ## Repo layout
38
+
39
+ ```text
40
+ BiliSakura/DiCo-diffusers/
41
+ ├── README.md
42
+ ├── demo_inference.py
43
+ ├── DiCo-S-256/
44
+ ├── DiCo-B-256/
45
+ ├── DiCo-L-256/
46
+ └── DiCo-XL-256/
47
+ ├── pipeline.py
48
+ ├── model_index.json
49
+ ├── demo.png
50
+ ├── scheduler/scheduler_config.json
51
+ ├── transformer/
52
+ └── vae/
53
+ ```
54
+
55
+ Each variant is self-contained. The `scheduler/` folder uses built-in `DDIMScheduler` from PyPI diffusers.
56
+
57
+ ## ImageNet class labels
58
+
59
+ `id2label` is embedded in each variant's `model_index.json` (DiT-style).
60
+
61
+ - `pipe.id2label` — inspect id → English label correspondence
62
+ - `pipe.labels` — reverse map (English synonym → id)
63
+ - `pipe.get_label_ids("golden retriever")`
64
+ - `pipe(class_labels="golden retriever", ...)` — string labels resolved automatically
65
+
66
+ ## Demo
67
+
68
+ ![DiCo-XL-256 demo](DiCo-XL-256/demo.png)
69
+
70
+ Class 207 — golden retriever, 256×256, 250 steps, `guidance_scale=1.4`.
71
+
72
+ ```bash
73
+ python demo_inference.py
74
+ python demo_inference.py --variant s # DiCo-S-256, CFG 1.0
75
+ ```
76
+
77
+ ## Load from a local clone
78
+
79
+ ### ImageNet 256×256 (`DiCo-XL-256`)
80
+
81
+ ```python
82
+ from pathlib import Path
83
+ import torch
84
+ from diffusers import DiffusionPipeline
85
+
86
+ model_dir = Path("./DiCo-XL-256").resolve()
87
+ pipe = DiffusionPipeline.from_pretrained(
88
+ str(model_dir),
89
+ local_files_only=True,
90
+ custom_pipeline=str(model_dir / "pipeline.py"),
91
+ trust_remote_code=True,
92
+ torch_dtype=torch.bfloat16,
93
+ )
94
+ pipe.to("cuda")
95
+
96
+ print(pipe.id2label[207])
97
+ print(pipe.get_label_ids("golden retriever"))
98
+
99
+ generator = torch.Generator(device="cuda").manual_seed(0)
100
+ image = pipe(
101
+ class_labels="golden retriever",
102
+ height=256,
103
+ width=256,
104
+ num_inference_steps=250,
105
+ guidance_scale=1.4,
106
+ generator=generator,
107
+ ).images[0]
108
+ image.save("demo.png")
109
+ ```
110
+
111
+ ## Recommended inference settings
112
+
113
+ | Variant | Steps | CFG scale |
114
+ | --- | ---: | ---: |
115
+ | `DiCo-S-256` | 250 | 1.0 |
116
+ | `DiCo-B-256` | 250 | 1.0 |
117
+ | `DiCo-L-256` | 250 | 1.0 |
118
+ | `DiCo-XL-256` | 250 | 1.4 |
119
+
120
+ Classifier-free guidance applies to the first 3 latent channels only (DiT reproducibility convention).
121
+
122
+ ## Conversion
123
+
124
+ ```bash
125
+ cd libs/DiCo-diffusers
126
+
127
+ python scripts/convert_dico_to_diffusers.py \
128
+ --checkpoint /path/to/DiCo-XL-3750K-256x256.pt \
129
+ --output /path/to/DiCo-XL-256 \
130
+ --model-type DiCo-XL \
131
+ --weights ema \
132
+ --safe-serialization \
133
+ --id2label ../../src/labels/id2label_en.json
134
+ ```
135
+
136
+ ## Citation
137
+
138
+ ```bibtex
139
+ @inproceedings{ai2025dico,
140
+ title={DiCo: Revitalizing ConvNets for Scalable and Efficient Diffusion Modeling},
141
+ author={Yuang Ai and Qihang Fan and Xuefeng Hu and Zhenheng Yang and Ran He and Huaibo Huang},
142
+ booktitle={The Thirty-ninth Annual Conference on Neural Information Processing Systems},
143
+ year={2025},
144
+ url={https://openreview.net/forum?id=UnslcaZSnb}
145
+ }
146
+ ```
147
+
148
+ ## License
149
+
150
+ Weights are converted from checkpoints released under the [Apache 2.0 license](https://huggingface.co/shallowdream204/DiCo).
demo_inference.py ADDED
@@ -0,0 +1,88 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ #!/usr/bin/env python3
2
+ """Generate a demo image with DiCo class-conditional checkpoints."""
3
+
4
+ from __future__ import annotations
5
+
6
+ import argparse
7
+ from pathlib import Path
8
+
9
+ import torch
10
+ from diffusers import DiffusionPipeline
11
+
12
+ REPO_ROOT = Path(__file__).resolve().parent
13
+
14
+ VARIANTS = {
15
+ "xl": {
16
+ "dir": REPO_ROOT / "DiCo-XL-256",
17
+ "class_label": "golden retriever",
18
+ "num_inference_steps": 250,
19
+ "guidance_scale": 1.4,
20
+ "seed": 0,
21
+ },
22
+ "s": {
23
+ "dir": REPO_ROOT / "DiCo-S-256",
24
+ "class_label": "golden retriever",
25
+ "num_inference_steps": 250,
26
+ "guidance_scale": 1.0,
27
+ "seed": 0,
28
+ },
29
+ "b": {
30
+ "dir": REPO_ROOT / "DiCo-B-256",
31
+ "class_label": "golden retriever",
32
+ "num_inference_steps": 250,
33
+ "guidance_scale": 1.0,
34
+ "seed": 0,
35
+ },
36
+ "l": {
37
+ "dir": REPO_ROOT / "DiCo-L-256",
38
+ "class_label": "golden retriever",
39
+ "num_inference_steps": 250,
40
+ "guidance_scale": 1.0,
41
+ "seed": 0,
42
+ },
43
+ }
44
+
45
+
46
+ def parse_args() -> argparse.Namespace:
47
+ parser = argparse.ArgumentParser(description="Run DiCo demo inference.")
48
+ parser.add_argument(
49
+ "--variant",
50
+ choices=sorted(VARIANTS),
51
+ default="xl",
52
+ help="Checkpoint variant to sample (default: xl).",
53
+ )
54
+ return parser.parse_args()
55
+
56
+
57
+ def main() -> None:
58
+ args = parse_args()
59
+ settings = VARIANTS[args.variant]
60
+ model_dir = settings["dir"]
61
+ output_path = model_dir / "demo.png"
62
+
63
+ pipe = DiffusionPipeline.from_pretrained(
64
+ str(model_dir),
65
+ local_files_only=True,
66
+ custom_pipeline=str(model_dir / "pipeline.py"),
67
+ trust_remote_code=True,
68
+ torch_dtype=torch.bfloat16,
69
+ )
70
+ pipe.to("cuda")
71
+
72
+ print(f"[{args.variant}] {settings['class_label']} -> {pipe.get_label_ids(settings['class_label'])}")
73
+
74
+ generator = torch.Generator(device="cuda").manual_seed(settings["seed"])
75
+ image = pipe(
76
+ class_labels=settings["class_label"],
77
+ height=256,
78
+ width=256,
79
+ num_inference_steps=settings["num_inference_steps"],
80
+ guidance_scale=settings["guidance_scale"],
81
+ generator=generator,
82
+ ).images[0]
83
+ image.save(output_path)
84
+ print(f"Saved demo image to {output_path}")
85
+
86
+
87
+ if __name__ == "__main__":
88
+ main()