SLUUG/STLLUG Marketing Content Generation

The code in this repository is used to supplement our regular meeting content with "marketing" material that can be used to spread the word about our SLUUG and STLLUG meetings. This content includes things like:

• Enthusiastic tweets that encourage people to attend the meeting.
• Titles we can use when the recording of the meeting is posted to YouTube.
• Images that can be used on the website and as a Thumbnail for the YouTube video.
• Tags/Categories for each Presentation

OpenAI API Cost

This script calls the OpenAI API. Prices fluctuate. As of 2024-06-15, each run of this script costs approximately fifteen cents. ($0.15)

Running the Script

This guide will help you run the script. Follow these steps to get started:

Prerequisites

• This script has been tested to work on Bash and Powershell v7 (pwsh.exe not the old powershell.exe).
• Ensure you have Node.js installed on your system. The recommended version is specified in the .nvmrc file.
• This script uses the OpenAI API. To call it, you need to supply an OpenAI API Key. Follow these steps to get your key and set it as an environment variable:
  1. Visit the OpenAI API Keys page and sign up or log in and create an API key.
  2. Once you have your API key, set it as an environment variable on your system:
     • On Bash: Open your .bashrc file in a text editor and add the following line:

       export OPENAI_API_KEY='your_api_key_here'

       Replace your_api_key_here with your actual API key. Then, save the file and run source ~/.bashrc to apply the changes.
     • On PowerShell: Open PowerShell and run the following command:

       [System.Environment]::SetEnvironmentVariable('OPENAI_API_KEY', 'your_api_key_here', [System.EnvironmentVariableTarget]::User)

       Replace your_api_key_here with your actual API key. This will set the API key for the current user. You will need to restart PowerShell for the changes to take effect.

Setup

1. Clone the Repository: Clone this repository to your local machine using your preferred Git client or the command line:

   git clone [email protected]:seantwie03/sluug_stllug_generation.git

2. Install Dependencies: Navigate to the root directory of the cloned repository and install the required Node.js dependencies:

   cd ./sluug_stllug_generation
   npm install

3. Modify the Template File: Inside the templates directory there is a sluug.json file as well as a stllug.json file. Modify the appropriate file based on the meeting you are preparing.

Running the Script

After completing the setup, you can run the script using the appropriate command below:

npm run start:sluug
# or
npm run start:stllug

The script typically takes approximately 1 minute to run depending on OpenAI API response times.

You can pass the -v argument to see verbose output. Example:

npm run start:sluug -- -v

Output

The script outputs to the dist directory. After running the script you should see a JSON file and several images. The JSON file will contain the contents of the input file with additional AI-generated information added.

This script will generate several options. Before you can copy the JSON file into the website's content collection you must chose between the options.

This script generates an array of Tweets for each presentation. The webiste only expects to receive a single tweet for each presentation. Delete the [] in the Tweet field, then delete all but one of the strings. Repeat this step for the youtubeTitle and image fields.

The script is not good at generating tags. You'll likely want to delete the generated tags and add your own instead. Try to re-use existing tags. See the list of existing tags by visiting the /tags/ page on the website. Only create new tags if absolutely necessary.