{"id":23872143,"url":"https://github.com/xiaoyao9184/docker-easyocr","last_synced_at":"2026-05-16T04:50:53.591Z","repository":{"id":263099352,"uuid":"889040407","full_name":"xiaoyao9184/docker-easyocr","owner":"xiaoyao9184","description":"Docker implementation of the EasyOCR","archived":false,"fork":false,"pushed_at":"2024-12-25T12:52:25.000Z","size":17,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-03T15:38:50.586Z","etag":null,"topics":["cuda-support","docker-image","easyocr","ocr"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xiaoyao9184.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-15T13:50:16.000Z","updated_at":"2024-12-25T12:52:28.000Z","dependencies_parsed_at":null,"dependency_job_id":"b8c37d9f-b7d5-4ee1-aa82-9d300d7e03dd","html_url":"https://github.com/xiaoyao9184/docker-easyocr","commit_stats":null,"previous_names":["xiaoyao9184/docker-easyocr"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xiaoyao9184%2Fdocker-easyocr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xiaoyao9184%2Fdocker-easyocr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xiaoyao9184%2Fdocker-easyocr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xiaoyao9184%2Fdocker-easyocr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xiaoyao9184","download_url":"https://codeload.github.com/xiaoyao9184/docker-easyocr/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240223956,"owners_count":19767674,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cuda-support","docker-image","easyocr","ocr"],"created_at":"2025-01-03T15:30:27.598Z","updated_at":"2026-05-16T04:50:48.542Z","avatar_url":"https://github.com/xiaoyao9184.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Docker EasyOCR\n\nA Docker image built through GitHub Actions with Git commit version tags.\n\n## Why\n\nI discovered that EasyOCR provides a Dockerfile but does not offer a prebuilt Docker image for running demos.\nAdditionally, its models are hosted on GitHub Releases and downloaded at runtime, which makes offline mode challenging.\nHosting the models on HuggingFace Hub would enable local caching and leverage HuggingFace's self-hosted mirror for efficient downloads.\n\nAfter reviewing the following resources:\n\n- [tomofi/EasyOCR](https://huggingface.co/spaces/tomofi/EasyOCR)\n- [felflare/EasyOCR-weights](https://huggingface.co/felflare/EasyOCR-weights/tree/main)\n- [jhgmods/easyocr-models](https://huggingface.co/jhgmods/easyocr-models/tree/main)\n\nThis project uses GitHub Actions, Docker Hub, and HuggingFace Hub to build and publish Docker images and host models.\nThe goal is to maintain a clean and automated process without requiring custom configuration files.\n\n## Tags\n\nDocker images for this project are published on Docker Hub under the repository [xiaoyao9184/easyocr](https://hub.docker.com/r/xiaoyao9184/easyocr).\n\nThe dependent models are hosted on HuggingFace Hub at [xiaoyao9184/easyocr](https://huggingface.co/xiaoyao9184/easyocr).\n\nSince this project references the EasyOCR project via a Git submodule,\nit cannot monitor push events in the EasyOCR repository and therefore cannot automatically create images for every commit.\nA practical workaround is to manually trigger the GitHub Action and tag the image with the commit ID.\nFor more details, see this article: [Set Dynamic Parameters in GitHub Workflows](https://damienaicheh.github.io/github/actions/2022/01/20/set-dynamic-parameters-github-workflows-en.html).\n\nThe default image naming format is `${DOCKERHUB_USERNAME}/easyocr`.\n\n### Tagging Strategy\n\n1. **Commit-Based Tagging**\n   The tag uses the input parameter `commit_id`, which can be either a branch name or a commit ID.\n   - When the [docker-image-tag-commit](./.github/workflows/docker-image-tag-commit.yml) job is manually triggered, you can specify the `commit_id`.\n   - If the job is triggered by a submodule update push, the default branch name `master` will be used instead of the `commit_id`.\n   - This job also generates a tag with the shortened commit ID.\n\n2. **Version-Based Tagging**\n   If the [docker-image-tag-version](./.github/workflows/docker-image-tag-version.yml) job is triggered with the `easyocr_version` parameter (set to a PyPI EasyOCR version),\n   the build will use the EasyOCR package published on PyPI.\n   The resulting image will be tagged with the `easyocr_version`.\n\nCurrently, only the `linux/amd64` platform is supported.\n\n## Changes\n\nYou can fork this project and build your own Docker image. To do so, you need to provide the following variables:\n- `DOCKERHUB_USERNAME`\n- `DOCKERHUB_TOKEN`\n\nFor more details, see [this guide](https://github.com/docker/login-action#docker-hub).\n\nAdditionally, you need to provide your own HuggingFace account for storing the models. The required variables are:\n- `HF_USERNAME`\n- `HF_TOKEN`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxiaoyao9184%2Fdocker-easyocr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxiaoyao9184%2Fdocker-easyocr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxiaoyao9184%2Fdocker-easyocr/lists"}