faizee07 commited on
Commit
0f91fff
Β·
verified Β·
1 Parent(s): ef20f1a

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +43 -39
README.md CHANGED
@@ -3,76 +3,80 @@ title: AI Meme Generator
3
  emoji: πŸ₯Έ
4
  colorFrom: purple
5
  colorTo: pink
6
- sdk: docker
 
 
7
  pinned: false
8
  license: mit
 
9
  ---
10
 
11
  # πŸ₯Έ AI Meme Generator
12
 
13
- Automatically generate custom memes using AI browser automation! The agent browses ImgFlip and creates memes based on your description.
14
 
15
- ## πŸš€ Features
16
 
17
- - πŸ€– Multiple free AI models (Llama, Qwen, Mistral, Phi)
18
- - 🌐 Automatic browser navigation on ImgFlip
19
- - 🎨 AI-generated meme text
20
- - πŸ“± Responsive Gradio interface
21
- - ⚑ Real-time status updates
22
- - 🐳 Dockerized for Python 3.11 compatibility
23
 
24
- ## πŸ“‹ Setup Instructions
 
 
 
 
 
 
25
 
26
- ### Required: HuggingFace Token
27
-
28
- 1. Get a **free** token from [HuggingFace Tokens](https://huggingface.co/settings/tokens)
29
- 2. Go to your Space **Settings** β†’ **Repository Secrets**
30
- 3. Add new secret:
31
- - **Name**: `HF_TOKEN`
32
- - **Value**: Your token (starts with `hf_...`)
33
- 4. Restart the Space
34
 
35
  ## 🎯 Usage
36
 
37
- 1. Enter meme idea (e.g., "When the code works on first try")
38
  2. Select AI model (Llama 3.2 3B recommended)
39
- 3. Click "Generate Meme"
40
  4. Wait 30-90 seconds
41
  5. Download your meme!
42
 
43
  ## πŸ› οΈ Tech Stack
44
 
45
- - **Python**: 3.11 (via Docker)
46
- - **Frontend**: Gradio 4.44
47
- - **Browser Automation**: Browser-Use 0.8.1 + Playwright
48
- - **AI Models**: HuggingFace Inference API
49
- - **LLM Framework**: LangChain
 
50
 
51
  ## πŸ“¦ Files
52
 
53
- - `Dockerfile` - Custom Docker image with Python 3.11
54
- - `app.py` - Main application code
55
  - `requirements.txt` - Python dependencies
56
- - `README.md` - This file
 
 
57
 
58
- ## ⚠️ Important Notes
59
 
60
- - **Python 3.11 Required**: browser-use needs Python 3.11+, hence the Dockerfile
61
- - **Rate Limits**: Free tier has limits, wait 60s between requests if needed
62
- - **Generation Time**: 30-90 seconds (browser automation is slow but accurate)
63
- - **Best Model**: Llama 3.2 3B for speed + reliability
64
 
65
  ## πŸ› Troubleshooting
66
 
67
- - **Build Error**: Make sure all files (especially Dockerfile) are committed
68
- - **Token Error**: Verify HF_TOKEN is in Repository Secrets
69
- - **Rate Limit**: Wait 60 seconds between generations
70
- - **Timeout**: Use Llama 3.2 3B (fastest model)
 
 
71
 
72
  ## πŸ“œ License
73
 
74
- MIT License - Feel free to fork and customize!
75
 
76
  ---
77
 
78
- Made with ❀️ using HuggingFace, Browser-Use, and Gradio
 
3
  emoji: πŸ₯Έ
4
  colorFrom: purple
5
  colorTo: pink
6
+ sdk: gradio
7
+ sdk_version: 4.44.0
8
+ app_file: app.py
9
  pinned: false
10
  license: mit
11
+ python_version: 3.11
12
  ---
13
 
14
  # πŸ₯Έ AI Meme Generator
15
 
16
+ AI-powered meme creation using browser automation!
17
 
18
+ ## ⚑ Quick Setup
19
 
20
+ 1. **Get HuggingFace Token**
21
+ - Go to: https://huggingface.co/settings/tokens
22
+ - Create new token with 'read' permission
23
+ - Copy the token (starts with `hf_...`)
 
 
24
 
25
+ 2. **Add Token to Space**
26
+ - Go to Space Settings
27
+ - Click "Repository Secrets"
28
+ - Add secret:
29
+ - Name: `HF_TOKEN`
30
+ - Value: (paste your token)
31
+ - Save
32
 
33
+ 3. **Restart Space**
 
 
 
 
 
 
 
34
 
35
  ## 🎯 Usage
36
 
37
+ 1. Describe your meme idea
38
  2. Select AI model (Llama 3.2 3B recommended)
39
+ 3. Click "Generate"
40
  4. Wait 30-90 seconds
41
  5. Download your meme!
42
 
43
  ## πŸ› οΈ Tech Stack
44
 
45
+ - Python 3.11
46
+ - Gradio 4.44
47
+ - Browser-Use 0.8.1
48
+ - LangChain
49
+ - Playwright
50
+ - HuggingFace Inference API
51
 
52
  ## πŸ“¦ Files
53
 
54
+ - `app.py` - Main application
 
55
  - `requirements.txt` - Python dependencies
56
+ - `packages.txt` - System dependencies
57
+ - `.python-version` - Python version
58
+ - `README.md` - Documentation
59
 
60
+ ## ⚠️ Important
61
 
62
+ - Uses Python 3.11 (required for browser-use)
63
+ - Free tier has rate limits
64
+ - Generation takes 30-90 seconds
65
+ - Requires HF_TOKEN in secrets
66
 
67
  ## πŸ› Troubleshooting
68
 
69
+ | Issue | Solution |
70
+ |-------|----------|
71
+ | Build fails | Check all files are committed |
72
+ | Token error | Verify HF_TOKEN in Secrets |
73
+ | Rate limit | Wait 60 seconds |
74
+ | Timeout | Use Llama 3.2 3B model |
75
 
76
  ## πŸ“œ License
77
 
78
+ MIT License
79
 
80
  ---
81
 
82
+ Made with ❀️ using HuggingFace