MMM-ChatGPT

This is a module for MagicMirror².

It fetches a response from ChatGPT using a configurable prompt at a configurable interval.

Prerequisites

You need a paid OpenAI account to be able to use this module.
At the time of writing this, the pricing is 0.002 per 1000 tokens, ~750 words (including prompt and response). For occasional requests, this is practically free, but you still need to set a payment method. You can, however, set a monthly limit to prevent accidental charges.
Once you have set up your account, generating API keys is possible in your user settings.

Installation

Navigate into your MagicMirrors modules folder:

cd ~/MagicMirror/modules

Clone this repository:

git clone https://github.com/ImanuelBertrand/MMM-ChatGPT.git

Add the following minimum configuration block to the modules array in the config/config.js file and adjust it to your liking:

{
    module: 'MMM-ChatGPT',
    position: 'bottom_bar',
    config: {
        apiKey: '[Your API Key]',
    }
},

Configuration

Option	Description
apiKey	Your API key, see prerequisites
updateInterval	Refresh interval in seconds Type: int Default 900 = 15 minutes
animationSpeed	Speed of the update animation in seconds Type: int Default 1
initialDelay	Delay before first update in seconds. Useful if the prompt needs to fetch data from the screen. Type: int Default 0
initialPrompt	The initial setup prompt. See examples. Type: string Default [] (None)
prompts	The prompts to use. See examples. Type: string Default [] (None)
loadingPlaceholder	The placeholder text to show while the request is loading Type: string Default Loading ...
model	The OpenAI model to use Type: string Default gpt-3.5-turbo
endpoint	The endpoint to use Type: string Default https://api.openai.com/v1/chat/completions
timeout	Timeout in seconds Type: int Default 5
retryDelay	Retry interval in seconds, in case the request fails Type: int Default 1
fontURL	Font URL to use for the text Type: string Default '' (None, use system default)
fontSize	CSS font size Type: string Default '' (None, use system default)
fontStyle	CSS font style Type: string Default '' (None, use system default)
color	CSS font color Type: string Default '' (None, use system default)
className	Class names to assign to the output Type: string Default light small

Advanced usage

If you define more than one prompt, the module will select one at random.
The inital prompt will be prefixed to the regular prompt. All prompts (both initial and regular) can contain code using {{code}} syntax. The code will be evaluated and replaced with the result. This allows you to fetch data from the screen and use it in the prompt. The code is evaluated in the context of the MagicMirror window, so you can use all the DOM API and other browser APIs.

Security warning

This module will, if configured to do so, execute code defined in the configuration.
This is intentional and not a bad thing, but (as always) be careful when copying code from the internet.

Example

This example relies on different modules to be present on the screen (1x time, 3x weather).
It fetches the current weather, the weather for later today and the weather for the coming days and uses it in the prompt. It also uses the initialPrompt to set up the prompt with the current weather data.

{
    module: 'MMM-ChatGPT',
    position: 'bottom_bar',
    config: {
        color: 'white',
        apiKey: '[API KEY]',
        updateInterval: 60 * 60,
        initialDelay: 1,
        initialPrompt: [{
            role: "system",
            content: "This is the current time: '{{document.querySelectorAll('.clock')[0].innerText}}'." +
                "This is the current weather including the time of sunset/sunrise: '{{document.querySelectorAll('.weather')[0].innerText}}'. " +
                "This is the weather for later today: '{{document.querySelectorAll('.weather')[1].innerText}}'. " +
                "This is the weather for the coming days: '{{document.querySelectorAll('.weather')[2].innerText}}'. "
        }],
        prompts: [
            [{
                role: "user",
                content: "Make a joke."
            }],
            [{
                role: "user",
                content: "Describe the current weather data in a slightly amusing way. Don't use more than one sentence."
            }],
            [{
                role: "user",
                content: "Describe the current weather in the style of the Wee Free Men from the novels of Terry Pratchett, but don't mention any specific names from the novels."
            }],
        ]
    }
},