"The stars incline, but do not bind.
Thy future is etched upon the very rivers of thy palm."

Palmystic is a mystical fortune-telling platform that bridges ancient palmistry with cutting-edge artificial intelligence.
By leveraging the visual intelligence of Google Gemini (VLM) and the orchestration power of Spring AI, Palmystic analyzes the intricate lines of your palm to provide deep insights and a 1:1 consultation with the Archmage of the Eastern Heavens.

•	Backend Architect: [Eunse Jeong]
•	Frontend Sorcerers: [Tithi Paul]
•	Prompt Engineer : [Cathy Pahn]

We set out to explore the intersection of human curiosity and digital precision:

• Data-Driven Mysticism
  Transform subjective palm reading into structured, objective analysis using high-dimensional vision models.

• Hyper-Personalized Interaction
  Utilize Context Injection so the AI remembers your palm traits across the entire consultation.

• Actionable Wisdom
  Move beyond vague predictions by delivering daily Action Items that encourage positive lifestyle changes.

• React.js
  Responsive, dynamic user experience with a high-fidelity Antique UI
• WebCam API
  Seamless real-time palm capture directly in the browser

• Java 21
• Spring Boot 3.x
• Spring AI
  Structured prompt templates and clean orchestration with LLM/VLM models

• Google Gemini Flash Latest
  • VLM (Vision): Palm line feature extraction
  • LLM (Chat): Persona-driven consultation as the Archmage

• Google Gemini API — Vision-Language Model for palm image analysis and conversational AI
• Spring AI — Prompt orchestration and structured AI integration
• Web MediaDevices API — Browser-based camera access
• HTML5 Canvas API — Image capture and processing

The vision model detects and evaluates the four major palm lines:

• Life Line – Vitality and physical resilience
• Heart Line – Emotional intelligence and soul connections
• Head Line – Strategic thinking and mental clarity
• Fate Line – Professional destiny and social impact

Unlike generic chatbots, Palmystic delivers a true 1:1 consultation:

• Palm traits extracted by the VLM are injected as background context
• The Archmage cites concrete evidence during dialogue

  “I see the Strategic Mind trait in thy Head Line, suggesting a path toward leadership…”

Each user receives a personalized Destiny Profile, including:

• Lucky Context
  • Power Animal
  • Lucky Color
  • Divine Number
• Action Item
  A specific task for the day to align your Qi with the stars

Palmystic implements a RAG (Retrieval-Augmented Generation) Lite architecture:

1. Visual Extraction
   Palm images are converted into a structured JSON schema of mystical traits.

2. Contextual Memory
   The JSON is stored in session context and passed to the LLM at every chat turn.

3. Persona Consistency
   Strict system prompting ensures:

   • The Archmage stays in character
   • Interpretations remain grounded in extracted palm features

• Palm Image Validity
  Palm readings are highly sensitive to image orientation, framing, and clarity.
  Instead of relying on brittle heuristics, we enforced strict validation rules at the prompt level, instructing the Gemini VLM to reject invalid inputs and return structured error responses.

• Browser Image Transmission
  Camera-captured images initially failed to reach the backend correctly due to format mismatches.
  We resolved this by converting Canvas output into binary Blob objects and transmitting them via multipart form data, ensuring compatibility with Spring controllers.

• Persona Consistency
  Maintaining a mystical yet structured AI persona required careful prompt engineering.
  We solved this with strict system prompts and schema-based outputs to balance creativity with reliability.

# Set your Gemini API Key in application.yml
./gradlew bootRun

npm install
npm start

In the world of Palmystic, we are more than developers — we are digital alchemists. Our hope is to offer users a moment of reflection, a touch of wonder, and a clearer view of the path ahead.

“The universe is contained within the palm of thy hand.”