├── images ├── .gitkeep └── purple_dog.jpg ├── .gitattributes ├── .gitignore ├── requirements.txt ├── export.pkl ├── LICENSE └── README.md /images/.gitkeep: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.gitattributes: -------------------------------------------------------------------------------- 1 | *.pkl filter=lfs diff=lfs merge=lfs -text 2 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | .DS_Store 2 | .ipynb_checkpoints/* 3 | __pycache__/* 4 | 5 | -------------------------------------------------------------------------------- /images/purple_dog.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/butchland/cuddly-guide/master/images/purple_dog.jpg -------------------------------------------------------------------------------- /requirements.txt: -------------------------------------------------------------------------------- 1 | fastcore 2 | fastai 3 | voila 4 | pillow>=7.1.0 5 | packaging 6 | ipywidgets==7.5.1 7 | -------------------------------------------------------------------------------- /export.pkl: -------------------------------------------------------------------------------- 1 | version https://git-lfs.github.com/spec/v1 2 | oid sha256:073cbe57382576d8348521959c458e861542901eaef75c47034fb78430d0aaf1 3 | size 87906116 4 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2020 Butch Landingin 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # build-your-own-image-classifier-binder-app-template 2 | This is a template github project for building your binder app based on the article [Build (and Run!) Your Image Classifier using Colab, Binder, Github and Google Drive](https://butchland.github.io/butchland-machine-learning-notes/machine%20learning/2020/10/05/byoic-on-colab-part2.html). This template is based on the [instructions posted on the fastai forums here](https://forums.fast.ai/t/deploying-your-notebook-as-an-app-under-10-minutes/70621?u=butchland). 3 | 4 | ## Instructions for Deploying to Binder 5 | 6 | _Do the next steps only after making sure you already created and exported the learner (`export.pkl`) and your stripped down voila app notebook is ready (preferably tested in a jupyter notebook environment with voila)._ 7 | 8 | 1. Create a [github account](https://github.com/join?source=header-home) if you don't have one yet. 9 | 1. Fork [this repo](https://github.com/butchland/build-your-own-image-classifier-template) as a template for your own binder app repository. You can [click on this link to generate your own copy.](https://github.com/butchland/build-your-own-image-classifier-template/generate) 10 | * Make sure to rename your repo to something other than `build-your-own-image-classifier-template`. Due to a github policy, `git-lfs` does not support uploads to public forks, which is what your repo will be if you name it the same as what you are copying from. For more info, please see [this issue](https://github.com/git-lfs/git-lfs/issues/1906). 11 | 12 | 1. Continue with the steps discussed in the article. 13 | --------------------------------------------------------------------------------