Indra

KO | EN

gitlite — search

#javascript #python #php #c-sharp #plugin #ruby #android #css #node #processwire #dotfiles #shell

★ 51 Open GitHub ↗

Indra is a Web Service which allows easy access to different distributional semantics models in several languages.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![](https://raw.githubusercontent.com/Lambda-3/Indra/master/indra_logo.png)

[![Build Status](https://travis-ci.org/Lambda-3/Indra.svg?branch=master)](https://travis-ci.org/Lambda-3/Indra)
[![Chat](https://badges.gitter.im/Lambda-3/gitter.png)](https://gitter.im/Lambda-3/Lobby)

# What is Indra?

Indra is an efficient library and service to deliver word-embeddings and semantic relatedness to real-world applications in the domains of machine learning and natural language processing. It offers 60+ pre-build models in 15 languages and several model algorithms and corpora.

Indra is powered by [spotify-annoy](https://github.com/spotify/annoy) delivering an efficient [approximate nearest neighbors](http://en.wikipedia.org/wiki/Nearest_neighbor_search#Approximate_nearest_neighbor) function.

# Features

* Efficient approximate nearest neighbors (powered by [spotify-annoy](https://github.com/spotify/annoy));
* 60+ pre-build models in 15 languages;
* Permissive license for commercial use (MIT License);
* Support to [translated distributional relatedness](http://andrefreitas.org/papers/preprint_eakw_mt_2016.pdf);
* Easy deploy: Deploy the infrastructure in 3 steps;
* Access to the semantic models as a service;
* Supports multiple distributional semantic models and distance measures.

# Pre-build Models

Indra delivers ready-to-use pre-build models using different algorithms, data set corpora and languages.
For a full list of pre-build models, please check the [Wiki](https://github.com/Lambda-3/Indra/wiki).

## Model Algorithms

* [Word2Vec (W2V)](https://en.wikipedia.org/wiki/Word2vec)
* [Global Vectors (GloVe)](https://en.wikipedia.org/wiki/GloVe_(machine_learning))
* [Explicit Semantic Analysis (ESA)](https://en.wikipedia.org/wiki/Explicit_semantic_analysis)
* [Dependency-Based Word Embeddings](http://www.aclweb.org/anthology/P14-2050)
* [Latent Semantic Analysis (LSA)](https://en.wikipedia.org/wiki/Latent_semantic_analysis)

## Supported Languages

* EN - English
* DE - German
* ES - Spanish
* FR - French
* PT - Portuguese
* IT - Italian
* SV - Swedish
* ZH - Chinese
* NL - Dutch
* RU - Russian
* KO - Korean
* JA - Japanese
* AR - Arabic
* FA - Persian
* EL - Greek

# Install

To install, please use the 3-step tool [IndraComposed](https://github.com/Lambda-3/IndraComposed).

# Getting Started

This guide provides the basic instructions to get you started using Indra. For further details, including the response format, additional parameters and the list of available models and language, please check the [Wiki](https://github.com/Lambda-3/Indra/wiki).

## Requesting Word Embeddings `(POST /vectors)`

```json
{
	"corpus": "googlenews",
	"model": "W2V",
	"language": "EN",
	"terms": ["love", "mother", "santa claus"]
}
```
For further details, check the [Word Embeddings documentation](https://github.com/Lambda-3/Indra/wiki/Documentation).

## Requesting Nearest Neighbors Vectors `(POST /neighbors/vectors)`

```json
{
	"corpus": "googlenews",
	"model": "W2V",
	"language": "EN",
	"topk": 10,
	"terms": ["love", "mother", "santa"]
}
```
For further details, check the [Nearest Neighbors documentation](https://github.com/Lambda-3/Indra/wiki/Documentation).

## Requesting Nearest Neighbors Relatedness `(POST /neighbors/relatedness)`

```json
{
	"corpus": "googlenews",
	"model": "W2V",
	"language": "EN",
	"topk": 10,
	"scoreFunction": "COSINE",
	"terms": ["love", "mother", "santa"]
}
```
For further details, check the [Nearest Neighbors documentation](https://github.com/Lambda-3/Indra/wiki/Documentation).

## Requesting Semantic Similarity (Pair of Terms) `(POST /relatedness)`

```json
{
	"corpus": "wiki-2018",
	"model": "W2V",
	"language": "EN",
	"scoreFunction": "COSINE",
	"pairs": [{
		"t2": "love",
		"t1": "mother"
	},
	{
		"t2": "love",
		"t1": "santa claus"
	}]
}
```

For further details, check the [Semantic Similarity documentation](https://github.com/Lambda-3/Indra/wiki/Documentation).

## Requesting Semantic Similarity (One-to-Many) `(POST /relatedness/otm)`

```json
{
	"corpus": "wiki-2018",
	"model": "W2V",
	"language": "EN",
	"scoreFunction": "COSINE",
	"one" : "love",
	"many" : ["mother", "father", "child"]
}
```

For further details, check the [Semantic Similarity documentation](https://github.com/Lambda-3/Indra/wiki/Documentation).

# Translated Word Embeddings and Semantic Similarity

For __translated word embeddings__ and __translated semantic similarity__ just append _"mt" : true_ in the JSON payload.

# Public Endpoint

We have a public endpoint for demonstration only hence you can try right now with _cURL_ on the command line.

## For word embeddings:

```
curl -X POST -H "Content-Type: application/json" -d '{
	"corpus": "wiki-2018",
	"model": "W2V",
	"language": "EN",
	"terms": ["love", "mother", "santa claus"]
}' "http://indra.lambda3.org/vectors"
```

## For semantic similarity:

```
curl -X POST -H "Content-Type: application/json" -d '{
	"corpus": "wiki-2018",
	"model": "W2V",
	"language": "EN",
	"scoreFunction": "COSINE",
	"pairs": [{
		"t2": "love",
		"t1": "mother"
	},
	{
		"t2": "love",
		"t1": "santa claus"
	}]
}' "http://indra.lambda3.org/relatedness"
```

# Citing Indra

Please cite Indra, if you use it in your experiments or project.
```latex
@InProceedings{indra,
author="Sales, Juliano Efson and Souza, Leonardo and Barzegar, Siamak and Davis, Brian and Freitas, Andr{\'e} and Handschuh, Siegfried",
title="Indra: A Word Embedding and Semantic Relatedness Server",
booktitle = {Proceedings of the Eleventh International Conference on Language Resources and Evaluation (LREC 2018)},
month     = {May},
year      = {2018},
address   = {Miyazaki, Japan},
publisher = {European Language Resources Association (ELRA)},
}
```

# Contributors (alphabetical order)

- Andre Freitas
- Brian Davis
- Juliano Sales
- Leonardo Souza
- Siamak Barzegar
- Siegfried Handschuh

Indra

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README