JavaScripting

The definitive source of the best
JavaScript libraries, frameworks, and plugins.


  • ×

    Tesseract.js

    Pure Javascript OCR for 62 Languages 📖🎉🖥
    Filed under 

    • 🔾88%Overall
    • 17,449
    • 1.1 days
    • 🕩1193
    • 👥9

    Tesseract.js

    Build Status Financial Contributors on Open Collective npm version Maintenance License Code Style Downloads Total Downloads Month

    Version 2 is now available and under development in the master branch
    Check the support/1.x branch for version 1


    Tesseract.js is a javascript library that gets words in almost any language out of images. (Demo)

    fancy demo gif

    Tesseract.js wraps an emscripten port of the Tesseract OCR Engine. It works in the browser using webpack or plain script tags with a CDN and on the server with Node.js. After you install it, using it is as simple as:

    import { TesseractWorker } from 'tesseract.js';
    const worker = new TesseractWorker();
    
    worker.recognize(myImage)
      .progress(progress => {
        console.log('progress', progress);
      }).then(result => {
        console.log('result', result);
      });
    

    Check out the docs for a full explanation of the API.

    Major changes in v2

    • Upgrade to tesseract v4
    • Support multiple languages at the same time, eg: eng+chi_tra for English and Traditional Chinese
    • Supported image formats: png, jpg, bmp, pbm
    • Support WebAssembly (fallback to ASM.js when browser doesn't support)

    Installation

    Tesseract.js works with a <script> tag via local copy or CDN, with webpack via npm and on Node.js with npm/yarn.

    CDN

    <!-- v2 -->
    <script src='https://unpkg.com/tesseract.js@v2.0.0-alpha.13/dist/tesseract.min.js'></script>
    
    <!-- v1 -->
    <script src='https://unpkg.com/tesseract.js@1.0.19/src/index.js'></script>
    

    After including the script the Tesseract variable will be globally available.

    Node.js

    Tesseract.js currently requires Node.js v6.8.0 or higher

    # For v2
    npm install tesseract.js@next
    yarn add tesseract.js@next
    
    # For v1
    npm install tesseract.js
    yarn add tesseract.js
    

    Documentation

    Contributing

    Development

    To run a development copy of Tesseract.js do the following:

    # First we clone the repository
    git clone https://github.com/naptha/tesseract.js.git
    cd tesseract.js
    
    # Then we install the dependencies
    npm install
    
    # And finally we start the development server
    npm start
    

    The development server will be available at http://localhost:3000/examples/browser/demo.html in your favorite browser. It will automatically rebuild tesseract.dev.js and worker.min.js when you change files in the src folder.

    You can also run the development server in Gitpod ( a free online IDE and dev environment for GitHub that will automate your dev setup ) with a single click.

    Open in Gitpod

    Building Static Files

    To build the compiled static files just execute the following:

    npm run build
    

    This will output the files into the dist directory.

    Contributors

    Code Contributors

    This project exists thanks to all the people who contribute. [Contribute].

    Financial Contributors

    Become a financial contributor and help us sustain our community. [Contribute]

    Individuals

    Organizations

    Support this project with your organization. Your logo will show up here with a link to your website. [Contribute]

    Show All