Harley-ml commited on
Commit
d4806e0
·
verified ·
1 Parent(s): fb26a60

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +62 -5
README.md CHANGED
@@ -3,15 +3,72 @@ license: mit
3
  datasets:
4
  - ylecun/mnist
5
  tags:
6
- - image-generation
7
- - supralabs
8
  - harley-ml
 
 
9
  - mnist
10
  - small
11
- - digit-to-image
12
  - text-to-image
 
13
  ---
14
 
15
- This is SupraMNiST-IMG-200k, a model trained to generate an image based on an input number (0-9).
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
16
 
17
- Note: We will finish this model card later.
 
 
 
 
 
 
 
 
3
  datasets:
4
  - ylecun/mnist
5
  tags:
 
 
6
  - harley-ml
7
+ - image
8
+ - digit-to-image
9
  - mnist
10
  - small
 
11
  - text-to-image
12
+ - supralabs
13
  ---
14
 
15
+ # **SupraMNiST-IMG-200k**
16
+
17
+ ## Sumary
18
+
19
+ ```
20
+ Task: Number-To-Image
21
+ Dataset: ylecun/mnist
22
+ Total training time: ~8 minutes
23
+ Inputs: Number (0-9)
24
+ Outputs: 32x32 image
25
+ Params: ~201k
26
+ Framework: PyTorch, diffusers
27
+ Author: SupraLabs
28
+ ```
29
+
30
+ ## **Description**
31
+ MNiST-IMG-200k is an ~**200k parameter model** trained to **generate an image** based on an **input number (0-9)**.
32
+
33
+ ## **Training**
34
+
35
+ ### **Hardware**
36
+
37
+ MNiST-IMG was trained on Google Colaboratory (NVIDA Tesla T4) for ~8 minutes with a batch size of 64 for 10 epochs.
38
+
39
+ ### **Dataset**
40
+
41
+ [ylecun/mnist](https://huggingface.co/ylecun/mnist)
42
+
43
+ ### **Training Results**
44
+
45
+ Loss ended at ~**0.40**.
46
+
47
+ Note: I can't provide the raw training logs as I loss it somehwere after training. Sorry!
48
+
49
+ ## **Generation Examples**
50
+
51
+ At **1000** decoding steps:
52
+
53
+ ![1000 Decoding Step Digit Image Generation](images/digit_image_samples_1000s.png)
54
+
55
+ At **200** decoding steps:
56
+
57
+ ![1000 Decoding Step Generation Image](images/digit_image_samples_200s.png)
58
+
59
+ # Inference
60
+
61
+ Use the script in the repo. [inference.py](https://huggingface.co/Harley-ml/MNIST-IMG-390k/blob/main/inference.py)
62
+
63
+ ### Related Models
64
+
65
+ # Citation
66
 
67
+ ```bibtex
68
+ @misc{mnist-img-390k,
69
+ title = {MNIST-IMG-390k: a Tiny Diffusion Model for Generating Handwritten Digits},
70
+ author = {Paul Courneya; Harley-ml},
71
+ year = {2026},
72
+ url = {https://huggingface.co/Harley-ml/MNIST-IMG-390k}
73
+ }
74
+ ```