https://github.com/otiai10/ocrserver

A simple OCR API server, seriously easy to be deployed by Docker, on Heroku as well
https://github.com/otiai10/ocrserver

api api-server curl docker go heroku ocr ocr-server

Last synced: 21 days ago
JSON representation

A simple OCR API server, seriously easy to be deployed by Docker, on Heroku as well

• Host: GitHub
• URL: https://github.com/otiai10/ocrserver
• Owner: otiai10
• License: mit
• Created: 2015-11-15T07:57:42.000Z (almost 9 years ago)
• Default Branch: main
• Last Pushed: 2021-08-05T08:20:24.000Z (about 3 years ago)
• Last Synced: 2024-09-30T02:40:58.247Z (about 1 month ago)
• Topics: api, api-server, curl, docker, go, heroku, ocr, ocr-server
• Language: Go
• Homepage: https://ocr-example.herokuapp.com/
• Size: 341 KB
• Stars: 689
• Watchers: 17
• Forks: 137
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome-go - ocrserver - A simple OCR API server, seriously easy to be deployed by Docker and Heroku. (Machine Learning / Search and Analytic Databases)
• zero-alloc-awesome-go - ocrserver - A simple OCR API server, seriously easy to be deployed by Docker and Heroku. (Machine Learning / Search and Analytic Databases)
• awesome-go-extra - ocrserver - 11-15T07:57:42Z|2021-08-05T08:20:24Z| (Machine Learning / Advanced Console UIs)
• awesome-ocr - The minimum OCR server by Golang The minimum OCR server by Golang, and a tiny sample application of gosseract.

README

        
# ocrserver

[![Go CI](https://github.com/otiai10/ocrserver/workflows/Go%20CI/badge.svg)](https://github.com/otiai10/ocrserver/actions?query=workflow%3A%22Go+CI%22)

[![codecov](https://codecov.io/gh/otiai10/ocrserver/branch/main/graph/badge.svg)](https://codecov.io/gh/otiai10/ocrserver)

[![Go Report Card](https://goreportcard.com/badge/github.com/otiai10/ocrserver)](https://goreportcard.com/report/github.com/otiai10/ocrserver)

Simple OCR server, as a small working sample for [gosseract](https://github.com/otiai10/gosseract).

Try now here https://ocr-example.herokuapp.com/, and deploy your own now.

[![](https://user-images.githubusercontent.com/931554/36279290-7134626a-124b-11e8-8e47-d93b7122ea0d.png)](https://ocr-example.herokuapp.com)

# Deploy to Heroku

```sh

# Get the code

% git clone [email protected]:otiai10/ocrserver.git

% cd ocrserver

# Make your app

% heroku login

% heroku create

# Deploy the container

% heroku container:login

% heroku container:push web

# Enjoy it!

% heroku open

```

cf. [heroku cli](https://devcenter.heroku.com/articles/heroku-cli#download-and-install)

# Quick Start

## Ready-Made Docker Image

```sh

% docker run -p 8080:8080 otiai10/ocrserver

# open http://localhost:8080

```

cf. [docker](https://www.docker.com/products/docker-toolbox)

## Development with Docker Image

```sh

% docker-compose up

# open http://localhost:8080

```

You need more languages?

```sh

% docker-compose build --build-arg LOAD_LANG=rus

% docker-compose up

```

cf. [docker-compose](https://www.docker.com/products/docker-toolbox)

## Manual Setup

If you have tesseract-ocr  and library files on your machine

```sh

% go get github.com/otiai10/ocrserver/...

% PORT=8080 ocrserver

# open http://localhost:8080

```

cf. [gosseract](https://github.com/otiai10/gosseract)

# Documents

- [API Endpoints](https://github.com/otiai10/ocrserver/wiki/API-Endpoints)