Skip to content
/ Docr Public

🛠️ Component design with module-based functionality, allowing for on-demand feature acquisition,🚀 easy to expand, and flexible to use, just like playing with building blocks! | 🛠️ 组件化设计,让功能模块化,实现按需获取,🚀 易于扩展,使用起来灵活方便,就像搭积木一样简单!

License

Notifications You must be signed in to change notification settings

yjmm10/Docr

Repository files navigation

English | 中文 | 日语

Docr 🚀

1. Overview 🌟

🛠️ Component design with module-based functionality, allowing for on-demand feature acquisition, 🚀 easy to expand, and flexible to use, just like playing with building blocks!

Docr is a modular component-based toolkit for document analysis and processing. It's designed with flexibility and extensibility in mind, making it easy to expand and use various document processing functionalities as needed.

2. Features 🛠️

  • 📄 Layout Analysis
  • 🔢 Formula Detection and Recognition
  • 📝 Optical Character Recognition (OCR)
  • 📊 Table Structure Recognition
  • 📚 Reading Order Analysis
  • 🖼️ Image Processing Utilities

3. Installation and Usage 📦

3.1 Prerequisites

  • Python 3.10 or higher
  • Poetry (for dependency management)

3.2 Setup

  1. Clone the repository:

    git clone https://github.com/yjmm10/docr.git
    cd docr
    git clone https://huggingface.co/liferecords/Telos.git docr/models
  2. Install dependencies:

    poetry install -v

3.3 Usage

Here's a quick example of how to use Docr for OCR:

from docr import OCR
import cv2

# Initialize the OCR model
ocr_model = OCR()

# Read an image
image = cv2.imread("path/to/your/image.png")

# Perform OCR
result = ocr_model(image)

print(result)

Docr comes with a Streamlit-based web UI for easy demonstration of its capabilities:

  1. Run the demo:

    streamlit run webui/demo.py
  2. Open your browser and navigate to the provided URL (usually http://localhost:8501)

  3. Upload an image and select the model you want to use for processing

Docr also provides a FastAPI-based API service for integration into other applications:

  1. Start the API server:

    uvicorn api.docr_api:app --host 0.0.0.0 --port 8000
  2. The API documentation will be available at http://localhost:8000/docs

4. Development 🔬

For detailed information on development, please refer to the development guide. This guide will help you set up your IDE for working with Docr, including SRC Layout configuration.

5. Contributing 🤝

We welcome contributions! Please see our Contributing Guidelines for more details.

6. License 📄

Docr is released under the MIT License. See the LICENSE file for more details.

7. Contact 📧

For any questions or feedback, please contact the project maintainer: liferecords yjmm10@yeah.net

About

🛠️ Component design with module-based functionality, allowing for on-demand feature acquisition,🚀 easy to expand, and flexible to use, just like playing with building blocks! | 🛠️ 组件化设计,让功能模块化,实现按需获取,🚀 易于扩展,使用起来灵活方便,就像搭积木一样简单!

Resources

License

Stars

Watchers

Forks

Packages

No packages published