Skip to content

calvinlee326/palm-reading-app

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

19 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

โœ‹ Palm Analysis App ๐ŸŒŸ

Palm Analysis App is an AI-powered palm reading web application that provides entertaining and insightful personality, love, and fortune analysis by interpreting palm lines. Built with FastAPI + Next.js, and powered by OpenAI's gpt-4.1 multimodal model, this app is mobile-first and easy to deploy.

๐ŸŒ Live Demo: palm-reading-app-iota.vercel.app


๐Ÿง  Features

โœ… Core Functionality (MVP v1)

  1. ๐Ÿ“ธ Palm Image Upload & Analysis

    • Upload or take a photo of your palm using your phone
    • Detect the three major palm lines: life line, head line, and heart line
    • Send image to OpenAI GPT-4o model for analysis (in development)
  2. โœ๏ธ Fun Palm Reading Report (Text-Based)

    • Input descriptions of palm lines manually
    • AI generates a personalized report including:
      • ๐Ÿ’ก Personality
      • ๐Ÿ’ฐ Fortune
      • โค๏ธ Love life
      • ๐Ÿ’ผ Career
      • ๐Ÿ’ช Health
    • Supports Traditional Chinese / Simplified Chinese / English
    • Emojis and a playful astrology-style tone included
  3. ๐Ÿ”ฎ Daily Horoscope Generator(Building...)

    • Input your birthdate to receive a fun, humorous daily message
    • Built for casual, friendly vibes

๐Ÿ”ง Tech Stack

Area Technology
Frontend Next.js 15 (App Router), Tailwind CSS
Backend FastAPI + Python 3.12
AI API OpenAI GPT-4.1
Env/Secrets dotenv (.env)
Hosting Local (dev), Vercel/Render (optional)
Auth (planned) Google OAuth (TBD)

๐Ÿ—๏ธ System Architecture

[ User Phone/PC ]
       โ†“
   vercel.app    โ† Frontend (Next.js)
       โ†“ API Request
    fly.io       โ† Backend (FastAPI)
       โ†“
  GPT-4o API    โ† OpenAI Vision API

The system follows a modern cloud-native architecture:

  • Frontend is hosted on Vercel for optimal global performance
  • Backend runs on fly.io for reliable API processing
  • Seamless integration with OpenAI's GPT-4o Vision API
  • Mobile-first responsive design for both phone and PC users

About

AI-powered palm reading app with a Next.js frontend and FastAPI backend

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors