MJaheen commited on
Commit
886e630
ยท
1 Parent(s): 103001a

Update README for both github and HF

Browse files
Files changed (1) hide show
  1. README.md +104 -13
README.md CHANGED
@@ -1,17 +1,108 @@
1
- <<<<<<< HEAD
2
- # -Pepe-Meme-Generator-
3
- Create custom Pepe memes using AI
4
- =======
5
  ---
6
  title: Pepe Meme Generator
7
- emoji: ๐Ÿ’ป
8
- colorFrom: pink
9
- colorTo: pink
10
- sdk: docker
11
- pinned: false
12
- license: mit
13
- short_description: Create custom Pepe memes using AI
14
  ---
15
 
16
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
17
- >>>>>>> b990c1176a7f11f6245fe79359d900a697141f26
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
2
  title: Pepe Meme Generator
3
+ emoji: ๐Ÿธ
4
+ colorFrom: green
5
+ colorTo: blue
6
+ sdk: streamlit
7
+ sdk_version: 1.31.0
8
+ app_file: src/app.py
9
+ python_version: "3.10"
10
  ---
11
 
12
+ # ๐Ÿธ Pepe the Frog Meme Generator
13
+
14
+ AI-powered meme generator using Stable Diffusion and LoRA fine-tuning.
15
+
16
+ ---
17
+
18
+ ## ๐ŸŽฎ Try It Online
19
+
20
+ ๐Ÿš€ **[Open in Hugging Face Spaces](https://huggingface.co/spaces/MJaheen/Pepe-Meme-Generator)**
21
+
22
+ ---
23
+
24
+ ## ๐ŸŒŸ Features
25
+
26
+ - Generate **custom Pepe memes** from text prompts
27
+ - Multiple **style presets** (happy, sad, smug, angry, etc.)
28
+ - **Add meme text overlays** and download results
29
+ - Adjustable generation parameters (CFG, steps, seed, etc.)
30
+ - Batch generation and meme gallery system
31
+
32
+ ---
33
+
34
+ ## ๐Ÿ’ก Example Prompts
35
+
36
+ - "pepe the frog as a wizard"
37
+ - "pepe coding on a laptop"
38
+ - "pepe drinking coffee"
39
+ - "smug pepe wearing sunglasses"
40
+
41
+ ---
42
+
43
+ ## ๐Ÿš€ Quick Start (GitHub)
44
+
45
+ ```bash
46
+ # Clone
47
+ git clone https://github.com/YOUR_USERNAME/pepe-meme-generator.git
48
+ cd pepe-meme-generator
49
+
50
+ # Install
51
+ pip install -r requirements.txt
52
+
53
+ # Run
54
+ streamlit run src/app.py
55
+ ```
56
+
57
+ ---
58
+
59
+ ## ๐Ÿ“š Project Structure
60
+
61
+ pepe-meme-generator/
62
+ โ”œโ”€โ”€ src/
63
+ โ”‚ โ”œโ”€โ”€ app.py # Main Streamlit app
64
+ โ”‚ โ”œโ”€โ”€ model/
65
+ โ”‚ โ”‚ โ”œโ”€โ”€ generator.py # Generation logic
66
+ โ”‚ โ”‚ โ””โ”€โ”€ config.py # Model configuration
67
+ โ”‚ โ””โ”€โ”€ utils/
68
+ โ”‚ โ””โ”€โ”€ image_processor.py
69
+ โ”œโ”€โ”€ models/ # Model weights (not committed)
70
+ โ”œโ”€โ”€ outputs/ # Generated memes (not committed)
71
+ โ”œโ”€โ”€ requirements.txt
72
+ โ”œโ”€โ”€ .gitignore
73
+ โ””โ”€โ”€ README.md
74
+
75
+ ---
76
+
77
+ ## ๐Ÿ› ๏ธ Tech Stack
78
+
79
+ Model: Stable Diffusion 1.5 + LoRA
80
+
81
+ Framework: PyTorch, Diffusers
82
+
83
+ UI: Streamlit
84
+
85
+ Processing: PIL, OpenCV
86
+
87
+ ---
88
+
89
+
90
+
91
+ This project demonstrates:
92
+ - Diffusion model architecture
93
+ - Transfer learning with LoRA
94
+ - Text-to-image synthesis
95
+
96
+ ---
97
+ ## ๐ŸŽ“ ๐Ÿ™ Acknowledgments
98
+
99
+ - [WorldQuant](https://www.wqu.edu/ai-lab-computer-vision)
100
+ - [Stable Diffusion](https://github.com/CompVis/stable-diffusion)
101
+ - [LoRA](https://github.com/microsoft/LoRA)
102
+ - [Diffusers](https://github.com/huggingface/diffusers)
103
+ - [Streamlit](https://github.com/streamlit/streamlit)
104
+
105
+
106
+ ## ๐Ÿ“œ License
107
+
108
+ MIT License โ€” see LICENSE file.