added all code

requirements.txt

@@ -0,0 +1,134 @@
+aiofiles==23.2.1
+annotated-types==0.7.0
+anyio==4.4.0
+argon2-cffi==23.1.0
+argon2-cffi-bindings==21.2.0
+arrow==1.3.0
+asttokens==2.4.1
+async-lru==2.0.4
+attrs==24.2.0
+babel==2.16.0
+beautifulsoup4==4.12.3
+bleach==6.1.0
+certifi==2024.7.4
+cffi==1.17.0
+charset-normalizer==3.3.2
+click==8.1.7
+comm==0.2.2
+contourpy==1.2.1
+cycler==0.12.1
+debugpy==1.8.5
+decorator==5.1.1
+defusedxml==0.7.1
+distro==1.9.0
+exceptiongroup==1.2.2
+executing==2.0.1
+fastapi==0.112.0
+fastjsonschema==2.20.0
+ffmpy==0.4.0
+filelock==3.15.4
+fonttools==4.53.1
+fqdn==1.5.1
+fsspec==2024.6.1
+gradio==4.41.0
+gradio_client==1.3.0
+h11==0.14.0
+httpcore==1.0.5
+httpx==0.27.0
+huggingface-hub==0.24.5
+idna==3.7
+importlib_resources==6.4.0
+ipykernel==6.29.5
+ipython==8.26.0
+isoduration==20.11.0
+jedi==0.19.1
+Jinja2==3.1.4
+jiter==0.5.0
+json5==0.9.25
+jsonpointer==3.0.0
+jsonschema==4.23.0
+jsonschema-specifications==2023.12.1
+jupyter-events==0.10.0
+jupyter-lsp==2.2.5
+jupyter_client==8.6.2
+jupyter_core==5.7.2
+jupyter_server==2.14.2
+jupyter_server_terminals==0.5.3
+jupyterlab==4.2.4
+jupyterlab_pygments==0.3.0
+jupyterlab_server==2.27.3
+kiwisolver==1.4.5
+markdown-it-py==3.0.0
+MarkupSafe==2.1.5
+matplotlib==3.9.2
+matplotlib-inline==0.1.7
+mdurl==0.1.2
+mistune==3.0.2
+nbclient==0.10.0
+nbconvert==7.16.4
+nbformat==5.10.4
+nest-asyncio==1.6.0
+notebook_shim==0.2.4
+numpy==2.0.1
+openai==1.40.6
+orjson==3.10.7
+overrides==7.7.0
+packaging==24.1
+pandas==2.2.2
+pandocfilters==1.5.1
+parso==0.8.4
+pexpect==4.9.0
+pillow==10.4.0
+platformdirs==4.2.2
+prometheus_client==0.20.0
+prompt_toolkit==3.0.47
+psutil==6.0.0
+ptyprocess==0.7.0
+pure_eval==0.2.3
+pycparser==2.22
+pydantic==2.8.2
+pydantic_core==2.20.1
+pydub==0.25.1
+Pygments==2.18.0
+pyparsing==3.1.2
+python-dateutil==2.9.0.post0
+python-dotenv==1.0.1
+python-json-logger==2.0.7
+python-multipart==0.0.9
+pytz==2024.1
+PyYAML==6.0.2
+pyzmq==26.1.0
+referencing==0.35.1
+requests==2.32.3
+rfc3339-validator==0.1.4
+rfc3986-validator==0.1.1
+rich==13.7.1
+rpds-py==0.20.0
+ruff==0.5.7
+semantic-version==2.10.0
+Send2Trash==1.8.3
+shellingham==1.5.4
+six==1.16.0
+sniffio==1.3.1
+soupsieve==2.6
+stack-data==0.6.3
+starlette==0.37.2
+terminado==0.18.1
+tinycss2==1.3.0
+tomli==2.0.1
+tomlkit==0.12.0
+tornado==6.4.1
+tqdm==4.66.5
+traitlets==5.14.3
+typer==0.12.3
+types-python-dateutil==2.9.0.20240316
+typing_extensions==4.12.2
+tzdata==2024.1
+uri-template==1.3.0
+urllib3==2.2.2
+uvicorn==0.30.6
+wcwidth==0.2.13
+webcolors==24.8.0
+webencodings==0.5.1
+websocket-client==1.8.0
+websockets==12.0

src/app.py

