Spaces:
Sleeping
Sleeping
Update README for both github and HF
Browse files
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:
|
| 9 |
-
colorTo:
|
| 10 |
-
sdk:
|
| 11 |
-
|
| 12 |
-
|
| 13 |
-
|
| 14 |
---
|
| 15 |
|
| 16 |
-
|
| 17 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 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.
|