Content
- Features
- Get started
- Documentation
- Supported languages
- Feature toggles
- How does it work?
- Running benchmark
- Comparison with alternatives
- Ports and clones
- Donations
- Derivation
- License
- Contributors
Features
- Supports 68 languages
- 100% written in Rust
- Lightweight, fast and simple
- Recognizes not only a language, but also a script (Latin, Cyrillic, etc)
- Provides reliability information
Get started
Add to you Cargo.toml
:
[dependencies]
whatlang = "0.14.0"
Example:
extern crate whatlang;
use ;
For more details (e.g. how to blacklist some languages) please check the documentation.
Feature toggles
Feature | Description |
---|---|
enum-map |
Lang and Script implement Enum trait from enum-map |
How does it work?
How does the language recognition work?
The algorithm is based on the trigram language models, which is a particular case of n-grams. To understand the idea, please check the original whitepaper Cavnar and Trenkle '94: N-Gram-Based Text Categorization'.
How is is_reliable
calculated?
It is based on the following factors:
- How many unique trigrams are in the given text
- How big is the difference between the first and the second(not returned) detected languages? This metric is called
rate
in the code base.
Therefore, it can be presented as 2d space with threshold functions, that splits it into "Reliable" and "Not reliable" areas. This function is a hyperbola and it looks like the following one:
For more details, please check a blog article Introduction to Rust Whatlang Library and Natural Language Identification Algorithms.
Make tasks
make bench
- run performance benchmarksmake doc
- generate and open docmake test
- run testsmake watch
- watch changes and run tests
Comparison with alternatives
Whatlang | CLD2 | CLD3 | |
---|---|---|---|
Implementation language | Rust | C++ | C++ |
Languages | 68 | 83 | 107 |
Algorithm | trigrams | quadgrams | neural network |
Supported Encoding | UTF-8 | UTF-8 | ? |
HTML support | no | yes | ? |
Ports and clones
- whatlang-ffi - C bindings
- whatlanggo - whatlang clone for Go language
- whatlang-py - bindings for Python
- whatlang-rb - bindings for Ruby
Donations
You can support the project by donating NEAR tokens.
Our NEAR wallet address is whatlang.near
Derivation
Whatlang is a derivative work from Franc (JavaScript, MIT) by Titus Wormer.
License
Contributors
- greyblake Potapov Sergey - creator, maintainer.
- Dr-Emann Zachary Dremann - optimization and improvements
- BaptisteGelez Baptiste Gelez - improvements
- Vishesh Chopra - designed the logo
- Joel Natividad - support of Tagalog
- ManyTheFish - crazy optimization
- Kerollmops Clément Renault - crazy optimization