Documentation – Getting started

Python-Java: System requirements

Thu, 14 Dec 2023 00:00:00 +0000

Aspose.OCR for Python via Java works under Python version 3.8 or later. In addition, it requires the Java Runtime Environment (JRE) version 8 or later.

The library is cross-platform - you can run your code unchanged on any of the following 64-bit operating systems:

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 10.14 (Mojave) or later, x64

MacOS ARM (Apple Silicon) platform is fully supported.

Linux

Any Linux x64, including:

Ubuntu
OpenSUSE
CentOS

Python-Java: External dependencies

Thu, 14 Dec 2023 00:00:00 +0000

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

GNU Compiler Collection (GCC) runtime, version 6 or later.
libpython shared library.
JPype1 version 1.4.1

Python-Java: Installation

Thu, 14 Dec 2023 00:00:00 +0000

Aspose.OCR for Python via Java 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 Java 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-java

Installing from downloaded package

Download Aspose.OCR for Python via Java package for your platform from releases.aspose.com.
Extract the downloaded archive.
Install the downloaded package by running install.sh or install.cmd depending on your platform, or using pip:
```
pip install aspose_ocr_python_java-{version and platform}.whl
```

Updating

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

Refer to Aspose.OCR for Python via Java 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-java

Updating with downloaded file

Download the new version of Aspose.OCR for Python via Java 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_java-{version and platform}.whl
```

Python-Java: Licensing

Thu, 14 Dec 2023 00:00:00 +0000

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

Free trial

You can start using Aspose.OCR for Python via Java 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 Java later.

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

Purchasing a license

Aspose.OCR for Python via Java is licensed 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.

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

If only the name of the license file (without path) is specified, set_license() method will look for the license file in the script’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 several Aspose products, you still need to apply the license separately to each Aspose module you are using in your script.

Python-Java: Get help

Thu, 14 Dec 2023 00:00:00 +0000

Have you encountered a technical issue when implementing the OCR functionality with Aspose.OCR for Python via Java? 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 Java, 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.