Skip to content

Anubhab-Rakshit/excuse-generator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

17 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🎭 AI Excuse Generator

An AI-driven excuse generation tool that formulates creative excuses based on user input using Natural Language Processing (NLP).


✨ Features

βœ… Context-Aware Tone Selection

  • Choose from Formal, Sarcastic, or Funny tones for dynamic adaptability.

βœ… AI-Powered Excuse Generation

  • Uses Google Gemini API to craft personalized and unique excuses.

βœ… Integrated Social Media Sharing

  • Instantly share your excuse on Twitter/X with one click.

βœ… Hidden Easter Eggs

  • Gamification elements for user engagement. Try different inputs to discover them!

βœ… Smart Emoji Suggestions

  • Sentiment analysis suggests relevant emojis for a perfect excuse.

πŸ›  Tech Stack

  • Backend: Node.js, Express.js, Google Gemini API
  • Frontend: React.js, React-Icons
  • API Handling: Axios
  • Environment Variables: dotenv

πŸŽ₯ Demo / Mockup

Generated Excuse Screenshot


πŸ— Installation & Setup

1️⃣ Clone the Repository

git clone https://github.com/Kausheya2006/AI_Excuse_Gen.git
cd vlab_project

2️⃣ Install Dependencies

npm install

3️⃣ Set Up Environment Variables Create a .env file in the root directory and add:

GOOGLE_GEMINI_API_KEY=your_api_key_here

4️⃣ Run the App

npm start

πŸ›  API Usage

Generate an Excuse

Endpoint:

POST /api/generate-excuse

Request Body:

{
  "context": "I forgot to submit my assignment",
  "tone": "Funny"
}

Response Example:

{
  "excuse": "Oh no! My pet goldfish was watching YouTube and accidentally deleted my assignment!"
}

🀝 Contributing

Contributions are welcome! Feel free to fork the repo and submit a pull request.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published