A sophisticated palm reading application that uses AI (OpenAI Vision) to analyze palm images and provide detailed readings based on traditional palmistry methods.
- Take photos of your palm using the device camera
- Choose images from your gallery
- AI-powered palm analysis (OpenAI Vision)
- Detailed readings including:
- Hand Analysis
- Major Lines
- Life Path
- Personality Traits
- Future Insights
- Share your reading with others
- HomeScreen: Welcome and instructions, start your reading.
- CameraScreen: Take a palm photo or pick from gallery, tips for best results, and hand flip option.
- ResultScreen: View your detailed palm reading, share results, and get another reading.
-
Clone the repository:
git clone https://github.com/RuneweaverStudios/ai-palm-reader.git cd ai-palm-reader/palm-reader -
Install dependencies:
npm install
-
Set your OpenAI API Key:
- Add your OpenAI API key to the Expo config.
- Open
app.jsonand add the following under theexpo.extrasection:"extra": { "OPENAI_API_KEY": "your_openai_api_key_here" }
- Alternatively, you can use environment variables with Expo's secrets management.
-
Start the development server:
npm start
or
expo start
- Open the app in Expo Go (scan the QR code) or run on an emulator/simulator.
- Tap Start Reading.
- Take a clear photo of your palm or choose an existing image.
- Wait for the AI to analyze your palm.
- View your detailed palm reading.
- Share your results or get another reading.
- Node.js 14 or later
- Expo CLI (
npm install -g expo-cli) - iOS 13+ or Android 5+
- OpenAI API key with GPT-4 Vision access
- The app uses OpenAI Vision (GPT-4) to analyze palm images.
- Only one hand is needed for an accurate reading (dominant hand recommended).
- The AI will automatically determine which hand is best for analysis.
- Readings are based on traditional palmistry methods.
- Your API key is required for the AI analysis to work.
MIT