{"id":15159379,"url":"https://github.com/jvillemare/youdee-finder","last_synced_at":"2026-01-20T04:32:24.049Z","repository":{"id":106284514,"uuid":"253546989","full_name":"jvillemare/youdee-finder","owner":"jvillemare","description":"Finding the UofD Mascot YoUDee using a TensorFlow ML model.","archived":false,"fork":false,"pushed_at":"2020-04-09T02:36:47.000Z","size":3954,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-13T18:50:48.959Z","etag":null,"topics":["python","tensorflow","tensorflow-models"],"latest_commit_sha":null,"homepage":"https://villemarette.me/youdee-finder/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jvillemare.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2020-04-06T15:58:27.000Z","updated_at":"2020-04-09T02:36:49.000Z","dependencies_parsed_at":"2024-04-21T04:46:40.737Z","dependency_job_id":null,"html_url":"https://github.com/jvillemare/youdee-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/jvillemare%2Fyoudee-finder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jvillemare%2Fyoudee-finder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jvillemare%2Fyoudee-finder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jvillemare%2Fyoudee-finder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jvillemare","download_url":"https://codeload.github.com/jvillemare/youdee-finder/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247687663,"owners_count":20979514,"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":["python","tensorflow","tensorflow-models"],"created_at":"2024-09-26T21:20:26.970Z","updated_at":"2026-01-20T04:32:24.044Z","avatar_url":"https://github.com/jvillemare.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# YoUDee Finder\n\nLocating the University of Delaware mascot, [YoUDee](https://en.wikipedia.org/wiki/YoUDee), is a matter of grave importance.\n\n![YoUDee laying on Raymond Field](https://upload.wikimedia.org/wikipedia/commons/thumb/3/3c/YoUDee_Laying_Down.jpg/308px-YoUDee_Laying_Down.jpg)\n\nBird watching allows us to gain insights into the ecological health of our surroundings. The Delaware Blue Hen is a rare species only found at the University of Delaware.\n\nTo aid Delawarean ornithologists, this Machine Learning (ML) model was developed.\n\n[You can also test out the model with your webcam using this webpage here.](https://villemarette.me/youdee-finder/)\n\n## Statistics\n\nThe ML model was trained using:\n - `1,165` samples of YoUDee images.\n - `2,470` samples of neutral, non YoUDee images.\n  \t- Neutral samples include other mascots, images of places where YoUDee would be but isn't (football, basketball games), and fursuiters (for their similarity to costumed mascots.)\n - `4.37 gigabytes` of image data.\n - `632` of the samples were scrapped from YoUDee and other mascot Instagram accounts using [rarcega's scripts](https://github.com/rarcega/instagram-scraper).\n\nSome examples of the samples can be [seen here](samples.md). The full sample data set cannot be provided here due to privacy and copyright concerns.\n\n## Installation\n\nEnsure you are running at least Python 3.7 by typing:\n\n```\npython --version\n```\n\nClone this GitHub repo:\n\n```\ngit clone https://github.com/jvillemare/youdee-finder.git\n```\n\nInstall the requirements:\n\n`pip install requirements.txt` or `python -m pip install requirements.txt`\n\n\n## Usage\n\n[Besides using the script locally, you can also use the web-based model here.](https://villemarette.me/youdee-finder/)\n\nBelow are the few basic command line flags you can set for this script.\n\n#### Find in a single image\n```\npython find_youdee.py --image=IMG_0001.jpg\n```\n\n#### Find in a single video\n```\npython find_youdee.py --video=IMG_0001.mov\n```\n\n#### Find in a directory\n```\npython find_youdee.py --dir=pictures/\n```\n\nNon-recursively searches a directory for all supported image and video files, then processes and makes all the predictions for them.\n\n#### Write output to a CSV\n```\npython find_youdee.py --dir=pictures/ --output=predictions.csv\n```\n\nWorks for both single images and videos, or a full directory.\n\nCSV is in the format of:\n - `type`: `image` or `video`.\n - `filename`: Filename of image/video.\n - `frame_count`: Number of frames in file (images always have `1`).\n - `youdee_result`: Confidence that YoUDee is in image as a decimal percent (i.e. `0.50` = 50%).\n - `neutral_result`: Confidence that YoUDee is not in an image as a decimal percent.\n - `has_youdee`: `True` or `False` boolean, whether or not the confidence of YoUDee was high enough to be significant.\n\n## Other Notes\n\nFor videos, YoUDee could be in part of a video, but not other parts. Since we're concerned with finding any instance of YoUDee, if the confidence of YoUDee being in a video is high enough for a consecutive number of frames, then YoUDee is considered to be in that video.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjvillemare%2Fyoudee-finder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjvillemare%2Fyoudee-finder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjvillemare%2Fyoudee-finder/lists"}