{"id":29196183,"url":"https://github.com/adamya-gupta/hastai-palmreader","last_synced_at":"2026-04-15T05:32:28.594Z","repository":{"id":298384429,"uuid":"997090022","full_name":"Adamya-Gupta/HastAI-PalmReader","owner":"Adamya-Gupta","description":"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.","archived":false,"fork":false,"pushed_at":"2025-06-10T20:28:55.000Z","size":1931,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-02T06:02:10.932Z","etag":null,"topics":["3d-hand","3d-models","gemini-api","git-lfs","nextjs","palm-reading","palmistry","reactjs","threejs"],"latest_commit_sha":null,"homepage":"https://hastai.onrender.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Adamya-Gupta.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-06T00:09:40.000Z","updated_at":"2025-06-10T20:28:58.000Z","dependencies_parsed_at":"2025-06-10T21:47:58.230Z","dependency_job_id":null,"html_url":"https://github.com/Adamya-Gupta/HastAI-PalmReader","commit_stats":null,"previous_names":["adamya-gupta/hastai-palmreader"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Adamya-Gupta/HastAI-PalmReader","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adamya-Gupta%2FHastAI-PalmReader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adamya-Gupta%2FHastAI-PalmReader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adamya-Gupta%2FHastAI-PalmReader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adamya-Gupta%2FHastAI-PalmReader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Adamya-Gupta","download_url":"https://codeload.github.com/Adamya-Gupta/HastAI-PalmReader/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adamya-Gupta%2FHastAI-PalmReader/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278486308,"owners_count":25994945,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-05T02:00:06.059Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d-hand","3d-models","gemini-api","git-lfs","nextjs","palm-reading","palmistry","reactjs","threejs"],"created_at":"2025-07-02T06:01:03.586Z","updated_at":"2025-10-05T17:13:06.896Z","avatar_url":"https://github.com/Adamya-Gupta.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HastAI - Palm Reader\n[![MIT License](https://img.shields.io/badge/License-MIT-blue.svg)](https://choosealicense.com/licenses/mit/)\n[![Git LFS](https://img.shields.io/badge/Git%20LFS-Enabled-orange?logo=git\u0026logoColor=white)](https://git-lfs.com/)\n\n## 🔍 Overview:\nHastAI provides free palm reading to users who want to quickly check what their palm reveals, without the need to visit a professional palm reader.\n\n\u003cdiv align=\"center\"\u003e\n\u003ctable \u003e\n\u003ctr\u003e\n\u003ctd align=\"center\"\u003e\nDark Mode\n\u003cimg src='./assets/frontdark.png'\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\nLight Mode\n\u003cimg src='./assets/frontlight.png'\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\u003c/div\u003e\n\n## 📌 Features\n- **Always Free to Use** - No hidden costs, no subscriptions, unlimited palm readings for everyone to enjoy\n- **Data Safety** - Your palm images are never stored, processed securely and deleted immediately after reading\n- **Fast Results** - Get your personalized palm reading in seconds with our optimized AI processing\n- **Simple Upload Process** - Just take a photo of your palm and upload, no complicated steps or technical knowledge required.\n\n## 🛠️ Technologies Used\n- Framework - [Next.js](https://nextjs.org)\n- 3d Model Rendering - [Threejs](https://threejs.org)\n- Model Storing - [Git-LFS](https://git-lfs.com/)\n\n\n### Git Large File Storage(LFS) \n\nGit 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.\n\nThe 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.\n\n\u003e[!IMPORTANT]\n\u003eWhile pushing the model to Git LFS, you might encounter some issues. If you face similar problems, you can solve them using the following solutions:\n\u003e\n\u003e### Issue 1: Remote \"origin\" does not support the LFS locking API.\n\u003e**Solution:** \n\u003eFirst, type this command in terminal, then push your code again.\n\u003e```bash\n\u003e git config lfs.locksverify false\n\u003e ```\n\u003e\n\u003eREFERENCE - [#2812](https://github.com/desktop/desktop/issues/2812#issuecomment-332239726)\n\u003e\n\u003e### Issue 2: batch request: git@github.com: Permission denied (publickey).: exit status 255\n\u003e**Solution:**\n\u003eIf you are using Windows, this is a bug in Git for Windows ([#1613](https://github.com/git-for-windows/git/issues/1613)).\u003cbr\u003e\n\u003ePush the code using Git Bash, and your issue will be resolved.\n\u003e\n\u003eREFERENCE - [#4848](https://github.com/git-lfs/git-lfs/discussions/4848)\n\n\u003e[!CAUTION]\n\u003eWhile 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.\n\n\u003cdiv align=\"center\"\u003e\n\u003ctable \u003e\n\u003ctr\u003e\n\u003ctd align=\"center\"\u003e\n\u003cimg src='./assets/git-lfs.png' width=\"1000\"\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\n\u003cimg src='./assets/plan.png' width=\"1000\"\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\u003c/div\u003e\n\n## ⚙️Installation \u0026 Setup\n\n### Step 1: Clone the Repository\n\n```bash\n  # Clone the repository\n  git clone https://github.com/Adamya-Gupta/HastAI-PalmReader.git\n  \n```\n\n### Step 2: Install Required Dependencies\n\n```bash\n# Install dependencies\nnpm install\n```\n\n### Step 3: Environment Variables\nTo run this project, you will need to add the following environment variables to your .env file\n\n```\nGEMINI_API_KEY = your_api_key\n```\n### Step 4: Run the development server:\n\n```bash\nnpm run dev\n# or\nyarn dev\n# or\npnpm dev\n# or\nbun dev\n```\n\nOpen [http://localhost:3000](http://localhost:3000) with your browser to see the result.\n\nYou can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.\n\n## 📁 Project Structure\n\n```bash\nhastai/\n├── public/              # Static assets\n│   └── models/\n│       └── hand.obj     # 3D hand model (Git LFS)\n├── src/\n│   ├── app/             # API routes, pages, and custom components\n│   ├── components/      # Library components (MagicUI, ShadCN, etc.)\n│   ├── configs/\n│   │   └── AiModel.tsx  # AI prompt configuration\n│   └── lib/             \n├── .gitignore           # Includes .env\n├── .gitattributes       # Git LFS tracking (*.obj)\n└── .env                 # API keys\n```\n\n## 🎨 Color Palette\n\n| Name         | Hex Code     | Preview |\n|--------------|--------------|---------|\n| Light Teal   | #88BDBC    | ![#88BDBC](https://placehold.co/50x20/88BDBC/88BDBC.png) |\n| Medium Teal  | #254E58    | ![#254E58](https://placehold.co/50x20/254E58/254E58.png) |\n| Dark Teal    | #112D32    | ![#112D32](https://placehold.co/50x20/112D32/112D32.png) |\n| Warm Brown   | #4F4A41    | ![#4F4A41](https://placehold.co/50x20/4F4A41/4F4A41.png) |\n| Light Brown  | #6E6658    | ![#6E6658](https://placehold.co/50x20/6E6658/6E6658.png) |\n\n\n## 🎯 Purpose of Creating This Project\n\nHastAI 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.\n\n## 🚀 Future Improvements\n\nSome improvements I would like to implement in the future:\n- **Live User Counter** - Display real-time visitor count on the website\n- **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\n- **Enhanced UI/UX** - Improve the overall user interface and experience\n- **Optimized 3D Model Loading** - The 3D model currently takes considerable time when deployed; implement faster rendering methods\n\n\n## 🌐 Deployment\n\nInitially, I attempted to deploy on the [Vercel](https://vercel.com/new?utm_medium=default-template\u0026filter=next.js\u0026utm_source=create-next-app\u0026utm_campaign=create-next-app-readme), but for some reason, it was blocking the Gemini API responses from the client side. Instead, I successfully deployed this project on [Render](https://render.com/).\n\n## 📚 References\n- **3d Hand Model** - [TurboSquid/nadevaynoski](https://www.turbosquid.com/3d-models/realistic-human-hand-1877742)\n- **Palm Reading basics** - [wikihow.com/Read-Palms](https://www.wikihow.com/Read-Palms)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadamya-gupta%2Fhastai-palmreader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadamya-gupta%2Fhastai-palmreader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadamya-gupta%2Fhastai-palmreader/lists"}