Spaces:

MCP-1st-Birthday
/

birthdayGreetingCardGenerator

Running

App Files Files Community

birthdayGreetingCardGenerator / README.md

tejasashinde

Added steps to tun the app in README

8af77ed verified 14 days ago

preview code

raw

history blame contribute delete

3.42 kB

A newer version of the Gradio SDK is available: 6.1.0

Upgrade

metadata

title: Birthday Greeting Card Generator
emoji: 🎂
colorFrom: red
colorTo: yellow
sdk: gradio
sdk_version: 5.49.1
app_file: app.py
pinned: true
license: mit
short_description: Create beautifully personalized cards for ages 1 to 100
tags:
  - building-mcp-track-creative
  - birthday-greeeting-card
  - mcp-1st-birthday
  - gradio

🎂 Birthday Greeting Card Generator

Create beautifully personalized cards for ages 1 to 100 using AI

🚀 Purpose

This app helps create personalized birthday cards by combining many parameeters like recepient type, tone, theme, age, and an interactive Fabric.js editor — allowing anyone to create, customize, and download a beautiful birthday card effortlessly.

Watch Birthday Greeting Card Generator in action

Social Meedia Post on X

✨ Key Features of Birthday Greeting Card Generator

🎯 Personalized birthday wish selection based on tone, theme, age, and recipient type from https://huggingface.co/datasets/tejasashinde/birthday_quotes_1_to_100 dataset
🖼️ AI-generated background images using Flux Dev, matched to the selected parameters
✏️ Fully Interactive editable greeting card canvas using Fabric.js, allowing drag, resize, modify text, and add extra elements
📥 One-click download of the final birthday card as a JPEG image

🧠 Models, Dataset, and APIs Used

Birthday Quote 1 to 100 Dataset:
Custom curated dataset taken from https://huggingface.co/datasets/tejasashinde/birthday_quotes_1_to_100 is used to match the most relevant greeting based on user-selected parameters.
Image Generation Model:
Flux Dev used to generate themed background images for the greeting card via Nebius API - Token factory
Canvas Editor:
Integrated Fabric.js for interactive, element-wise editing inside the canvas for full customization.
Personalized Wish:
Generate short personalized wish using GPT-OSS/120B model via Nebius API - Token factory

🛠️ Core Functionality Overview

User enters name, age and selects tone, theme, and recipient type.
The system fetches the best-matching birthday wish_text from the Hugging Face dataset.
Flux Dev generates a personalized background image using the same parameters and gpt-oss/120b model generates a short personalized wish using same parameters.
The matching wish_text + background image are loaded into a Fabric.js canvas for full customization.
User downloads the final, edited card as a JPEG.
Can repeat the same process via MCP Server.

🧪 Steps to run the app:

Install dependencies after clonning with:

pip install -r requirements.txt

Put your Nebius API token in .env
Run the app with:

python app.py

Made with ❤️ using Gradio, GPT-OSS/120B, Nebius API for MCP 1st Birthday on Hugging Face🤗

Created by tejasashinde