Thanks to visit codestin.com
Credit goes to github.com

Skip to content

LUME is an AI-powered app that turns your images into viral memes. Upload a photo, add an optional trending topic, and let Lume use BLIP and Groq AI to craft witty, high-quality captions with stylish overlays—ready to download and share instantly.

Notifications You must be signed in to change notification settings

AaryanGole26/LUME

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LUME — Personalised AI Meme Generator

Render Deploy

Welcome to LUME, an AI-powered meme generator that transforms your images into hilarious memes with dynamic captions! Using the BLIP model for image description and the Groq API for witty captions, this Streamlit app lets you upload images, add trending topics, and create shareable memes.


Features

  • Image Upload: Upload JPG or PNG images (max 200MB).

  • URL Support: Generate memes from online image URLs.

  • Dynamic Captions: AI-generated captions tailored to image content and trends.

  • Orientation Handling: Automatically adjusts captions for rotated images (90°, 180°, 270°).

  • Downloadable Output: Save your memes as PNG files.

  • Trend Integration: Add hot topics (e.g., "Twitter Drama") for extra flair.


Installation

Prerequisites

  • Python 3.12+
  • Pip (Python package manager)
  • A Groq API key (sign up at groq.com)

Steps:

  1. Clone the Repository:
    git clone https://github.com/AaryanGole26/lumeai-meme-generator.git
    cd lumeai-meme-generator
    
  2. Install Dependencies:
    pip install -r requirements.txt
    
  3. Set Up Environment Variables: Create a .env file:
    GROQ_API_KEY=your_groq_api_key
    
  4. Run Locally: Start the Streamlit app:
     streamlit run app.py
    
  5. Access it at http://localhost:8501

Usage

Select Source:

Choose "Upload Image" to upload a file or "Image URL" to enter a link.

Add Trend (Optional):

Input a trend (e.g., "Twitter Drama") for a themed caption.

Generate Lume:

Click "Create Lume Meme" to process the image and display the result.

Download:

Save the meme using the "Save your Lume" button.


Contributing

We welcome contributions! To get started:

  1. Fork the repository.
  2. Create a branch: git checkout -b feature/your-feature.
  3. Commit changes: git commit -m "Add your feature".
  4. Push to GitHub: git push origin feature/your-feature.
  5. Open a Pull Request.

Acknowledgements

  • BLIP Model: Powered by Salesforce for image captioning.
  • Groq API: Provides fast, witty caption generation.
  • Render: Hosts the app with free tier support.

About

LUME is an AI-powered app that turns your images into viral memes. Upload a photo, add an optional trending topic, and let Lume use BLIP and Groq AI to craft witty, high-quality captions with stylish overlays—ready to download and share instantly.

Topics

Resources

Stars

Watchers

Forks