valentine_day_gift

💝 AI Valentine’s Day Gift Generator

An AI-powered application that generates personalized love poems and sends them to your email. Built with Flask, OpenAI API (via 3d7tech), Gmail, and Twitter integration.

Features

✨ AI-Generated Poems - Create unique, romantic love poems using advanced AI 📧 Email Delivery - Receive your poems as beautifully formatted PDFs via Gmail 🐦 Social Sharing - Share your poems on Twitter/X with one click 🎨 Beautiful Design - Modern, responsive web interface 📱 Mobile Friendly - Works on all devices 🔒 Privacy First - Your data is secure

Live Demo

🌐 GitHub Pages: https://richardawe.github.io/valentine_day_gift/

Setup Instructions

Prerequisites

Python 3.8+
Gmail account with app-specific password
Twitter/X API credentials
3d7tech API access (free tier available)

Installation

Clone the repository:

git clone https://github.com/richardawe/valentine_day_gift.git
cd valentine_day_gift

Create a virtual environment:

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

Install dependencies:
```
pip install -r requirements.txt
```

Create a .env file with your credentials:

OPENAI_API_KEY=not-needed
TWITTER_API_KEY=your_twitter_key
TWITTER_API_SECRET=your_twitter_secret
TWITTER_ACCESS_TOKEN=your_access_token
TWITTER_ACCESS_SECRET=your_access_secret
GMAIL_USER=your_email@gmail.com
GMAIL_APP_PASSWORD=your_app_password
TEST_EMAIL=your_email@gmail.com
API_BASE_URL=https://api.3d7tech.com/v1

Run the Flask app:
```
python app.py
```
Open your browser and navigate to:
```
http://localhost:5000
```

Configuration

Gmail Setup

Enable 2-factor authentication on your Google Account
Generate an App Password
Use the app password in your .env file

Twitter/X API Setup

Create a Developer Account at Twitter Developer Portal
Create a new app and get your API credentials
Add credentials to .env file

3d7tech API

The app uses the free 3d7tech API for AI poem generation. It’s OpenAI-compatible and runs Ollama models.

Website: https://api.3d7tech.com/

Usage

Via Web Interface

Visit http://localhost:5000
Enter your email address
Describe your love story or poem idea
Optionally enable Twitter sharing
Click “Generate & Send Poem”
Check your email for the PDF poem

Command Line (Original Script)

python ai_valentine.py "Your poem prompt here"

This will:

Fetch Valentine’s Day trends
Ideate a product concept
Post to Twitter
Generate a love poem
Create a PDF
Send via Gmail

Project Structure

valentine_day_gift/
├── app.py                 # Flask backend application
├── ai_valentine.py        # Original CLI script
├── templates/
│   └── index.html        # Web frontend
├── docs/
│   └── index.html        # GitHub Pages landing page
├── .env                  # Environment variables (create this)
├── requirements.txt      # Python dependencies
└── README.md            # This file

APIs Used

3d7tech API - AI poem generation (OpenAI-compatible)
Gmail SMTP - Email delivery
Twitter API v2 - Social sharing
Google Trends API - Trend analysis (original script)

Files

app.py - Flask web application with API endpoints
ai_valentine.py - Original CLI version with full workflow
templates/index.html - Web interface
docs/index.html - GitHub Pages landing page

API Endpoints

POST `/api/generate-poem`

Generate a poem and send via email.

Request:

{
  "email": "recipient@example.com",
  "prompt": "Your love story or poem idea",
  "share_on_twitter": true
}

Response:

{
  "success": true,
  "message": "Poem generated and sent!",
  "poem": "The generated poem text...",
  "tweet_url": "https://x.com/status/..."
}

GET `/api/tweets`

Retrieve all tweets sent.