|
|
--- |
|
|
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](https://www.loom.com/share/643590088f2d4e3f9d2e805ce368fa0f) |
|
|
|
|
|
[Social Meedia Post on X](https://x.com/tejasashinde/status/1994716784080068750) |
|
|
|
|
|
--- |
|
|
|
|
|
### ✨ 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](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](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](https://tokenfactory.nebius.com/) |
|
|
|
|
|
* **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](https://tokenfactory.nebius.com/) |
|
|
|
|
|
--- |
|
|
|
|
|
### 🛠️ Core Functionality Overview |
|
|
|
|
|
1. User enters **name**, **age** and selects **tone**, **theme**, and **recipient type**. |
|
|
2. The system fetches the **best-matching birthday wish_text** from the Hugging Face dataset. |
|
|
3. Flux Dev generates a **personalized background image** using the same parameters and gpt-oss/120b model generates a short personalized wish using same parameters. |
|
|
4. The matching **wish_text** + **background image** are loaded into a **Fabric.js canvas** for full customization. |
|
|
5. User downloads the final, edited card as a **JPEG**. |
|
|
6. Can repeat the same process via MCP Server. |
|
|
|
|
|
--- |
|
|
|
|
|
### 🧪 Steps to run the app: |
|
|
|
|
|
1) Install dependencies after clonning with: |
|
|
```bash |
|
|
pip install -r requirements.txt |
|
|
``` |
|
|
2) Put your Nebius API token in .env |
|
|
3) Run the app with: |
|
|
```bash |
|
|
python app.py |
|
|
``` |
|
|
|
|
|
Made with ❤️ using **Gradio, GPT-OSS/120B, Nebius API** for [MCP 1st Birthday](https://huggingface.co/MCP-1st-Birthday) on [Hugging Face](https://huggingface.co)🤗 |
|
|
|
|
|
Created by [tejasashinde](https://huggingface.co/tejasashinde) |
