Skip to content

spiderpilo/fateDeck

Repository files navigation

FateDeck

An AI-powered tarot reading experience built for a hackathon under a deep-sea theme.

FateDeck allows users to ask a question, draw a three-card tarot spread from a custom ocean-inspired deck, and receive AI-generated interpretations based on the cards drawn and the user's prompt.

Features

  • Custom deep-sea tarot deck (25 original cards)
  • Random 3-card spread generation
  • AI-powered tarot interpretations using OpenAI
  • Animated card dealing interaction
  • Cinematic video landing page
  • Multi-card reading flow with next/previous navigation
  • Full-stack React + Express application

Demo Flow

  1. Ask a question
  2. Draw three cards
  3. Reveal your spread
  4. Receive AI interpretations for each card
  5. Flip through the reading card by card

Tech Stack

Frontend: React, Vite, JavaScript Backend: Node.js, Express, OpenAI API

Run Locally

npm install npm run dev npm run server

Environment Variables

OPENAI_API_KEY=your_api_key

Authors

Piolo Patag Phuc Hoang Richard Kawamura

About

Interactive AI tarot experience that turns user questions into personalized 3-card readings.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors