# Cognixir
**Elixir API Wrapper for [Cognitive Services](https://www.microsoft.com/cognitive-services/en-us/apis) from Microsoft**
## Installation
If [available in Hex](https://hex.pm/docs/publish), the package can be installed as:
1. Add `Cognixir` to your list of dependencies in `mix.exs`:
```elixir
def deps do
[{:Cognixir, "~> 0.1.0"}]
end
```
2. Ensure `Cognixir` is started before your application:
```elixir
def application do
[applications: [:Cognixir]]
end
```
## Configuration
You need a subscription key to access the different cognitive service api. Head over to https://www.microsoft.com/cognitive-service, create an account and fetch your api key. You can get started with a free subscription.
Add to your config.exs:
```elixir
# 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](https://hexdocs.pm/cognixir/api-reference.html)