Skip to main content

OCR engine compatible with ocropus

Project description

Description

https://travis-ci.org/mittagessen/kraken.svg

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

  • Explicit input/output handling ✓

  • Word and character bounding boxes in hOCR ✓

  • Removal of runtime dependency on gcc ✓

  • clstm compatibility ✓

  • Right-to-left/BiDi support ✓

  • Clean public API

  • Tests

Ticked of goals have been realized while some others still require further work. Pull requests and code contributions are always welcome.

Installation

kraken does not require a working C compiler on run-time anymore. 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.

If clstm support is desired (highly recommended) the associated python extension has to be build and installed.

Install kraken either from pypi:

$ pip install kraken

or by running pip in the git repository:

$ pip install .

Finally you’ll have to scrounge up an RNN to do the actual recognition of characters. To download ocropus’ default RNN and place it in the kraken directory for the current user:

$ kraken get default

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.tif binarize

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

$ kraken -i bw.tif lines.txt segment bw.png

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

$ kraken -i bw.tif image.txt ocr --lines lines.txt

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

Documentation

Have a look at the documentation

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-0.9.0.tar.gz (5.1 MB view details)

Uploaded Source

Built Distribution

kraken-0.9.0-py2.py3-none-any.whl (89.5 kB view details)

Uploaded Python 2 Python 3

File details

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

File metadata

  • Download URL: kraken-0.9.0.tar.gz
  • Upload date:
  • Size: 5.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for kraken-0.9.0.tar.gz
Algorithm Hash digest
SHA256 8df10659102f929f1cb10806eb7cca7336dba1e2ea5bb2d7ba29bc0db372076a
MD5 f34c1ac1fb89f0480f375a935fe938c0
BLAKE2b-256 9186a8cc60db243d35de8f88cdcc84c27d7a082ae12d7ac3888330026fa8aa92

See more details on using hashes here.

File details

Details for the file kraken-0.9.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for kraken-0.9.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 58ee7c660b9ffe7a460d5a3010a9eeb577b8f41cdf736f5a37af3f2960999f3c
MD5 728a27477bd6d150322838e8b96617be
BLAKE2b-256 ad6376e6ab627746a08357ba4b0557ef5758b7eeb5a9d5cedfddc1e35e37f646

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