@@ -0,0 +1,63 @@
+import sys
+from PIL import Image
+
+sys.path.append(".")
+from utils import (
+    generate_dummy_data,
+    generate_summary,
+    generate_welcome_message,
+)
+from prompts import CAMPAIGN_DESCR
+
+import gradio as gr
+
+
+df = generate_dummy_data()
+print(df)
+
+campaign_names = list(CAMPAIGN_DESCR.keys())
+
+
+def process_customer_selection(customer_name, campaign_name):
+    customer_data = df[df["Name"] == customer_name].iloc[0]
+    print(customer_data)
+    summary = generate_summary(customer_data)
+    message = generate_welcome_message(summary, campaign_name)
+
+    # select the appropriate hero image for each campaign
+    if campaign_name == "Summer Clearance":
+        campaign_image = "../img/strung-beads.png"
+    elif campaign_name == "Makehaul":
+        campaign_image = "../img/canvas.png"
+    elif campaign_name == "Lowest Prices Of the Season":
+        campaign_image = "../img/photo-keeper.png"
+    else:
+        print("Invalid Campaign Name")
+
+    image = Image.open(campaign_image)
+
+    return summary, message, image
+
+
+def create_gradio_app():
+    customer_names = df["Name"].tolist()
+
+    interface = gr.Interface(
+        fn=process_customer_selection,
+        inputs=[
+            gr.Dropdown(choices=customer_names, label="Select a Customer"),
+            gr.Dropdown(choices=campaign_names, label="Select a Campaign"),
+        ],
+        outputs=[
+            gr.Textbox(label="Customer Summary [Input]"),
+            gr.Textbox(label="Personalized Welcome Message [Output]"),
+            gr.Image(label="Campaign Hero Product"),
+        ],
+        title="Personalized Email Content Generator",
+    )
+
+    interface.launch(share=True)
+
+
+# Run the Gradio app
+create_gradio_app()

src/prompts.py

@@ -0,0 +1,50 @@
+SYSTEM_PROMPT = (
+    f"You are a marketing manager who can create personalized messages for customers based on some transaction and segment data about them."
+    f"Make sure you mention the latest product that the customer purchased and also the customer's recency of purchase. However, don't mention the exact number of days. Just use qualitative words such as 'recently', 'a while ago', etc."
+    f"Recognize the customer's favorite department but don't mention the department name explicitly."
+    f"The message should be friendly and encourage the customer to make another purchase. Use the campaign hero product for this."
+    f"The message should be about 70 to 100 words long."
+    f"Remember to keep the message professional and respectful. Do not include any exclusive offers or discounts in the message."
+    f"Also generate the subject line for the email. The subject line should be about 5 to 10 words long."
+    f"The subject line may contain a relevant emoji or two."
+    f"Don't use the customer's name in the message or any other personal information."
+    f"In addition, please create a 'hero message' for this customer. The hero message is like a tagline to inspiring the customer. Here are a few examples: 'Craft it yourself', 'Express your creativity', 'Keep inspiring'. It should be less than six words long."
+)
+
+PERSONA_DESCR = {
+    "Artist": (
+        f"\nThe following type of message would appeal to this customer: "
+        f"Michaels helps you make what no one else can. "
+        f"Position the brand as a place for artists and creatives to bring their ideas to life with essentials at good value, with a bit of whimsy and magic to be discovered."
+    ),
+    "Creator": (
+        f"\nThe following type of message would appeal to this customer: "
+        f"Delight and inspire your biggest fans by giving them what they love, which is variety and inspiration. Explore ways to re-think product selection, notably in décor, to increase spend across the store."
+    ),
+    "Curator": (
+        f"\nThe following type of message would appeal to this customer: "
+        f"The curator cares about making their homes and spaces beautiful and unique. "
+        f"Show them that Michaels is the place to get that trend they’re inspired by without losing the unique touch that makes it their own."
+    ),
+    "Seeker": (
+        f"\nThe following type of message would appeal to this customer: "
+        f"Make their shopping experience quick and remove friction. "
+        f"They are busy, but motivated and enjoy a little retail therapy. "
+        f"Encourage projects and products that aren’t overly complicated, kits that eliminate multiple trips and planning, and fun for kids."
+    ),
+}
+
+CAMPAIGN_DESCR = {
+    "Summer Clearance": (
+        f"Campaign Name: Summer Clearance\n"
+        f"Campaign Objective: 'This campaign should encourage customers to shop now and get up to 70% off even more items during Clearance Event. This is an online-only event offering 70% off on all custom frame collections and other items.'\n"
+    ),
+    "Makehaul": (
+        f"Campaign Name: Makehaul\n"
+        f"Campaign Objective: 'This campaign offers BOGO (Buy One Get One Free) offers on thousands of items. Customers can get 70% off on all custom frames collections.'\n"
+    ),
+    "Lowest Prices Of the Season": (
+        f"Campaign Name: Lowest Prices Of the Season\n"
+        f"Campaign Objective: 'This campaign comes with the BEST offers on thousands of items. These offers are rare as they happen only three times a year.'\n"
+    ),
+}

