HastAI provides free palm reading to users who want to quickly check what their palm reveals, without the need to visit a professional palm reader.
- Always Free to Use - No hidden costs, no subscriptions, unlimited palm readings for everyone to enjoy
- Data Safety - Your palm images are never stored, processed securely and deleted immediately after reading
- Fast Results - Get your personalized palm reading in seconds with our optimized AI processing
- Simple Upload Process - Just take a photo of your palm and upload, no complicated steps or technical knowledge required.
Git Large File Storage (LFS) replaces large files such as audio samples, videos, datasets, and graphics with text pointers inside Git, while storing the file contents on a remote server like GitHub.com or GitHub Enterprise.
The 3D model used in this project is approximately 105 MB in size and is a .obj
file. Since GitHub only allows storing files up to 100 MB, we had to use Git LFS.
Important
While pushing the model to Git LFS, you might encounter some issues. If you face similar problems, you can solve them using the following solutions:
Solution: First, type this command in terminal, then push your code again.
git config lfs.locksverify false
REFERENCE - #2812
Issue 2: batch request: git@github.com: Permission denied (publickey).: exit status 255
Solution:
If you are using Windows, this is a bug in Git for Windows (#1613).
Push the code using Git Bash, and your issue will be resolved.
REFERENCE - #4848
Caution
While Git LFS appears to be an attractive solution for managing large files, it comes with a catch. What starts as a free service often leads to unexpected billing notifications when you exceed the generous-looking but limited free tier.
# Clone the repository
git clone https://github.com/Adamya-Gupta/HastAI-PalmReader.git
# Install dependencies
npm install
To run this project, you will need to add the following environment variables to your .env file
GEMINI_API_KEY = your_api_key
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev
Open http://localhost:3000 with your browser to see the result.
You can start editing the page by modifying app/page.tsx
. The page auto-updates as you edit the file.
hastai/
├── public/ # Static assets
│ └── models/
│ └── hand.obj # 3D hand model (Git LFS)
├── src/
│ ├── app/ # API routes, pages, and custom components
│ ├── components/ # Library components (MagicUI, ShadCN, etc.)
│ ├── configs/
│ │ └── AiModel.tsx # AI prompt configuration
│ └── lib/
├── .gitignore # Includes .env
├── .gitattributes # Git LFS tracking (*.obj)
└── .env # API keys
Name | Hex Code | Preview |
---|---|---|
Light Teal | #88BDBC | |
Medium Teal | #254E58 | |
Dark Teal | #112D32 | |
Warm Brown | #4F4A41 | |
Light Brown | #6E6658 |
HastAI was created as a fun project to explore the fascinating world of palmistry using modern AI technology. We wanted to build something entertaining that combines ancient traditions with cutting-edge machine learning.
Some improvements I would like to implement in the future:
- Live User Counter - Display real-time visitor count on the website
- Real-time Camera Integration - Instead of uploading photos from storage, users can directly face their palm in front of the camera for automatic recognition and capture
- Enhanced UI/UX - Improve the overall user interface and experience
- Optimized 3D Model Loading - The 3D model currently takes considerable time when deployed; implement faster rendering methods
Initially, I attempted to deploy on the Vercel, but for some reason, it was blocking the Gemini API responses from the client side. Instead, I successfully deployed this project on Render.
- 3d Hand Model - TurboSquid/nadevaynoski
- Palm Reading basics - wikihow.com/Read-Palms