This package is a browser and mobile-friendly SDK which provides typescript programmatic APIs to perform OCR (Optical Character Recognition).
NOTE: This SDK is not yet published to npm. It must be cloned and built locally until it is published.
The initial use case supports OCR of bank checks in order to return the routing, account, and check number fields; however, it is designed to support other use cases in the future.
The following is a sample code snippet demonstrating how to use this SDK to OCR a bank check.
import * as ocr from "@finos/fin-ocr-sdk";
import * as fs from 'fs';
// Scan a check image contained in 'file' of TIFF format
async function scanCheck(file: string) {
// Initialize the check manager, allowing
// configuration via environment variables.
const checkMgr = await ocr.CheckMgr.getInstanceByEnv(process.env);
// Read from a file and scan the image.
// This is called once per check.
const b64 = fs.readFileSync(file).toString("base64");
const result = await checkMgr.scan({
id: "1",
image: {
format: "tiff",
buffer: b64
}
});
console.log(JSON.stringify(result,null,4));
// When done scanning all checks, stop the check manager
await checkMgr.stop();
}
The following environment variables may be used to configure the SDK.
| Name | Default | Description |
|---|---|---|
| OCR_LOG_LEVEL | "info" | The log level which is any of the following: "fatal", "error", "warn", "info", "debug", "trace", or "verbose". |
| OCR_SLOW_REQUEST_MS | 0 | If greater than 0, enable slow request detection. If a request takes longer than this many milliseconds, a warning message is logged at level OCR_SLOW_OR_HUNG_REQUEST_LOG_LEVEL when the request completes. |
| OCR_HUNG_REQUEST_MS | 0 | If greater than 0, enable hung request detection. If a request takes longer than this many milliseconds, a warning message is logged at level OCR_SLOW_OR_HUNG_REQUEST_LOG_LEVEL, even if the request has not completed. |
| OCR_SLOW_OR_HUNG_REQUEST_LOG_LEVEL | "debug" | The log level for slow or hung requests. The value may be any of the following: "fatal", "error", "warn", "info", "debug", "trace", or "verbose". |
| OCR_OVERLAP_CORRECTION | true | Set to false to disable OCR overlap correction. |
The src/config.ts file contains a complete list of configuration variables. Each variable is configuable programatically or via an environment variable.
This SDK is designed to be browser and mobile friendly.
It uses the following open source projects:
-
opencv.jsto perform various image pre-processing operations such as locating special symbols on an image, cropping and cleaning an image, etc; -
tesseract.jsto translate text on a (preferably clean) image.
Copyright 2024 Capital One
Distributed under the Apache License, Version 2.0.
SPDX-License-Identifier: Apache-2.0