{"id":17063697,"url":"https://github.com/atapas/princess-finder","last_synced_at":"2025-04-12T18:23:27.012Z","repository":{"id":54889361,"uuid":"324160072","full_name":"atapas/princess-finder","owner":"atapas","description":"The `princess-finder` is a fun app to use a bit of machine learning in the browser. This app was built as part of the Hashnode's #christmashackathon.","archived":false,"fork":false,"pushed_at":"2022-07-28T03:16:29.000Z","size":4671,"stargazers_count":36,"open_issues_count":0,"forks_count":14,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-26T12:46:19.908Z","etag":null,"topics":["machine-learning","ml5js","react","teachable-machine"],"latest_commit_sha":null,"homepage":"https://tapasadhikary.com","language":"JavaScript","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/atapas.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":["atapas"]}},"created_at":"2020-12-24T13:16:37.000Z","updated_at":"2024-04-08T18:54:13.000Z","dependencies_parsed_at":"2022-08-14T05:50:39.381Z","dependency_job_id":null,"html_url":"https://github.com/atapas/princess-finder","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atapas%2Fprincess-finder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atapas%2Fprincess-finder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atapas%2Fprincess-finder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atapas%2Fprincess-finder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/atapas","download_url":"https://codeload.github.com/atapas/princess-finder/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248610873,"owners_count":21133008,"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","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":["machine-learning","ml5js","react","teachable-machine"],"created_at":"2024-10-14T10:52:46.726Z","updated_at":"2025-04-12T18:23:26.970Z","avatar_url":"https://github.com/atapas.png","language":"JavaScript","funding_links":["https://github.com/sponsors/atapas"],"categories":[],"sub_categories":[],"readme":"# Princess Finder\n\n[![License - MIT](https://img.shields.io/badge/License-MIT-blue)](#license)\n\n\u003c!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section --\u003e\n[![All Contributors](https://img.shields.io/badge/all_contributors-2-orange.svg?style=flat-square)](#contributors-)\n\u003c!-- ALL-CONTRIBUTORS-BADGE:END --\u003e\n\nI've borrowed all the Disney Princess dolls from my daughter to build a Machine Learning model such that, an application can recognize them with confidence using a webcam. I have given it a name too. The app is called, `Princess Finder`. \n\n## Technologies Used\n\nThe `Princess Finder` app is built using,\n- [The Teachable Machine](https://teachablemachine.withgoogle.com/): How about an easy and fast way to create machine learning `models` that you can directly use in your app or site? The Teachable Machine allows you to `train` a computer with images, sounds, and poses. We have created a model using the Disney princess so that, we can perform an `Image Classification` by using it in our app.\n- [ml5.js](https://learn.ml5js.org/#/): It is machine learning for the web using your web browser. It uses the web browser's built-in graphics processing unit (GPU) to perform fast calculations. We can use the API like, `imageClassifier(model)`, `classify`, etc. to perform the image classification.\n- [React](https://reactjs.org/docs/getting-started.html): It is a JavaScript library for building user interfaces. We can use `ml5.js` in a React application just by installing and importing the dependency.\n\nHere is a snap from the app shows, it is 93% confident that the princess is Jasmine. It also marks it with a golden ring.\n\n\u003e ![jasmine.png](https://cdn.hashnode.com/res/hashnode/image/upload/v1609042885907/BlS6bjt4g.png)\n\nWhereas, there is no way I look like a Disney Princess(not even a doll). Hence my own image has been classified correctly saying, `No Dolls`.\n\n\u003e ![no_dolls.png](https://cdn.hashnode.com/res/hashnode/image/upload/v1609043109997/kMZcy7EGe.png)\n\n## Want to Motivate?\n\nThanks for your time to reading this. Feel free to clone/fork/improve. Who doesn't want motivations? Give the project a star(⭐) if you liked the work.\n\n## Many Thanks to all the `Stargazers` who has supported this project with stars(⭐)\n\n[![Thanks to all stargazers](https://git-lister.onrender.com/api/stars/atapas/princess-finder?limit=15)](https://github.com/atapas/princess-finder/stargazers)\n\n## Demo\n\nYou can find a [Live Demo from here](http://princess-finder.netlify.app/)\n\nBuild Status: [![Netlify Status](https://api.netlify.com/api/v1/badges/a78bf701-a71f-4d07-a7ef-3f3ba21aefbb/deploy-status)](https://app.netlify.com/sites/princess-finder/deploys)\n\n# How to Run this Project Locally?\nThis project was bootstrapped with [Create React App](https://github.com/facebook/create-react-app).\n\nIn the project directory, you can run:\n\n```shell\n# Or npm install\n\nyarn install\n```\nThen,\n\n```shell\n# Or npm run start\n\nyarn start\n```\n\nThis will run the app in the development mode.\\\nOpen [http://localhost:3000](http://localhost:3000) to view it in the browser.\n\nThe page will reload if you make edits. You will also see any lint errors in the console.\n\n\n## Contributors ✨\n\nThanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --\u003e\n\u003c!-- prettier-ignore-start --\u003e\n\u003c!-- markdownlint-disable --\u003e\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://MichaelCurrin.github.io\"\u003e\u003cimg src=\"https://avatars0.githubusercontent.com/u/18750745?v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eMichael Currin\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/atapas/princess-finder/issues?q=author%3AMichaelCurrin\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://tapasadhikary.com\"\u003e\u003cimg src=\"https://avatars1.githubusercontent.com/u/3633137?v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eTapas Adhikary\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/atapas/princess-finder/commits?author=atapas\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003c!-- markdownlint-restore --\u003e\n\u003c!-- prettier-ignore-end --\u003e\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:END --\u003e\n\nThis project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!\n\n## License\n\nReleased under [MIT](/LICENSE) by [@atapas](https://github.com/atapas).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatapas%2Fprincess-finder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fatapas%2Fprincess-finder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatapas%2Fprincess-finder/lists"}