ML-APIs 0.0.3
A package for google ML_APIs.

[![PyPI Version](https://img.shields.io/pypi/v/ML_APIs.svg)](https://pypi.org/project/ML_APIs)
[![Coverage Status](https://coveralls.io/repos/github/santhoshse7en/ML_APIs/badge.svg?branch=master)](https://coveralls.io/github/santhoshse7en/ML_APIs?branch=master)
[![License](https://img.shields.io/pypi/l/ML_APIs.svg )](https://choosealicense.com/licenses/gpl-3.0/#)
[![Documentation Status](https://readthedocs.org/projects/pip/badge/?version=latest&style=flat)](https://santhoshse7en.github.io/ML_APIs/doc)

### ML_APIs
ML_APIs enables developers to understand the content of an image by encapsulating powerful machine learning models in an easy to use. It quickly classifies images into thousands of categories (e.g., “sailboat”, “lion”, “Eiffel Tower”), detects individual objects and faces within images, and finds and reads printed words contained within images. You can build metadata on your image catalog, moderate offensive content, or enable new marketing scenarios through image sentiment analysis. Analyze images uploaded in the request or integrate with your image storage on Google Cloud Storage.

| Source          | Link                                            |
| :---            |    :----:                                       |
| PyPI            | [https://pypi.org/project/ML_APIs/](https://pypi.org/project/ML_APIs/)                 |
| Repository      | [https://santhoshse7en.github.io/ML_APIs](https://santhoshse7en.github.io/ML_APIs)                |
| Documentation   | [https://santhoshse7en.github.io/ML_APIs/doc](https://santhoshse7en.github.io/ML_APIs/doc)      |


### Quick Start
**In order to use this library, you first need to go through the following steps:**

1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
3. [Enable the Google Cloud Vision API.](https://cloud.google.com/vision)
4. [Setup Authentication.](https://googleapis.dev/python/google-api-core/latest/auth.html)

## Installation
Install this library in a [virtualenv](https://virtualenv.pypa.io/en/latest/) using pip. [virtualenv](https://virtualenv.pypa.io/en/latest/) is a tool to create isolated Python environments. The basic problem it addresses is one of dependencies and versions, and indirectly permissions.

With [virtualenv](https://virtualenv.pypa.io/en/latest/), it’s possible to install this library without needing system install permissions, and without clashing with the installed system dependencies.

### Supported Python Versions
Python >= 3.5

### Deprecated Python Versions
Python == 2.7. Python 2.7 support will be removed on January 1, 2020.

#### Windows 
```console
se7en@bar:~$ pip install virtualenv
se7en@bar:~$ virtualenv <your-env>
se7en@bar:~$ <your-env>\Scripts\activate
(<your-env>)se7en@bar:~$ 
```
### Dependencies Installation

Use the package manager [pip](https://pip.pypa.io/en/stable/) to install following
```bash
pip install -r requirements.txt
```

The easiest way to install the latest stable version of ML_APIs is with pip:
```console
pip install ML_APIs
```
### Example Usage Google Vision A.I. on local media file
```python3
from ML_APIs.google import vision_ai_local

path = <your-image>
model = 'logos'
credentials = <your-credentials.json>

image_classification = vision_ai_local(path, model, credentials)
image_classification.logos
```
### Next Steps
Read the [Product documentation](https://santhoshse7en.github.io/ML_APIs/doc) to learn more about the product and see How-to Guides.