Skip to content

nitinyadav2188/MemeCam

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 

Repository files navigation

😂 MemeCam: Your face is the punchline

Welcome to MemeCam, the ultimate web app that turns your facial expressions into hilarious, shareable memes in seconds!

Using the power of AI, MemeCam analyzes your mood from a webcam photo and instantly generates captions, roasts, alter egos, absurd stories, and much more—all in your browser.

✨ Features

  • 📸 Live Webcam Capture – Snap a real-time photo directly in the app.
  • 😄 AI Emotion Detection – Detects your emotion using face-api.js.
  • ✍️ AI-Generated Captions – Top and bottom meme text based on your expression.
  • 🔥 "Roast Me" Mode – Get roasted by the AI (only if you can handle it).
  • 🦸‍♀️ "My Alter Ego" Mode – Become a ridiculous superhero or villain.
  • 📜 "Generate Story" Mode – AI writes a crazy story explaining your face.
  • 🤡 Draggable Stickers – Add emojis like 😂 💀 😭 with drag-and-drop.
  • 🎤 Voice-to-Caption – Speak your meme caption using your mic.
  • 💾 Download & Share – Export high-quality JPEGs or share instantly.
  • 📱 Fully Responsive – Works perfectly on phones, tablets, and desktops.

🚀 How to Use

🧪 Step 1: Get Your Gemini API Key

  1. Visit Google AI Studio: https://aistudio.google.com/app
  2. Sign in and click "Get API Key"
  3. Copy the key

🛠 Step 2: Add Your API Key

  1. Open index.html in a code editor
  2. Replace "YOUR_GEMINI_API_KEY" with your actual API key

🖥 Step 3: Launch MemeCam

  • Save your changes.
  • Open index.html in Google Chrome or Firefox.
  • Allow webcam access when prompted.
  • Wait for AI models to load — the "🚀 Launch MemeCam" button will become active.
  • Click "📸 Capture Photo" – a countdown will begin.
  • Click "🧠 Analyze Face" to unlock meme modes.

🤹 Step 4: Play with AI Super Modes

Choose your favorite mode:

  • Roast Me
  • Alter Ego
  • Story Mode
  • Voice-to-Caption

Then:

  • Edit top/bottom text
  • Drag and drop emoji stickers
  • Click "💾 Download Meme"

🛠️ Technologies Used

  • HTML5, Tailwind CSS, JavaScript (ES6+)
  • face-api.js (built on TensorFlow.js)
  • Google Gemini API
  • html2canvas

How to Contribute?

  1. Fork the repo
  2. Clone it to your local system
  3. Create a new branch: git checkout -b patch-1
  4. Make your changes
  5. Push: git push origin patch-1
  6. Create a Pull Request!

Labels Used

  • good first issue
  • documentation
  • hacktoberfest

Contributions Welcome!

Make sure you follow Hacktoberfest rules and submit quality PRs.

👤 Credits

Created by Nitin Yadav

  • Twitter: @nitinyadav2188

MemeCam – Because your face deserves to be meme-worthy 😎

Releases

No releases published

Packages

 
 
 

Contributors

Languages