Skip to main content

Image-to-text Tesseract command line wrapper.

Project description

PILtesseract
=======
[![](https://img.shields.io/pypi/v/piltesseract.svg?branch=master)](https://pypi.python.org/pypi/piltesseract)

Simple Tesseract wrapper for converting PIL Images to text.

**Warning:** PILtesseract is intended to only work with tesseract 3.03+,
one awesome feature added in 3.03 is the ability to pipe images via stdin,
PILtesseract utilizes this feature.

Features
------------
- Completely wraps [Tesseract-OCR](https://github.com/tesseract-ocr/tesseract) command line optional arguments.
- Sends [PIL](https://pillow.readthedocs.org/en/latest/) images to tesseract through stdin (avoids creating a temp file).
- Works for Python 2 and 3.
- All working code in [one file](https://github.com/Digirolamo/PILtesseract/blob/master/piltesseract/tesseractwrapper.py).
- [MIT License](https://github.com/Digirolamo/PILtesseract/blob/master/LICENSE)
- [Documentation](http://piltesseract.readthedocs.org/en/latest/)

Here is a simple example:


>>> from PIL import Image
>>> from piltesseract import get_text_from_image
>>> image = Image.open('quickfox.png')
>>> get_text_from_image(image)
'The quick brown fox jumps over the lazy dog'

See [Advanced Example](http://piltesseract.readthedocs.org/en/latest/example.html)
See [Recipes](http://piltesseract.readthedocs.org/en/latest/recipes.html)

Requirements
------------
More detailed installation instructions can be found [here](http://piltesseract.readthedocs.org/en/latest/install.html).
- [Tesseract-OCR](https://github.com/tesseract-ocr/tesseract): 3.03 or higher
- First install either from source or from [binaries](https://github.com/tesseract-ocr/tesseract/wiki).
- Ensure that the tesseract binary folder is on your [PATH](https://en.wikipedia.org/wiki/PATH_(variable)).
- [Pillow](https://pillow.readthedocs.org/en/latest/)
- ```$ pip install Pillow```
- [Six](https://pythonhosted.org/six/)
- ```$ pip install six```

Install
------------

$ pip install piltesseract

Project details


Download files

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

Source Distribution

piltesseract-1.0.2.zip (10.6 kB view details)

Uploaded Source

Built Distribution

piltesseract-1.0.2-py2.py3-none-any.whl (8.0 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file piltesseract-1.0.2.zip.

File metadata

  • Download URL: piltesseract-1.0.2.zip
  • Upload date:
  • Size: 10.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for piltesseract-1.0.2.zip
Algorithm Hash digest
SHA256 7844d871c83001d531a877e2c520e9245809e7f53c72e4129d71f416d3fdee72
MD5 166d1703fa00fcc3be81588435bd21ca
BLAKE2b-256 80307388812e2bd43a3a65ce4c01651dbe1a7870d0bd07a79f4a4b0fcd9330a2

See more details on using hashes here.

File details

Details for the file piltesseract-1.0.2-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for piltesseract-1.0.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 66a5899e6534c7d3c576bdb25bdaf8bb2395afaa0738ea80a79fc46cb32ecc77
MD5 f017bc6a1168be5d32701bb0bbf00288
BLAKE2b-256 f801e0c84b75b70c1ed28c8fd7fbe50369a8f8f98adc9fe5b41150f9809bbc6a

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 Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page