src/utils.py

@@ -0,0 +1,121 @@
+import pandas as pd
+from openai import OpenAI
+from dotenv import load_dotenv
+import os
+
+import sys
+
+sys.path.append(".")
+from prompts import SYSTEM_PROMPT, PERSONA_DESCR, CAMPAIGN_DESCR
+
+load_dotenv("../.env")
+client = OpenAI(api_key=os.getenv("OPENAI_API_KEY"))
+
+
+def generate_summary(customer_data):
+    customer_value = "high" if customer_data["Revenue"] >= 250 else "low"
+    customer_recency = "recent" if customer_data["Recency"] <= 60 else "not recent"
+
+    seg = customer_data["Segment"]
+    if seg == "Artist":
+        cust_seg_descr = PERSONA_DESCR["Artist"]
+    elif seg == "Creator":
+        cust_seg_descr = PERSONA_DESCR["Creator"]
+    elif seg == "Curator":
+        cust_seg_descr = PERSONA_DESCR["Curator"]
+    elif seg == "Seeker":
+        cust_seg_descr = PERSONA_DESCR["Seeker"]
+    else:
+        print("Invalid Segment")
+
+    summary = (
+        f"This is a {customer_value} value customer who has spent a total of {customer_data['Revenue']} dollars. "
+        f"Their most recent transaction was {customer_data['Recency']} days ago, which makes him/her a {customer_recency} customer. "
+        f"The latest product they purchased was {customer_data['LatestProduct']}. "
+        f"Their favorite department is {customer_data['FavoriteDepartment']}. "
+        f"{cust_seg_descr} ({seg})"
+    )
+    return summary
+
+
+def generate_welcome_message(summary, campaign_name):
+    campaign_description = "The personalize message should align with the marketing campaign described below: "
+
+    if campaign_name == "Summer Clearance":
+        campaign_description += CAMPAIGN_DESCR["Summer Clearance"] + "\n"
+    elif campaign_name == "Makehaul":
+        campaign_description += CAMPAIGN_DESCR["Makehaul"] + "\n"
+    elif campaign_name == "Lowest Prices Of the Season":
+        campaign_description += CAMPAIGN_DESCR["Lowest Prices Of the Season"] + "\n"
+    else:
+        print("Invalid Campaign Name")
+
+    summary += f"{campaign_description}"
+
+    response = client.chat.completions.create(
+        model="gpt-4o-mini",
+        messages=[
+            {"role": "system", "content": SYSTEM_PROMPT},
+            {"role": "user", "content": summary},
+        ],
+    )
+
+    message = response.choices[0].message.content
+    return message
+
+
+def generate_dummy_data():
+    data = {
+        "Name": [
+            "Alice",
+            "Bob",
+            "Charlie",
+            "David",
+            "Eva",
+            "Frank",
+            "Grace",
+            "Henry",
+            "Ivy",
+            "John",
+        ],
+        "Recency": [20, 50, 100, 10, 120, 70, 30, 150, 60, 40],
+        "Revenue": [200, 350, 150, 400, 100, 250, 300, 80, 330, 280],
+        "LatestProduct": [
+            "All Strung Beads",
+            "Permanent and Removable Vinyl",
+            "Creatology Baskets",
+            "Kids Storage",
+            "Lap Trays",
+            "Lemax Spooky Town Collection",
+            "Frames & Shadow Boxes",
+            "ALL Fall Stems",
+            "Folding Step Stool",
+            "Mini Sticker Printer",
+        ],
+        "FavoriteDepartment": [
+            "KIDS ART & EDUCATION",
+            "HOBBY CRAFTS",
+            "BAKEWARE",
+            "FRAMES",
+            "PAPERCRAFTING",
+            "STORAGE",
+            "HOBBY CRAFTS",
+            "FLORAL ACCESSORIES",
+            "HOBBY CRAFTS",
+            "KIDS ART & EDUCATION",
+        ],
+        "Segment": [
+            "Artist",
+            "Creator",
+            "Curator",
+            "Artist",
+            "Seeker",
+            "Curator",
+            "Artist",
+            "Seeker",
+            "Creator",
+            "Curator",
+        ],
+    }
+
+    return pd.DataFrame(data)