Documentation – Getting started

Python: System requirements

Wed, 13 Dec 2023 00:00:00 +0000

Aspose.OCR for Python via .NET works under Python version 3.6 or later. The library is cross-platform - you can run your code unchanged on any of the following 64-bit operating systems:

Despite of “via .NET” in the name, the library does not require .NET Runtime to be installed on the target host. All required dependencies are already built into the distributive package.

Microsoft Windows

Desktop

Microsoft Windows 11: Home, Pro, Pro Education, Pro for Workstations, Enterprise, and Education
Microsoft Windows 10 version 1703: Home, Professional, Education, and Enterprise
Microsoft Windows 8: Core, Professional, and Enterprise
Microsoft Windows 7: Home Premium, Professional, Enterprise, Ultimate

Server

Microsoft Windows Server 2022
Microsoft Windows Server 2019
Microsoft Windows Server 2016
Microsoft Windows Server 2012
Microsoft Windows Server 2008 R2 SP1

macOS

macOS Mojave version 10.14 or later, x64

MacOS ARM (Apple Silicon) platform is fully supported.

Linux

Any Linux x64, including:

Ubuntu
OpenSUSE
CentOS

Python: External dependencies

Sat, 26 Aug 2023 00:00:00 +0000

Aspose.OCR for Python via .NET requires the following third-party components to be installed:

GNU Compiler Collection (GCC) runtime, version 6 or later.
PyMalloc memory allocator (for Python 3.6 and 3.7).
libpython shared library.

Python: Installation

Thu, 30 May 2024 00:00:00 +0000

Aspose.OCR for Python via .NET is distributed as a Python Wheel (whl). The package contains all the files necessary for installing and running the library.

Preparing for installation

Before you go any further, make sure you have the supported version of Python and that it is available from the command line. You can check this by running:
Windows
py --version
Unix/macOS
python3 --version
You should get the response like Python <version number>. If you do not have Python, or have an unsupported version, install the latest 3.x version from python.org.
Check that the package installer for Python (pip) is available:
Windows
py -m pip --version
Unix/macOS
python3 -m pip --version
If you installed Python with an installer from python.org or via Homebrew, you should already have pip. If you installed Python using your OS package manager, you may have to install pip separately.
Update pip, setuptools, and wheel to the latest versions:
```
pip install --upgrade pip setuptools wheel
```

Installing the package

The Aspose.OCR for Python via .NET package can either be installed from PyPi or downloaded from releases.aspose.com.

Installing from PyPi

pip is the recommended installer. To install the package, run the following command:

pip install aspose-ocr-python-net

Updating

The update procedure depends on how you originally installed the Aspose.OCR for Python via .NET package.

Refer to Aspose.OCR for Python via .NET Release Notes to check if the update might alter the application behavior or require changes to existing code.

Getting an update from PyPi

To update the main package, run the following command:

pip install --upgrade aspose-ocr-python-net

Updating with downloaded file

Download the new version of Aspose.OCR for Python via .NET package for your platform from releases.aspose.com.
Extract the downloaded archive.
Update the downloaded package by running update.sh or update.cmd depending on your platform, or using pip:
```
pip install --upgrade aspose_ocr_python_net-{version and platform}.whl
```

Python: Licensing

Wed, 05 Jul 2023 00:00:00 +0000

Aspose.OCR for Python via .NET is a commercially licensed product that can be used in trial (evaluation) mode.

Free trial

You can start using Aspose.OCR for Python via .NET right after the installation. In trial mode (without providing a license) you can recognize texts in any supported languages and save recognition results in any of the supported formats.

However, the following restrictions apply:

If the number of characters in a recognized image exceeds 300, only the first 300 characters are recognized.
If the number of characters in a recognized image is less than 300, the first 60% of characters are recognized.

Apply a license to remove the restriction.

Getting a temporary license

A temporary license removes a limitation of the trial version for 30 days. Use it to start building a fully functional OCR application and make the final decision to purchase Aspose.OCR for Python via .NET later.

To request a temporary license, visit “Get a Temporary License” page.

Purchasing a license

Aspose.OCR for Python via .NET is licensed either by the number of developers and locations (sites) where the products will be used (Developer and Site licenses).

Read License Types for details and purchase a license that best suits your needs.

Applying a developer or site license

After purchasing a license or obtaining a temporary license, you will receive a file with .lic extension. If needed, you can rename this file and change its extension.

Do not modify the contents of the license file. Even an extra line break or space will invalidate the license.

The license must be applied once per application or process lifecycle before recognition starts.

# Instantiate the licensing engine
license = ocr.License()
# Load the license from file
license.set_license("Aspose-OCR-Python-via-NET.lic")

If only the name of the license file (without path) is specified, set_license method will look for the license file in the application’s working directory.

Alternatively, you can store the license file in any directory on your computer and specify an absolute path in set_license method.

Licensing multiple Aspose products

Even if you have a single license for all Aspose products, you still need to apply the license separately to each Aspose module you are using in your application.

Python: Hello, world!

Wed, 19 Apr 2023 00:00:00 +0000

In this article, you will learn how to build a bare minimum Python console application for extracting text from an image with Aspose.OCR for Python via .NET.

We assume that you already have a basic knowledge of how to write and run Python scripts.

You will need

A compatible system with Python 3.6 or later installed. It is recommended to use the latest version of Python.
Pip package installer.
Any plain text editor.
Some image containing a text. You can simply download the one from the article.
5 minutes of spare time.

Preparing the environment

Install Aspose.OCR for Python via .NET package using pip.
Create a text file called ocr.py.
Save this image file to the same directory as ocr.py under the name source.png:

Coding

Open ocr.py in whatever code or plain text editor you prefer.

Import aspose.ocr module:
```
import aspose.ocr as ocr
```
Create an instance of Aspose.OCR API:
```
api = AsposeOcr()
```

Add the image to the recognition batch:

input = OcrInput(InputType.SINGLE_IMAGE)
input.add("source.png")

Extract text from the image:
```
result = api.recognize(input)
```
Output the recognized text:
```
print(result[0].recognition_text)
```

Full code:

import aspose.ocr as ocr

# Instantiate Aspose.OCR API
api = AsposeOcr()

# Add image to the recognition batch
input = OcrInput(InputType.SINGLE_IMAGE)
input.add("source.png")

# Recognize the image
result = api.recognize(input)

# Print recognition result
print(result[0].recognition_text)
input("Press Enter to continue...")

Running

Run ocr.py. You will see extracted text in the console output:

Hello, World! I can read this text.
Press Enter to continue...

If you use your own image, consider the trial restrictions.

Python: Get help

Sat, 19 Aug 2023 00:00:00 +0000

Have you encountered a technical issue when implementing the OCR functionality with Aspose.OCR for Python via .NET? Do you want to ask for advice, look for examples, report a problem, or request a new feature?

Aspose team is here to help:

Blog
Learn about new features in Aspose.OCR for Python via .NET, find code examples, read about advanced technical features.
Free Support Forum
Ask for advice, leave feedback, and get help from Aspose professionals and the community.
Paid Support Helpdesk
Do you want your problem solved with the highest priority or need a specific feature to fine-tune the API for your business needs? Reach out our Paid Support Helpdesk.