PHPackages                             hossamsoliuman/laravel-ocr - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. hossamsoliuman/laravel-ocr

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

hossamsoliuman/laravel-ocr
==========================

Optimal character recognition with Laravel

1.0.0(2y ago)08MITPHPPHP ^8.0

Since Sep 20Pushed 2y ago1 watchersCompare

[ Source](https://github.com/HossamSoliuman/laravel-ocr)[ Packagist](https://packagist.org/packages/hossamsoliuman/laravel-ocr)[ RSS](/packages/hossamsoliuman-laravel-ocr/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (2)Versions (2)Used By (0)

Laravel OCR Package
===================

[](#laravel-ocr-package)

[![Packagist Version](https://camo.githubusercontent.com/e8ea9f6beef6b4026e50c7e7011acfacb3f6f6a1781a62e18667f6265717cb19/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f686f7373616d736f6c69756d616e2f6c61726176656c2d6f6372)](https://camo.githubusercontent.com/e8ea9f6beef6b4026e50c7e7011acfacb3f6f6a1781a62e18667f6265717cb19/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f686f7373616d736f6c69756d616e2f6c61726176656c2d6f6372)[![Packagist Downloads](https://camo.githubusercontent.com/d7deee632cc599032808b3fddcf554e11756410728a816ba25e6313f64cbb03f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f686f7373616d736f6c69756d616e2f6c61726176656c2d6f6372)](https://camo.githubusercontent.com/d7deee632cc599032808b3fddcf554e11756410728a816ba25e6313f64cbb03f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f686f7373616d736f6c69756d616e2f6c61726176656c2d6f6372)[![License](https://camo.githubusercontent.com/a947af74c07aaae00fc4e2fa02f70ca8c53a0d8411abe8eb07806fcdfb6442b1/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f686f7373616d736f6c69756d616e2f6c61726176656c2d6f6372)](https://camo.githubusercontent.com/a947af74c07aaae00fc4e2fa02f70ca8c53a0d8411abe8eb07806fcdfb6442b1/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f686f7373616d736f6c69756d616e2f6c61726176656c2d6f6372)

The Laravel OCR package provides optimal character recognition capabilities in Laravel applications. It integrates with Tesseract OCR and offers features such as offline OCR, language selection, and more.

Table of Contents
-----------------

[](#table-of-contents)

- [Package Dependencies](#package-dependencies)
- [Installation](#installation)
    - [Software Installation](#software-installation)
    - [package Installation](#package-installation)
- [Usage](#usage)
    - [Routes and Controllers](#routes-and-controllers)
    - [Available Languages](#available-languages)
    - [User Words](#user-words)
- [Current and Upcoming Features](#current-and-upcoming-features)
- [Contributing](#contributing)
- [License](#license)

Package Dependencies
--------------------

[](#package-dependencies)

This package depends on Tesseract OCR. Before using the Laravel OCR package, you must install Tesseract OCR on your server. You can find installation instructions for various operating systems on the Tesseract OCR Page .

Installation
------------

[](#installation)

### Software Installation

[](#software-installation)

For Windows users, we provide installation guidance in the screenshot. Please clich the  to install Tesseract OCR on your Windows machine.

[![Windows Installation Guide](images/windows-install.png)](images/windows-install.png)

For general users and not windows specifically, you can visit

### Package Installation

[](#package-installation)

To install the Laravel OCR package, you can use Composer:

```
composer require hossamsoliuman/laravel-ocr
```

Usage
=====

[](#usage)

Routes and Controllers
----------------------

[](#routes-and-controllers)

### Routes

[](#routes)

This package provides routes and controllers for OCR processing. You can access the OCR functionality via the following routes:

- **POST /api/offline-ocr/image**: Perform offline OCR on an image.

    - Accepts `image` (image file) and `lang` (language selection) parameters.
    - Optional `user_words` parameter for user-specific words (see User Words).
- **GET /languages**: Retrieve a list of available languages for OCR.

Make sure to include these routes in your Laravel application as needed. You can also customize the routes and controllers to fit your application's requirements.

### Available Languages

[](#available-languages)

You can select the language(s) for OCR processing using the `lang` parameter when making requests. By default, English (`eng`) is used. You can specify multiple languages as a comma-separated list, e.g., `eng,ara`.

To retrieve a list of available languages, you can access the `/languages` route.

### User Words

[](#user-words)

You can provide a user-specific words file to improve OCR accuracy when dealing with technical terminology or jargon. To use user words, include the `user_words` parameter when making OCR requests, and provide a text file containing the desired words.

**Example usage**:

```
curl -X POST -F "image=@image.png" -F "user_words=@user-words.txt" http://your-app.com/offline-ocr/image
```

Current and Upcoming Features
-----------------------------

[](#current-and-upcoming-features)

Here's a table detailing the current and upcoming features of the Laravel OCR package:

FeatureStatusOffline OCR✅ AvailableLanguage Selection✅ AvailableUser Words✅ AvailableDownload Language Support⏳ UpcomingPDF Support⏳ UpcomingGoogle vision Support⏳ UpcomingMore Features⏳ UpcomingContributing
------------

[](#contributing)

Contributions are welcome! We appreciate your interest in improving this package. To get started with contributing, please read our [contribution guidelines](CONTRIBUTING.md). Your contributions can help make this package even better.

License
-------

[](#license)

This package is open-source software licensed under the [MIT License](LICENSE). You are free to use, modify, and distribute this software in accordance with the terms of the MIT License. See the [LICENSE](LICENSE) file for more details.

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

972d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4d02306e4e2cf91595532978e15ac518e294198c3e49371c9250733e1b52a99c?d=identicon)[HossamSoliuman](/maintainers/HossamSoliuman)

---

Top Contributors

[![HossamSoliuman](https://avatars.githubusercontent.com/u/93101329?v=4)](https://github.com/HossamSoliuman "HossamSoliuman (4 commits)")

### Embed Badge

![Health badge](/badges/hossamsoliuman-laravel-ocr/health.svg)

```
[![Health](https://phpackages.com/badges/hossamsoliuman-laravel-ocr/health.svg)](https://phpackages.com/packages/hossamsoliuman-laravel-ocr)
```

###  Alternatives

[wireui/wireui

TallStack components

1.8k1.3M16](/packages/wireui-wireui)[livewire/volt

An elegantly crafted functional API for Laravel Livewire.

4195.3M84](/packages/livewire-volt)[ramonrietdijk/livewire-tables

Dynamic tables for models with Laravel Livewire

21147.4k](/packages/ramonrietdijk-livewire-tables)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
