🌱🔮✨ Welcome to GPTarot ✨🔮🌱

Let a large language model read the cards for you.

GPTarot is a just-for-fun project getting ChatGPT to conduct three card tarot readings. All you need to do is choose your spread and tone, ask a question, and pick three cards (or let randomization do the thinking for you). I recommend drawing randomly from a real tarot deck if you have one onhand. GPTarot will do the rest.

Customizations:

• In addition to asking GPTarot your question with particular cards, you can select the type of tarot spread and theme for your reading.
• Spreads: Currently, GPTarot can do a Past, Present, Future or a Body, Mind, Spirit Tarot spread.
• Theme: Currently, GPTarot can conduct your reading along one of the following themes: mystical, witchy, taro root-themed, pun-oriented, 90s pop culture references, or surfer. Let me know if you have any requests for additional tones!

Experience GPTarot online:

• http://gptarot.aspencage.com:8501/
• Hosting: AWS EC2 instance and Route 53 domain.

Run GPTarot yourself:

• You can also run the code for GPTarot on your local machine!

• After meeting the installation requirements below, you can run GPTarot with a graphical user inferface by navigating to the repository and running streamlit run app.py on the command line.

  • By default, GPTarot launches with an authentication page. However, you can launch a version that does not require authentication with the command streamlit run app.py -- --noauth.
  • Or, if you prefer a simple command line presentation, you can simply run gptarot.py on the command line.

• Requirements:

  • 1. Have an OpenAI API account and set your machine's OPENAI_API_KEY environment variable.
  • 2. Install the requisite Python packages in the environment.yml file. The packages that are not part of a typical Python data stack are: langchain, streamlit, openai, tiktoken, and langchain-openai. I recommend simply creating a Conda environment from this file directly with mamba env create -f environment.yml.

Forthcoming features:

• Add Apache2 configuration with SSL.
• Reset option on reading page
• Options to download and share your reading
• DALL-E visualizations related to your reading
• Have a suggestion? Please share!