TensorBird/README.md

62 lines
1.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# TensorBird
A project aiming to perform auto identification of bird species from pictures taken by [PiCameraTrap](https://forge.ortion.xyz/UncleSamulus/PiCameraTrap)
using machine learning.
## Inspiration
I have been inprired by following ressource :
* [darenjhsu birdid repository](https://github.com/darrenjhsu/birdid)
* [This A.I. Birdwatcher Lets You See Through the Eyes of a Machine](https://today.duke.edu/2019/10/ai-birdwatcher-lets-you-see-through-eyes-machine)
* [Is Machine Learning for the Birds?](https://www.openhealthnews.com/story/2019-01-24/machine-learning-birds)
* [Image Classification of bird species using deep learning with PyTorch, Captum and ONNX](https://towardsdatascience.com/adventures-in-pytorch-image-classification-with-caltech-birds-200-part-1-the-dataset-6e5433e9897c)
* [Github Repository of previous article](https://github.com/ecm200/caltech_birds)
## Environmnent Set Up
### Create and Activate virtual env
```bash
python -m venv tb-venv
source tb-venv/bin/activate
```
### Install Tensorflow in container
```bash
docker pull tensorflow/tensorflow:latest # Download latest stable image
docker run -it -p 8888:8888 tensorflow/tensorflow:latest-jupyter # Start Jupyter server
```
### Install Tensorflow using pip
```bash
python -m pip install tensorflow
```
### Launch Jupyter Notebook
#### Make the virtual env accessible from Jupyter Notebook
```bash
pip install ipykernel
python -m ipykernel install --user --name=tb-venv
```
#### Launch Jupyter
```bash
jupyter notebook
```
## Run TF Lite
### Trouble shooting
For tensorflow Lite to work on virtual env, we have to install the following package.
```bash
sudo apt install libatlas-base-dev
```