https://github.com/arfon/trash-ai
Web based trash image classification
Science Score: 10.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
○codemeta.json file
-
○.zenodo.json file
-
○DOI references
-
✓Academic publication links
Links to: joss.theoj.org -
○Academic email domains
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (13.2%) to scientific vocabulary
Repository
Web based trash image classification
Basic Info
- Host: GitHub
- Owner: arfon
- License: mit
- Default Branch: aws/trashai-staging
- Homepage: https://www.trashai.org
- Size: 71.3 MB
Statistics
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
- Releases: 0
Metadata Files
README.md
Trash AI: Web application for serverless image classification of trash
Project Information
- Sponsor: Win Cowger, Moore Institute for Plastic Pollution Research
- Meeting Times: Wednesdays at 6:30pm PT Weekly Brigade Meetings
- Publication Pending: paper.md
Project Summary
Trash AI is a web application where users can upload photos of litter, which will be labeled using computer vision to detect and categorize litter in the image by type. Early inspiration from WADE AI streamlined this development. Trash AI will enhance the abilities of researchers to quickly label trash in photos.
Demo
Deployment
You can simply go to www.trashai.org to start using the tool or deploy it yourself. Current self-deployment options are local deployment with docker to remote on Amazon Web Services (AWS).
Run Local Docker Instance
docker run -p 5150:5150 -it code4sac/trashai:latest
Navigate to http://localhost:5150
If you are attempting to run on an Apple Silicon device, you might get the following error:
docker: no matching manifest for linux/arm64/v8 in the manifest list entries.
This can be remedied by specifying the build platform.
docker run --platform linux/x86_64 -p 5150:5150 -it code4sac/trashai:latest
Deploy to Any Webserver
If you want to deploy this to a static web directory and serve it using
apache or nginx, you can do so with the following command using /var/www/html
as an example destination directory.
```
create container from latest public trash ai docker image
id=$(docker create code4sac/trashai:latest)
copy the static files
docker cp $id:/usr/share/nginx/html /var/www/html
remove created container
docker rm -v $id ```
Local Development
- Run the environment live with localstack and docker.
AWS Deployment
- Instructions on bringing up a new AWS deployment.
Continuous Integration and Continuous Delivery (CI/CD) - Github Actions
- Mostly CD at this point.
Github Actions AWS Deployment Role
- Runs the complex stuff so you don't have to.
Tests
Instructions for automated and manual tests here.
Functionality
Documentation on typical workflow and functionality of the tool can be found here
Contribute
We welcome contributions of all kinds.
To get started, look at the Start Here section of the project board
You can open an issue or pull request.
Here are some ideas on How to Contribute.
Please adhere to this project's Code of Conduct.
Owner
- Name: Arfon Smith
- Login: arfon
- Kind: user
- Location: Edinburgh
- Website: arfon.org
- Twitter: arfon
- Repositories: 86
- Profile: https://github.com/arfon
Schmidt Sciences. Previously product @github, data science @spacetelescope, @zooniverse co-founder. Editor-in-chief of the Journal of Open Source Software