AI-powered personal tarot reading app that uses cards as a mirror for reflection, not prediction
Challenge: Many people seek clarity on personal decisions, relationships, and life transitions but lack a private, non-judgmental space to explore their thoughts. Traditional tarot apps deliver generic card definitions disconnected from the user's actual situation.
Solution: Tarot Guru is a personal AI tarot reading app that runs locally on your computer. You describe your real situation, and the app draws cards and generates a narrative reading that speaks directly to your specific question — not a generic card definition. It uses Claude Opus AI to interpret each card in the context of what you actually asked.
Single Card: One card, one focused message — quick check-in or daily energy.
Three-Card (Past/Present/Future): Most versatile spread for everyday questions.
Celtic Cross (10 cards): Full coverage for complex life decisions.
The Guru reads your question and recommends the most appropriate spread type and explains why. You can accept the recommendation or override with your preferred spread — you're always in control.
After the reading, a chat box lets you ask about specific cards, probe deeper into any theme, or ask for practical next steps. The Guru maintains full session context throughout the conversation.
Every completed reading is automatically saved as a timestamped JSON file on your computer. Includes your question, the cards drawn (upright/reversed), the full reading text, and your chat history.
Tarot Guru runs as a lightweight Node.js + Express server on your local machine. The card deck and spread logic are handled entirely in JavaScript. The only external call is to the Claude Opus API, which receives your question and the drawn card names to generate the narrative reading. All session data is stored as JSON files on your device — nothing is persisted remotely.