Skip to main content

OCR/HTR engine for all the languages

Project description

Description

https://travis-ci.org/mittagessen/kraken.svg?branch=master

kraken is a fork of ocropus intended to rectify a number of issues while preserving (mostly) functional equivalence. Its main features are:

  • Script detection and multiscript recognition support

  • Right-to-Left, BiDi, and Top-to-Bottom script support

  • ALTO, abbyXML, and hOCR output

  • Word bounding boxes and character cuts

  • Public repository of model files

  • Dynamic recognition model architectures and GPU acceleration

  • Clean public API

Installation

When using a recent version of pip all dependencies will be installed from binary wheel packages, so installing build-essential or your distributions equivalent is often unnecessary. kraken only runs on Linux or Mac OS X. Windows is not supported.

Install the latest 1.0 release through conda:

$ wget https://raw.githubusercontent.com/mittagessen/kraken/master/environment.yml
$ conda env create -f environment.yml

or:

$ wget https://raw.githubusercontent.com/mittagessen/kraken/master/environment_cuda.yml
$ conda env create -f environment_cuda.yml

for CUDA acceleration with the appropriate hardware.

It is also possible to install the same version from pypi:

$ pip install kraken

Finally you’ll have to scrounge up a model to do the actual recognition of characters. To download the default model for printed English text and place it in the kraken directory for the current user:

$ kraken get 10.5281/zenodo.2577813

A list of libre models available in the central repository can be retrieved by running:

$ kraken list

Quickstart

Recognizing text on an image using the default parameters including the prerequisite steps of binarization and page segmentation:

$ kraken -i image.tif image.txt binarize segment ocr

To binarize a single image using the nlbin algorithm:

$ kraken -i image.tif bw.png binarize

To segment a binarized image into reading-order sorted lines:

$ kraken -i bw.png lines.json segment

To OCR a binarized image using the default RNN and the previously generated page segmentation:

$ kraken -i bw.png image.txt ocr --lines lines.json

All subcommands and options are documented. Use the help option to get more information.

Documentation

Have a look at the docs

Funding

kraken is developed at Université PSL.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kraken-2.0.8.tar.gz (6.2 MB view details)

Uploaded Source

Built Distribution

kraken-2.0.8-py3-none-any.whl (643.4 kB view details)

Uploaded Python 3

File details

Details for the file kraken-2.0.8.tar.gz.

File metadata

  • Download URL: kraken-2.0.8.tar.gz
  • Upload date:
  • Size: 6.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/42.0.1.post20191125 requests-toolbelt/0.9.1 tqdm/4.39.0 CPython/3.6.7

File hashes

Hashes for kraken-2.0.8.tar.gz
Algorithm Hash digest
SHA256 bbf3b578b8e5adc80794a85cdd34967eaa23e76b5b31c533c9ce3245d4fe5737
MD5 33d6152a3415474ac1633a143a6390be
BLAKE2b-256 ca72ca218f7317952d6b4de28bf8e5d046259a8cceeb74dbc1648f5ee36db85d

See more details on using hashes here.

File details

Details for the file kraken-2.0.8-py3-none-any.whl.

File metadata

  • Download URL: kraken-2.0.8-py3-none-any.whl
  • Upload date:
  • Size: 643.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/42.0.1.post20191125 requests-toolbelt/0.9.1 tqdm/4.39.0 CPython/3.6.7

File hashes

Hashes for kraken-2.0.8-py3-none-any.whl
Algorithm Hash digest
SHA256 13ba79d5069645c7c91215da68498f78ae825c7431e2be846a076f4d8fe47d8a
MD5 117d0bd8c387a6b4e30ea3a30d07c41e
BLAKE2b-256 5f3dfcfdf98946cf25ec8991390e870bbce56db4399185acd035ebfb17b4e95a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page