valhassan / chatgpt-genius-plugin

Get song meanings, write song parodies, learn about artists and more with this ChatGPT plugin!

ChatGPT Genius Plugin

Get song meanings, write song parodies, learn about artists and more with this ChatGPT plugin!

You'll need plugin developer access to be able to install this plugin. If you do not already have plugin developer access on ChatGPT, please join the waitlist.

Setup

First, you'll need a Genius account and API Client. Sign up or login here, then create a new API client with the following details:

• App website URL: https://chat.openai.com
• Redirect URI: https://chat.openai.com/aip/plugin-some_plugin_id/oauth/callback (you will replace some_plugin_id with your plugin ID later)

Take note of the Client ID and Client Secret generated for you.

Next, to install the required packages for this plugin, run the following command:

pip install -r requirements.txt

A domain name is needed in order to use OAuth with this plugin. See OpenAI docs on using plugins with OAuth.

To get a domain for your local app, you can run this app on a service like replit that provides a domain for you. Turns out that Genius blocks IPs from VPS providers like replit. Guess you have to self host this one! ¯\(ツ)/¯

Alternatively, sign up for ngrok and install:

brew install ngrok
ngrok config add-authtoken YOUR_AUTH_TOKEN
ngrok http 8000

Or, if you wanna get real fancy, buy your own domain and set up a reverse proxy on your network.

Once you have your domain, open .well-known/ai-plugin.json and replace any instances of https://chatgpt-genius-plugin.mydomain.com in the file with your domain.

To run the plugin, enter the following command:

uvicorn main:app --reload --host 0.0.0.0

Once the local server is running:

1. Navigate to https://chat.openai.com.
2. In the Model drop down, select "Plugins" (note, if you don't see it there, you don't have access yet).
3. Select "Plugin store"
4. Select "Develop your own plugin"
5. Enter in chatgpt-genius-plugin.mydomain.com or whatever your domain is, then select "Find manifest file".
6. It will ask for your Client ID and Client Secret. Enter the values from you Genius API Client.
7. OpenAI will give you a verification token. Enter this in .well-known/ai-plugin.json in the verification_tokens object. Restart your server and then continue in ChatGPT.
8. After installing the plugin, it will ask you to login with Genius. Click the button, and you'll see "Invalid authorization". Look in the URL to get your plugin ID from the redirect URI query param (it should be in the oauth request). Go back to your Genius API Client and edit. Update the redirect URI to https://chat.openai.com/aip/plugin-your_plugin_id/oauth/callback, where your_plugin_id should be some unique UUID. Now save your Genius API client with the corrected Redirect URI.
9. Refresh the tab with "Invalid authorization" - it should go through now!

The plugin should now be installed and enabled! You can try out a number of different questions:

• What are the full lyrics of the song with the lyrics "I threw a wish in the well don't ask me, I'll never tell"
• Tell me about the EP "Become" by Beach House.
• Can you show me the cover art for the album "Expert in a Dying Field" by The Beths?
• What is the meaning of the song "Kyoto" by Phoebe Bridgers?
• Get the lyrics for "Plimsoll Punks" by Alvvays and rewrite them as a song parody called "Feline Punks" about how cats can be real punks sometimes.

Development

This is mostly just a fastapi wrapper around the LyricsGenius python client for the Genius API. If you'd like to make any contributions, PRs are welcome! Here is the readthedocs page for LyricsGenius.

You may also find OpenAI's Developer community forum useful.