GitLocker: The Coding Marketplace

Description:

macocrcli 0.2.9

Mac-OCR-CLI

MAC-OCR-CLI is a powerful command-line interface tool for Optical Character Recognition (OCR) on macOS.
It leverages FastAPI, ocrmac, and Typer to provide a seamless OCR experience directly from your terminal or through a local API server.
Features

Easy-to-use CLI for starting an OCR server
RESTful API endpoint for OCR tasks
Built on FastAPI for high performance
Utilizes ocrmac for accurate OCR on macOS
Supports base64 encoded image input
Intelligent text merging by line
Beautiful console output using Rich library
Customizable server settings (port, host, log level)

Requirements

Python 3.6+
macOS (due to ocrmac dependency)
pip (Python package installer)

Installation

Ensure you have Python 3.6+ installed on your macOS system.

Install MAC-OCR-CLI using pip:
pip install mac-ocr-cli

Usage
Starting the OCR CLI

mac-ocr file <your_image_path>

Starting the OCR Server
To start the OCR server with default settings:
mac-ocr server

You can customize the server settings using command-line options:
mac-ocr server --port 8080 --host 127.0.0.1 --log-level debug

Available options:

--port or -p: Set the server port (default: 8000)
--host or -h: Set the server host (default: 0.0.0.0)
--log-level or -l: Set the log level (default: info)
--token or -t: Set the token (default: None)

Performing OCR
Once the server is running, you can perform OCR on an image using a POST request to the /ocr endpoint:
curl --location 'http://127.0.0.1:8080/ocr' \
--header 'Authorization: 123456' \
--header 'Content-Type: application/json' \
--data '{
"image_path":"<your_image_path>"
}'

Replace your_image_path with your actual image path.
curl --location 'http://127.0.0.1:8080/ocr' \
--header 'Authorization: 123456' \
--header 'Content-Type: application/json' \
--data '{
"image_base64":"<base64_encoded_image_data>"
}'

Replace <base64_encoded_image_data> with your actual base64-encoded image data.
The server will respond with the OCR results in JSON format:
{
"code": 200,
"message": "success",
"data": {
"annotations": [
[
"INTP女",
1.0,
[
0.15561960485546392,
0.8036144575052732,
0.6772334149494265,
0.1295751962317041
]
],
[
"为什么罕见",
1.0,
[
0.08933718939980283,
0.6463855410040755,
0.8213256246225845,
0.11870066631271181
]
]
],
"fullText": [
"INTP女",
"为什么罕见"
]
}
}

Note: The OCR results are returned in reverse order (bottom to top) of the original image.
Contributing
Contributions to MAC-OCR-CLI are welcome! Please follow these steps to contribute:

Fork the repository
Create a new branch for your feature or bug fix
Make your changes and commit them with clear, descriptive messages
Push your changes to your fork
Submit a pull request to the main repository

Please ensure your code adheres to the project's coding standards and include tests for new features.
License
This project is licensed under the MIT License. See the LICENSE file for details.