{"id":19297136,"url":"https://github.com/tshenolo/image-to-text-converter","last_synced_at":"2026-02-28T06:26:09.825Z","repository":{"id":261360803,"uuid":"883792478","full_name":"tshenolo/image-to-text-converter","owner":"tshenolo","description":"A self hostable Flask application that allows users to upload an image and extract text from it using Optical Character Recognition (OCR) via pytesseract","archived":false,"fork":false,"pushed_at":"2024-11-06T05:16:41.000Z","size":85,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-09T13:05:31.138Z","etag":null,"topics":["flask","pillow","pytesseract","python","self-hosted","tools"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tshenolo.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-05T15:24:02.000Z","updated_at":"2025-01-01T06:11:36.000Z","dependencies_parsed_at":"2024-11-06T06:23:54.692Z","dependency_job_id":"8227436f-cca8-488e-8bc9-7fddb1c3af7d","html_url":"https://github.com/tshenolo/image-to-text-converter","commit_stats":null,"previous_names":["tshenolo/image-to-text-converter"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tshenolo/image-to-text-converter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tshenolo%2Fimage-to-text-converter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tshenolo%2Fimage-to-text-converter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tshenolo%2Fimage-to-text-converter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tshenolo%2Fimage-to-text-converter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tshenolo","download_url":"https://codeload.github.com/tshenolo/image-to-text-converter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tshenolo%2Fimage-to-text-converter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29926363,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-27T19:37:42.220Z","status":"online","status_checked_at":"2026-02-28T02:00:07.010Z","response_time":90,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["flask","pillow","pytesseract","python","self-hosted","tools"],"created_at":"2024-11-09T23:01:11.903Z","updated_at":"2026-02-28T06:26:09.808Z","avatar_url":"https://github.com/tshenolo.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀Image to Text Converter\nThis is a self hostable Flask application that allows users to upload an image and extract text from it using Optical Character Recognition (OCR) via pytesseract. The extracted text is then displayed in a textarea on the page.\n\n![screenshot](screenshot.png)\n\n## Features\n- Upload an image file (e.g., PNG, JPEG).\n- Automatically extract text from the uploaded image using OCR.\n- Display the extracted text in a textarea.\n\n## Technologies Used\n- Flask: A lightweight WSGI web application framework.\n- Pillow: A Python Imaging Library (PIL) fork to handle image files.\n- pytesseract: Python wrapper for Tesseract OCR to perform the text extraction.\n\n## Getting Started\n### Prerequisites\n1. Python (3.x recommended)\n\n2. Tesseract OCR: Install Tesseract OCR engine:\n- For Ubuntu: sudo apt install tesseract-ocr\n- For Windows: [Download Tesseract OCR](https://github.com/UB-Mannheim/tesseract/wiki)\n\n\n## Installation\n1. Clone the repository:\n```bash\ngit clone https://github.com/tshenolo/image-to-text-converter.git\ncd image-to-text-converter\n```\n\n2. Create a virtual environment:\n```bash\npython3 -m venv venv\n```\n\n3. Activate the virtual environment:\n- On Windows:\n```bash\nvenv\\Scripts\\activate\n```\n\n- On macOS/Linux:\n```bash\nsource venv/bin/activate\n```\n\n4. Install the required Python packages:\n```bash\npip install -r requirements.txt\n```\n\n5. Run the Flask app:\n```bash\npython app.py\n```\n\n6. Access the application: Open a web browser and go to http://127.0.0.1:5000 to use the Image to Text Converter.\n\n## Deactivating the Virtual Environment\nWhen you're finished, you can deactivate the virtual environment with:\n```bash\ndeactivate\n```\n\n\n## Dockerizing the Application\nYou can use Docker to containerize the application, making it easy to deploy and run consistently across different environments.\n\n### Building and Running the Docker Container\n\n1. Build the Docker image:\n```bash\ndocker build -t image-to-text-converter .\n```\n\n2. Run the Docker container:\n```bash\ndocker run -d -p 5000:5000 --name image-to-text-converter image-to-text-converter\n```\n\n3. Open a web browser and go to http://localhost:5000 to access the app.\n\n## Suggested Folder Structure\n```\nimage-to-text-converter/\n│\n├── app.py                   # Main Flask application\n├── README.md                # Project documentation\n├── Dockerfile               # Docker configuration file\n├── requirements.txt         # Project dependencies\n├── uploads/                 # Folder to temporarily store uploaded images\n│\n└── templates/\n    └── index.html           # HTML template for the main page\n```\n\n## Usage\n1. Go to the main page of the app.\n2. Upload an image using the file input.\n3. Click the \"Convert to Text\" button.\n4. The extracted text will be displayed in the textarea below.\n\n## Troubleshooting\n### Tesseract Not Found\nIf you receive an error related to Tesseract, ensure that it is installed and accessible in your system's PATH.\n\nFor Windows users, you may need to specify the Tesseract executable path in app.py:\n```bash\npytesseract.pytesseract.tesseract_cmd = r'C:\\Program Files\\Tesseract-OCR\\tesseract.exe'\n```\n\n## Contribute\nIf you want to contribute to this project, follow these steps:\n\n- Fork the repository.  \n- Create a new branch for your feature or bugfix.  \n- Make your changes and commit them.  \n- Push your changes to your fork.  \n- Open a pull request.  \n\n## License\nThis project is open source and available under the MIT License.\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftshenolo%2Fimage-to-text-converter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftshenolo%2Fimage-to-text-converter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftshenolo%2Fimage-to-text-converter/lists"}