# Cognixir

**Elixir API Wrapper for [Cognitive Services]( from Microsoft**

## Installation

If [available in Hex](, the package can be installed as:

  1. Add `Cognixir` to your list of dependencies in `mix.exs`:

    def deps do
      [{:Cognixir, "~> 0.1.0"}]

  2. Ensure `Cognixir` is started before your application:

    def application do
      [applications: [:Cognixir]]

## Configuration

You need a subscription key to access the different cognitive service api. Head over to, create an account and fetch your api key. You can get started with a free subscription.

Add to your config.exs:

# api key for text analytics
config :Cognixir, ta_api_key: "<your key>"
# api key for computer vision
config :Cognixir, cv_api_key: "<your key>"

## Implemented Features

### Text Analytics
 * detect language [x]
 * initiate topic analysis [x]
 * detect key phrases [x]
 * detect sentiment [x]

### Computer Vision
 * analyze image [x]
 * describe image [x]
 * get thumbnail []
 * list domain specific models []
 * OCR [x]
 * recognize domain specific content []
 * tag image [x]
 * raw image upload []

## Api Documentation

You can find the api documentation for published packages on [Hex Doc](