{"id":15908311,"url":"https://github.com/capjamesg/roboflow-tea-detector","last_synced_at":"2026-01-12T06:42:42.693Z","repository":{"id":98184777,"uuid":"561293255","full_name":"capjamesg/roboflow-tea-detector","owner":"capjamesg","description":"A detector to track my caffeine intake.","archived":false,"fork":false,"pushed_at":"2022-11-25T10:12:26.000Z","size":140,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-25T21:51:01.257Z","etag":null,"topics":["computer-vision","object-detection","roboflow"],"latest_commit_sha":null,"homepage":"https://blog.roboflow.com/caffeine-monitoring-computer-vision/","language":"HTML","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/capjamesg.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":"2022-11-03T11:35:10.000Z","updated_at":"2022-11-25T10:10:27.000Z","dependencies_parsed_at":"2023-06-29T18:01:09.176Z","dependency_job_id":null,"html_url":"https://github.com/capjamesg/roboflow-tea-detector","commit_stats":{"total_commits":7,"total_committers":2,"mean_commits":3.5,"dds":0.2857142857142857,"last_synced_commit":"6489f311a4e9d967c80ea26103620bd0635b2540"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/capjamesg%2Froboflow-tea-detector","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/capjamesg%2Froboflow-tea-detector/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/capjamesg%2Froboflow-tea-detector/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/capjamesg%2Froboflow-tea-detector/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/capjamesg","download_url":"https://codeload.github.com/capjamesg/roboflow-tea-detector/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246912451,"owners_count":20853861,"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":["computer-vision","object-detection","roboflow"],"created_at":"2024-10-06T14:20:42.421Z","updated_at":"2026-01-12T06:42:42.655Z","avatar_url":"https://github.com/capjamesg.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Roboflow Tea Intake Tracker\n\nA computer vision model deployed on a Luxonis OAK camera to monitor my tea intake.\n\nWhen a tea break starts or ends, your Slack status can optionally be updated to reflect that you are making a cup of tea.\n\nThis project and an accompanying tutorial are documented in the [Monitoring My Caffeine Intake with Computer Vision](https://blog.roboflow.com/caffeine-monitoring-computer-vision/) post on the Roboflow blog.\n\n## Screenshots\n\n![A photo of a mug, a box, and three bowls stacked, with a bounding box around and label above the mug](screenshots/mug.jpeg)\n\n![Active Slack status with the label \"making tea\"](screenshots/slack.jpeg)\n\n## What You'll Need\n\nTo run this project, you will need:\n\n1. [A free Roboflow account](https://app.roboflow.com).\n2. A Luxonis OAK camera (any model).\n\nTo use this model to update your Slack status, you will need access to a Slack workspace where you have admin access. This is optional.\n\n## Getting Started\n\nFirst, install the required dependencies for this project:\n\n```\ngit clone https://github.com/capjamesg/roboflow-tea-detector\ncd roboflow-tea-detector\npip3 install -r requirements.txt\n```\n\nNext, plug your OAK camera into your computer.\n\nGo to the [Roboflow Dashboard](https://app.roboflow.com) and follow our \"[Obtaining your API key](https://docs.roboflow.com/rest-api#obtaining-your-api-key)\" instructions to find out how to get your API key. Then, run the following command on your machine:\n\n```\n export ROBOFLOW_KEY \"YOUR_KEY_HERE\"\n```\n\nSubstitute `YOUR_KEY_HERE` with the key associated with your account. Make sure to add a space before `export` so the command is not saved in your shell history.\n\nRemember, this key is private. Don't publish the key anywhere.\n\nIf you want to send your tea break status to Slack, you will need to:\n\n1. [Create a Slack bot](https://api.slack.com)\n2. Click \"OAuth \u0026 Permissions\"\n3. Add the `users.profile:read` and `users.profile.write` scopes to the `User Token Scopes` section.\n4. Install the project to your workspace.\n5. Run ` export SLACK_KEY \"YOUR_SLACK_KEY\"` and replace `YOUR_SLACK_KEY` with the `User OAuth Token` returned by Slack.\n\nThis will let you send your status to Slack.\n\nNow we're ready to start using the model. To start using the model, run the `app.py` script:\n\n```\npython3 app.py\n```\n\nThis script will open up a window that shows the camera feed from your OAK camera.\n\n## Usage\n\n1. Place a mug in front of the camera and see if it is detected.\n2. If your mug is detected and you move it away for 4 seconds, a tea break will be recorded in the `tea_breaks.json` file. **This value should be changed in production by amending the `DELAY` value in `app.py`. 4 seconds is a good number for testing.**\n3. When you bring a mug back into view, the `tea_breaks.json` file will be updated to show the duration of your coffee break.\n\nIf your mug is not detected, try moving the mug to a different angle. *Note: this model was only trained on mugs with handles. This model has not been tested at detecting mugs without handles*.\n\n### Web chart\n\nThis script comes with a `template.py` file which plots your tea intake on a chart.\n\nYou can run this script using the following command:\n\n```\npython3 template.py\n```\n\nThis script will generate a file called `out.html` with a record of all of the tea you have consumed in the day.\n\n## License\n\nThe source code for this project is licensed under an [MIT license](LICENSE).\n\n## Contributors\n\n- capjamesg\n\n## Acknowledgments\n\nThis model was built using [Roboflow](https://roboflow.com).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcapjamesg%2Froboflow-tea-detector","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcapjamesg%2Froboflow-tea-detector","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcapjamesg%2Froboflow-tea-detector/lists"}