orionstark
/
tesseract.js
mirror of https://github.com/OrionStark/tesseract.js.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Pure Javascript OCR for more than 100 Languages 📖🎉🖥
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
765 Commits
1 Branch
0 Tags
90 MiB
 
 
Tag: Branch: Tree: 680d2e4e01
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '680d2e4e01'
${ noResults }
tesseract.js/docs/local-installation.md

2.4 KiB
Raw Blame History

Local Installation

Check here for examples: https://github.com/naptha/tesseract.js/blob/master/docs/examples.md

In browser environment, tesseract.js simply provides the API layer. Internally, it opens a WebWorker to handle requests. That worker itself loads code from the Emscripten-built tesseract.js-core which itself is hosted on a CDN. Then it dynamically loads language files hosted on another CDN.

Because of this we recommend loading tesseract.js from a CDN. But if you really need to have all your files local, you can pass extra arguments to TesseractWorker to specify custom paths for workers, languages, and core.

In Node.js environment, the only path you may want to customize is languages/langPath.

const worker = await createWorker({
  workerPath: 'https://cdn.jsdelivr.net/npm/tesseract.js@v5.0.0/dist/worker.min.js',
  langPath: 'https://tessdata.projectnaptha.com/4.0.0',
  corePath: 'https://cdn.jsdelivr.net/npm/tesseract.js-core@v5.0.0',
});

workerPath

A string specifying the location of the worker.js file.

langPath

A string specifying the location of the tesseract language files. Language file URLs are calculated according to the formula langPath + langCode + '.traineddata.gz'. If langPath is not specified by the user, then the correct language data will be automatically downloaded from the jsDelivr CDN.

corePath

A string specifying the location of the tesseract.js-core files, with default value 'https://cdn.jsdelivr.net/npm/tesseract.js-core@v5.0.0'.

If you set the corePath argument, be sure to set it to a directory that contains all 4 of these files:

  1. tesseract-core.wasm.js
  2. tesseract-core-simd.wasm.js
  3. tesseract-core-lstm.wasm.js
  4. tesseract-core-simd-lstm.wasm.js

Tesseract.js will pick the correct file based on your users' device and the createWorker options.

To avoid breaking old code, when corePath is set to a specific .js file (e.g. https://cdn.jsdelivr.net/npm/tesseract.js-core@v5.0.0/tesseract-core.wasm.js), it will load that file regardless of whether the users' device supports SIMD or not. This behavior only exists to preserve backwards compatibility—setting corePath to a specific .js file is strongly discouraged. Doing so will either result in much slower performance (if tesseract-core.wasm.js is specified) or failure to run on certain devices (if tesseract-core-simd.wasm.js is specified).