AI Meme Generator Agent

A local Streamlit app that uses a browser automation agent to generate memes on ImgFlip. Users enter a meme idea, choose a model provider, and the app drives a browser to select a template, add captions, generate the meme, and show the resulting image link.

Features

• Streamlit web UI for entering meme ideas.
• Supports Claude, DeepSeek, and OpenAI model providers.
• Reads API keys from .env or from the Streamlit sidebar.
• Uses browser-use and Playwright to automate ImgFlip.
• Displays the generated meme preview and direct image URL.

Project Layout

ai_meme_generator_agent_browseruse/
  app.py
  requirements.txt
  .env.example
  run.ps1
  run.sh

Requirements

• Python 3.10 or 3.11
• Network access to ImgFlip, Playwright browser downloads, and your selected model provider
• One API key for the model provider you choose:
  • OPENAI_API_KEY
  • ANTHROPIC_API_KEY
  • DEEPSEEK_API_KEY

Setup

cd ai_meme_generator_agent_browseruse
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install -r requirements.txt
python -m playwright install
Copy-Item .env.example .env

Fill in the matching key in .env, or enter it in the app sidebar at runtime.

Run

Windows PowerShell:

.\run.ps1

macOS/Linux:

chmod +x run.sh
./run.sh

Or run Streamlit directly:

python -m streamlit run app.py

Then open the local URL shown by Streamlit, usually http://localhost:8501.

Security

Do not commit .env, API keys, Streamlit secrets, virtual environments, caches, or logs. The repository includes .env.example only as a template.