Language Guesser is a robust and efficient library for detecting the language of a given text based on statistical analysis. It's perfect for applications that need to handle multilingual user input.

Install the package using npm:

npm install @horizon-rs/language-guesser

Or with yarn:

yarn add @horizon-rs/language-guesser

Detecting a list of possible languages of a text

import { Language } from '@horizon-rs/language-guesser';

const language = new Language();
const text = 'This is a sample text in English.';
const result = language.guess(text);

console.log('Detected language:', result);

Detected languages: [
  {
    alpha3: 'eng',
    alpha2: 'en',
    language: 'English',
    score: 0.9059288537549407
  },
...
]

Detecting the best single language of a given text

import { Language } from '@horizon-rs/language-guesser';

const language = new Language();
const text = 'This is a sample text in English.';
const result = language.guessBest(text);

console.log('Detected languages:', result);

Detected languages: {
  alpha3: 'eng',
  alpha2: 'en',
  language: 'English',
  score: 0.9059288537549407
}

Specifying expected language options for detection

import { Language } from '@horizon-rs/language-guesser';

const language = new Language();
const text = 'This is a sample text in English.';
const result = language.guessBest(text, ['eng']);

console.log('Detected language:', result);

Detected language: { alpha3: 'eng', alpha2: 'en', language: 'English', score: 1 }

The Language class provides methods for language detection and related operations.

Creates a new instance of the Language class.

Detects the language of the provided utterance. You can optionally specify an allowList of accepted languages and a limit for the number of results.

Returns the best guess for the language of the utterance. You can optionally specify an allowList of accepted languages.

Adds an extra sentence for language analysis. This can enhance the accuracy of language detection.

We welcome contributions! Feel free to submit issues and pull requests. Let's make Language Guesser the best language detection library together!

Special thanks to AXA's NLP-JS, which served as a significant source of inspiration for this library.

This project is licensed under the MIT License - see the LICENSE file for details.