No Package Mishaps

    @smodin/fast-text-language-detection

    0.2.3 • Public • Published

    Fast-Text Language Detection

    In a search for the best option for predicting a language from text which didn't require a large machine learning model, it appeared that fast-text, created by FaceBook, was the best option (https://towardsdatascience.com/benchmarking-language-detection-for-nlp-8250ea8b67c).

    Improving Accuracy

    Most incorrect suggestions are due to non-text characters (i.e. punctuation) that should be filtered out to provide better results. Please submit an issue for incorrect suggestions so we can work on improving the accuracy.

    Installation

    npm i --save @smodin/fast-text-language-detection
    

    Note: This will install the fast-text model by facebook which is about 150MB

    Usage

    Prediction

    Testing

    ;(async () => {
      const LanguageDetection = require('@smodin/fast-text-language-detection')
      const lid = new LanguageDetection()
    
      console.log(await lid.predict('FastText-LID provides a great language identification'))
      console.log(await lid.predict('FastText-LID bietet eine hervorragende Sprachidentifikation'))
      console.log(await lid.predict('FastText-LID fornisce un ottimo linguaggio di identificazione'))
      console.log(await lid.predict('FastText-LID fournit une excellente identification de la langue'))
      console.log(await lid.predict('FastText-LID proporciona una gran identificación de idioma'))
      console.log(await lid.predict('FastText-LID обеспечивает отличную идентификацию языка'))
      console.log(await lid.predict('FastText-LID提供了很好的語言識別'))
    })()

    Output

    [ { lang: 'en', prob: 0.6313226222991943, isReliableLanguage: true } ]
    [ { lang: 'de', prob: 0.9137917160987854, isReliableLanguage: true } ]
    [ { lang: 'it', prob: 0.974501371383667, isReliableLanguage: true } ]
    [ { lang: 'fr', prob: 0.7358829379081726, isReliableLanguage: true } ]
    [ { lang: 'es', prob: 0.9211937189102173, isReliableLanguage: true } ]
    [ { lang: 'ru', prob: 0.9899846911430359, isReliableLanguage: true } ]
    [ { lang: 'zh', prob: 0.8515647649765015, isReliableLanguage: true } ]
    

    isReliableLanguage is true if there were 10 + test results and accuracy was 95% or more

    Other Helpers

    const LanguageDetection = require('@smodin/fast-text-language-detection')
    const lid = new LanguageDetection()
    const languageIsoCodes = lid.languageIsoCodes // ['af', 'als', 'am', 'an', 'ar', ...]

    Similar Libaries

    FastText has been used and implemented in other computer languages.

    Reference Documents

    Accuracy from Benchmark Testing

    Long Input (30 to 250 characters)

    Translated sentence data was obtained from tatoeba.org. Testing the 550k sentences of 30 - 250 characters took less than 30 seconds (personal macbook Pro).

    Language (101) Symbol (alternates) Count (558260) Accuracy (30 - 250 chars) Mislabels
    English en 22428 1
    Greek el 12039 1
    Hebrew he 8616 1
    Japanese ja 2169 1
    Georgian ka 1973 1
    Bengali bn 1164 1
    Thai th 572 1
    Mandarin Chinese zh 568 1
    Malayalam ml 517 1
    Korean ko 482 1
    Burmese my 216 1
    Tamil ta 205 1
    Kannada kn 118 1
    Telugu te 102 1
    Punjabi (Eastern) pa 88 1
    Lao lo 70 1
    Gujarati gu 57 1
    Tibetan bo 20 1
    Divehi, Dhivehi, Maldivian dv 15 1
    Sinhala si 9 1
    Amharic am 3 1
    German de 22014 0.9998637230853094 en
    Polish pl 17768 0.999718595227375 en,eo,de,ro
    Russian ru 17329 0.9997114663281205 bg,kk,uk,mk
    Hungarian hu 17942 0.9996655891204994 tr,br,it,de,en
    Hindi hi 5362 0.999627004848937 mr
    Vietnamese vi 13000 0.9996153846153846 eo,hu,fr
    Turkish tr 19919 0.9995983734123199 eo,en,it,fr,nds
    Esperanto eo 17841 0.999551594641556 it,es,pt,fr,ceb
    French fr 23076 0.999523314265904 en,es,it,ru
    Marathi mr 10461 0.9995220342223496 hi
    Uyghur ug 3692 0.9991874322860238 ba,ru,hu
    Finnish fi 17406 0.9990807767436516 it,et,en,hr,de
    Italian it 18326 0.9989632216522972 es,de,fr,en,la
    Spanish es 18227 0.998134635430954 pt,it,io,ca,ia
    Armenian hy 518 0.9980694980694981 de
    Arabic ar 8761 0.9978312977970552 arz,fa,es,mzn,en
    Ukrainian uk 14285 0.9963598179908996 ru,sr
    Macedonian mk 14465 0.9959903214656066 bg,sr,ru
    Dutch nl 19626 0.9934780393355752 en,af,de,nds,fr
    Lithuanian lt 13835 0.9933501987712324 fi,pl,eo,pt,sr
    Portuguese pt 20174 0.9933082184990581 es,gl,it,en,fr
    Khmer km 379 0.9920844327176781 az,et
    Urdu ur 963 0.9906542056074766 pnb,fa,ro,en
    Czech cs 10863 0.9898738838258307 sk,pl,hu,sl,en
    Swedish sv 12188 0.9886773875943551 no,da,en,fi,id
    Romanian ro 13560 0.9886430678466077 es,fr,it,en,pt
    Bulgarian bg 11144 0.9869885139985642 mk,ru,uk,sr
    Ossetian os 59 0.9830508474576272 ru
    Icelandic is 6364 0.9803582652419862 et,no,da,hu,cs
    Kazakh kk 2232 0.9802867383512545 ru,tr,tt,uk,ky
    Tagalog tl 10351 0.9737223456670853 ceb,en,id,es,war
    Tatar tt 8178 0.9680851063829787 az,tr,ru,fi,kk
    Basque eu 2999 0.9676558852950984 it,nl,id,en,io
    Tajik tg 30 0.9666666666666667 ru
    Belarusian be 6253 0.9625779625779626 uk,ru,pl,bg,sr
    Latvian lv 1243 0.9597747385358005 lt,hr,sr,fi,eo
    Chuvash cv 460 0.9543478260869566 ru,uk,ba,sr
    Breton br 2451 0.9543043655650755 fr,nl,eu,de,pt
    Bashkir ba 120 0.95 tt,av
    Indonesian id 9372 0.949637217242851 ms,it,en,eo,tr
    Danish da 15299 0.948035819334597 no,sv,de,en,nn
    Estonian et 1227 0.9356153219233904 fi,en,hu,it,nl
    Latin la 11437 0.9206085511934948 fr,it,en,es,pt
    Irish ga 867 0.9065743944636678 en,gd,ca,kv,cs
    Scottish Gaelic gd 542 0.8966789667896679 en,ga,de,fr,pam
    Welsh cy 619 0.8917609046849758 es,en,la,kw,de
    Catalan ca 4725 0.8833862433862434 es,pt,fr,it,ro
    Kyrgyz ky 66 0.8787878787878788 ru,kk
    Cornish kw 426 0.8779342723004695 en,cy,de,br,sq
    Assamese as 960 0.8635416666666667 bn
    Volapük vo 806 0.8511166253101737 id,de,fi,en,eo
    Serbian sr 13494 0.8489699125537276 hr,sh,mk,bs,sl
    Slovak sk 4370 0.8263157894736842 cs,pl,sl,no,sr
    Maltese mt 52 0.8076923076923077 es,cs,pt,sr,eo
    Norwegian Nynorsk nn (no) 657 0.7990867579908676 da,sv,de,es,fi
    Afrikaans af 1632 0.7879901960784313 nl,en,fr,de,nds
    Occitan oc 2861 0.7679133170220203 ca,es,fr,pt,it
    Interlingua ia 18782 0.7500798636992866 es,it,fr,la,pt
    Sanskrit sa 11 0.7272727272727273 hi,ne
    Chechen ce 7 0.7142857142857143 mn,ru
    Slovenian sl 372 0.6774193548387096 sr,hr,bs,pl,eo
    Frisian fy 107 0.6635514018691588 nl,en,de,af,fr
    Javanese jv 260 0.6461538461538462 id,en,ms,ko,su
    Yoruba yo 5 0.6 sk,rm
    Luxembourgish lb 217 0.5944700460829493 de,nds,sv,fr,nl
    Galician gl 2618 0.5790679908326967 pt,es,it,fr,ca
    Turkmen tk 3793 0.5710519377801213 tr,uz,en,et,io
    Croatian hr 2222 0.5333033303330333 sr,sh,bs,sl,pl
    Aragonese an 4 0.5 es
    Ido io 2905 0.48055077452667816 eo,es,it,pt,tr
    Interlingue ie 2007 0.4718485301444943 es,it,fr,en,ia
    Limburgan, Limburger, Limburgish li 3 0.3333333333333333 de
    Walloon wa 16 0.3125 fr,pt,tl,oc,en
    Somali so 32 0.21875 fi,eo,cy,en,az
    Corsican co 5 0.2 it,fr
    Sundanese su 11 0.18181818181818182 id,ms,es
    Haitian Creole ht 15 0.06666666666666667 fr,br,su,diq,no
    Romansh rm 16 0.0625 it,fr,en,tl,qu
    Bosnian bs 139 0.03597122302158273 sr,hr,sh,pl,sl
    Manx gv 6 0 cy,fr,nl,et,en

    Short Form (10 to 40 characters)

    As a test of accuracy on shorter phrases, the min and max character count was changed to 10 - 40, and similar results can be seen for major languages, but less known languages suffer significantly:

    Language (102) Symbol (alternates) Count (837539) Accuracy (10 - 40 chars) Mislabels
    Thai th 3399 1
    Malayalam ml 525 1
    Burmese my 243 1
    Tamil ta 229 1
    Telugu te 220 1
    Punjabi (Eastern) pa 156 1
    Amharic am 154 1
    Kannada kn 126 1
    Gujarati gu 116 1
    Sinhala si 37 1
    Tibetan bo 29 1
    Divehi, Dhivehi, Maldivian dv 15 1
    Japanese ja 28060 0.9999643620812545 zh
    Greek el 24980 0.9999599679743795 en
    Hebrew he 26461 0.9999244170666264 en,yi
    Korean ko 6128 0.9996736292428199 tr,ja
    Armenian hy 1855 0.9994609164420485 de
    Bengali bn 4132 0.9992739593417231 bpy,as
    Marathi mr 25633 0.9989466703078064 hi,gom,pt,new
    English en 17094 0.9986544986544986 nl,it,hu,eo,es
    Mandarin Chinese zh 17801 0.9978652884669401 wuu,yue,ja,sr,pt
    Turkish tr 18879 0.9978282748026909 en,eo,az,es,it
    Russian ru 20855 0.9977942939343083 uk,bg,mk,sr,be
    German de 17223 0.9974452766649248 en,it,fr,es,sv
    Uyghur ug 6135 0.9973920130399349 ar,ba,tt,ca,hu
    Vietnamese vi 13130 0.9971058644325971 it,pms,eo,pt,fr
    Esperanto eo 21641 0.9966729818400258 it,es,tr,pt,pl
    Georgian ka 4550 0.996043956043956 xmf,en
    Hindi hi 11497 0.9958249978255197 mr,dty,new,bh,ne
    Italian it 20449 0.995598806787618 es,en,fr,eo,pt
    Arabic ar 25531 0.9955348399984333 arz,fa,en,mzn,ps
    French fr 16040 0.9953865336658354 en,it,ia,es,pt
    Hungarian hu 20843 0.9952502039053879 en,pt,it,nl,eo
    Lao lo 183 0.994535519125683 el
    Polish pl 21386 0.9940147760216964 en,it,eo,de,cs
    Khmer km 1252 0.9920127795527156 az,ru,sr,et
    Spanish es 20498 0.9895599570689824 pt,it,fr,ca,en
    Finnish fi 20731 0.9849500747672567 it,en,eo,et,nl
    Portuguese pt 18352 0.9833805579773321 es,it,gl,fr,en
    Macedonian mk 23602 0.9830099144140327 ru,bg,sr,uk
    Ukrainian uk 23251 0.982667412154316 ru,mk,bg,be,sr
    Urdu ur 1583 0.9797852179406191 pnb,fa,ug,en,ro
    Dutch nl 19349 0.9720915809602564 en,de,nds,af,fr
    Lithuanian lt 24184 0.9597667879589812 eo,fi,sr,pt,pl
    Czech cs 25189 0.951605859700663 sk,pl,hu,en,sl
    Chuvash cv 1332 0.9481981981981982 ru,uk,krc,ba,sr
    Tatar tt 8283 0.9471206084751902 ru,tr,az,kk,ky
    Swedish sv 24466 0.9464563067113545 da,no,en,de,eo
    Icelandic is 7745 0.9449967721110394 da,et,cs,no,de
    Bulgarian bg 19328 0.9352235099337748 mk,ru,uk,sr,tg
    Sanskrit sa 135 0.9259259259259259 hi,ne,mr
    Kazakh kk 2373 0.9258322798145807 uk,tt,tr,ru,ky
    Romanian ro 18367 0.9235041106332008 it,es,en,fr,pt
    Tagalog tl 11133 0.9193389023623462 ceb,en,it,id,es
    Ossetian os 205 0.9170731707317074 ru,hy,sr,kv,mrj
    Indonesian id 9707 0.9138765839085197 ms,en,it,eo,tr
    Danish da 22539 0.9081591907360576 no,sv,de,en,fr
    Latin la 24699 0.8979310903275436 it,fr,en,es,pt
    Basque eu 4570 0.8851203501094091 it,id,hu,nl,eo
    Belarusian be 9005 0.8785119378123265 ru,uk,bg,mk,pl
    Cornish kw 3757 0.8759648655842428 en,de,cy,es,br
    Tajik tg 48 0.875 ru,uk
    Latvian lv 2198 0.8735213830755232 lt,es,sr,en,fr
    Breton br 5468 0.8579005120702268 en,fr,pt,de,eu
    Irish ga 1977 0.840161861406171 en,pt,es,ca,gd
    Bashkir ba 128 0.8359375 tt,ru,sr,av,kk
    Sindhi sd 6 0.8333333333333334 ur
    Serbian sr 23128 0.8054738844690419 hr,mk,sh,ru,sl
    Estonian et 3077 0.8043548911277218 fi,en,hu,tr,it
    Scottish Gaelic gd 753 0.7822045152722443 en,ga,de,fr,pam
    Welsh cy 1167 0.7660668380462725 en,es,kw,la,it
    Volapük vo 3941 0.7609743719868054 id,en,eo,fi,de
    Kyrgyz ky 227 0.7533039647577092 ru,kk,tt,mn,bg
    Catalan ca 5313 0.7504234895539243 es,pt,it,fr,en
    Assamese as 2635 0.7127134724857686 bn,bpy,en,tl,bh
    Yoruba yo 31 0.7096774193548387 ga,pl,en,qu,ckb
    Occitan oc 4096 0.70751953125 es,fr,ca,pt,it
    Interlingua ia 14949 0.7073382834972239 it,es,fr,en,la
    Afrikaans af 3299 0.6808123673840558 nl,en,de,fr,nds
    Norwegian Nynorsk nn (no) 1287 0.6798756798756799 da,sv,de,es,hu
    Maltese mt 165 0.6727272727272727 hu,en,es,it,pl
    Slovak sk 13877 0.6105786553289616 cs,pl,sl,no,sr
    Chechen ce 25 0.6 bg,sr,mn,ba,uk
    Interlingue ie 6538 0.5183542367696543 es,it,en,fr,eo
    Ido io 6495 0.4857582755966128 eo,es,it,pt,tr
    Slovenian sl 908 0.46255506607929514 sr,hr,cs,pl,bs
    Javanese jv 548 0.45255474452554745 id,en,ko,ms,hu
    Turkmen tk 4585 0.45169029443838604 tr,en,uz,et,pl
    Croatian hr 4186 0.4362159579550884 sr,sh,bs,sl,pl
    Galician gl 3245 0.4200308166409861 pt,es,it,en,fr
    Luxembourgish lb 732 0.3975409836065574 de,fr,en,nds,nl
    Frisian fy 282 0.36879432624113473 nl,en,nds,de,fr
    Walloon wa 37 0.2972972972972973 fr,en,no,it,gn
    Corsican co 13 0.23076923076923078 it,min,ro,ilo,id
    Sundanese su 18 0.2222222222222222 id,es,en,it,lmo
    Somali so 61 0.14754098360655737 en,fi,et,cy,su
    Limburgan, Limburger, Limburgish li 34 0.14705882352941177 de,nl,en,no,is
    Haitian Creole ht 58 0.1206896551724138 en,fr,br,la,de
    Manx gv 30 0.06666666666666667 en,it,pt,fr,kw
    Bosnian bs 520 0.04423076923076923 sr,hr,sh,it,pl
    Aragonese an 73 0.0136986301369863 es,pt,it,en,fr
    Romansh rm 11 0 it,pt,fr,en,tl

    Comparison NPM Libaries

    Success benchmarking has been checked with other popular libraries (notably franc and languagedetect) and results are included in benchmark-testing/results/COMPARISONS.md

    TODO List

    This is an improved modification of https://www.npmjs.com/package/fasttext-lid

    Created with <3 for https://smodin.io

    Install

    npm i @smodin/fast-text-language-detection

    DownloadsWeekly Downloads

    46

    Version

    0.2.3

    License

    none

    Unpacked Size

    43.6 kB

    Total Files

    5

    Last publish

    Collaborators

    • kmdanikowski