Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/deven96/pneumoniapredictionapi

flask app wrapped around a keras pneumonia classifier
https://github.com/deven96/pneumoniapredictionapi

Last synced: 19 days ago
JSON representation

flask app wrapped around a keras pneumonia classifier

Awesome Lists containing this project

README

        

# Pnuemonia Prediction API

Flask API for binary classification of xray images for web application [PneuNet](https://github.com/deven96/PneuNet)

[![Build Status](https://travis-ci.org/deven96/PneumoniaPredictionAPI.svg?branch=master)](https://travis-ci.com/deven96/PneumoniaPredictionAPI)

![Docker Automated Build](https://img.shields.io/docker/automated/deven96/pneumonia-api.svg?style=flat)
![Docker Pulls](https://img.shields.io/docker/pulls/deven96/pneumonia-api.svg?style=flat)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

- [ImageQ API](#imageq-api)
- [Getting Started](#getting-started)
- [Installation](#installation)
- [Running Locally](#running-locally)
- [Deploy](#deploy)
- [Documentation](#documentation)
- [Todo](#todo)

## Getting Started

Clone the repo

```bash
# SSH
git clone [email protected]:deven96/PneumoniaPredictionAPI.git
# HTTPS
git clone https://github.com/deven96/PneumoniaPredictionAPI.git
```

Activate virtual environment. All project work should be done in virtualenvs and virtualenv names must be added to gitignore

### Installation

- Install the requirements

```bash
# install pipenv
sudo pip3 install pipenv

# install requirements
pipenv install
```

## Running Locally

- With flask dev server

```bash
python flask_api/run_keras_server.py
```
Configured to run on port 8008

- With Gunicorn (port 8008)

```bash
gunicorn -b :8008 flask_api:app
```

## Deploy

The `/predict` endpoint on `master` branch of the repo is linked to automatically deploy to be hosted on [Google Cloud](https://pneumonia-api.appspot.com/predict)

## Documentation

Documentation including example use are available on [hosted version](https://pneumonia-api.appspot.com)

## Todo

- Setup GCP serving pipeline for API
- Integrate weight updates from colaboratory