SeerGPT uses RAG with Reasoning models to generate fun, accurate Tarot
Readings!

<./SeerGPT.png>

Features:
• 🃏 11 unique spreads for different types of questions!
• ✨ Supports OpenRouter, OpenAI and Anthropic API endpoints!
• 🪄 Has a gorgeous UI, made with flet


1 Installation
══════════════

1.1 From `pip'
──────────────

  Simply run
  ┌────
  │ pip install SeerGPT
  └────


1.2 From source
───────────────

  You can use `pip' to install an editable version of the code.
  ┌────
  │ pip install -e .
  └────


2 Usage
═══════

  Upon running the program for the first time, you will be prompted to
  enter details for your LLM provider.  Once you fill in these details,
  you can enter your query, and the program will handle the rest!


3 Issues
════════

  Please open an issue on the [Github page].


[Github page] <https://github.com/matchcase/SeerGPT>


4 Acknowledgements
══════════════════

  The cards have been taken from CC0 scans of the [Rider-Waite Tarot
  deck] uploaded by luciellaes on their [itch.io page].


[Rider-Waite Tarot deck]
<https://en.wikipedia.org/wiki/Rider%E2%80%93Waite_Tarot>

[itch.io page]
<https://luciellaes.itch.io/rider-waite-smith-tarot-cards-cc0>


5 License
═════════

  This program is licensed under the GNU General Public License v3, ©
  Sarthak Shah 2025.
