Repolode
CatchTheTornado

CatchTheTornado/text-extract-api

PDF, 이미지, Office 문서를 Markdown 또는 구조화된 JSON으로 변환하는 셀프 호스팅 FastAPI 서비스

대체할 수 있는 제품:Adobe AcrobatABBYY FineReader

스타
3,184
포크
279
열린 이슈
49
마지막 커밋
10개월 전

어떤 프로젝트인가요?

text-extract-api는 이미지, PDF, Office 파일을 Markdown 텍스트나 구조화된 JSON으로 변환하는 문서 추출 서비스입니다. FastAPI를 기반으로 비동기 작업 처리는 Celery로, OCR 결과 캐싱은 Redis로 수행합니다. EasyOCR, MiniCPM-V, Ollama를 통해 실행하는 Llama 3.2 Vision, 외부 marker-pdf 서버를 호출하는 원격 전략 등 여러 OCR 방식을 지원합니다.

파이프라인은 OCR 결과를 사용자 지정 프롬프트와 함께 Ollama에서 실행되는 LLM에 전달할 수 있습니다. 예를 들어 JSON을 생성하거나 송장과 보고서에서 개인 식별 정보를 제거할 수 있습니다. 결과는 로컬 파일 시스템, Google Drive, Amazon S3 같은 플러그형 스토리지 프로필을 통해 저장할 수 있습니다. CPU 및 GPU 환경용 Docker Compose 파일과 CLI, TypeScript 클라이언트도 제공됩니다.

이 프로젝트는 파일을 외부 클라우드 서비스에 보내지 않고 문서를 처리해야 하는 팀을 대상으로 합니다. 데이터는 스택을 실행하는 컴퓨터나 서버에 남지만, 원격 marker 전략과 클라우드 스토리지 백엔드를 사용하면 설정한 엔드포인트로 데이터가 전송됩니다.

핵심 기능

  • 01이미지, PDF, Office 문서를 Markdown 또는 JSON으로 변환합니다.
  • 02EasyOCR, MiniCPM-V, Llama 3.2 Vision, 원격 marker-pdf OCR 전략을 제공합니다.
  • 03Ollama에서 실행되는 모델로 OCR 텍스트를 후처리하고 구조화된 데이터를 추출합니다.
  • 04프롬프트를 사용해 개인 식별 정보를 제거합니다.
  • 05Celery로 작업을 비동기 처리하고 Redis에 OCR 결과를 캐싱합니다.
  • 06스토리지 프로필을 통해 결과를 로컬 디스크, Google Drive 또는 Amazon S3에 저장합니다.

활용 사례

  • 스캔한 송장이나 보고서를 후속 시스템에서 사용할 구조화된 JSON으로 변환합니다.
  • 문서를 공유하거나 보관하기 전에 개인정보를 삭제합니다.
  • 파일을 네트워크 밖으로 내보낼 수 없는 환경에서 온프레미스로 문서 OCR을 실행합니다.
  • 문서 수집 API를 구축해 텍스트를 RAG 또는 검색 파이프라인에 전달합니다.

빠른 시작

  1. 1

    저장소를 클론합니다

    git clone https://github.com/CatchTheTornado/text-extract-api.git
  2. 2

    프로젝트 디렉터리로 이동합니다

    cd text-extract-api
  3. 3

    Docker Compose로 모든 서비스를 시작합니다

    docker-compose up --build

사용 전 알아둘 점

  • 로컬 OCR 모델과 Ollama LLM을 실행하려면 상당한 성능의 하드웨어가 필요합니다. 또한 llama_vision 전략은 90B 파라미터를 사용하므로 매우 느립니다.
  • marker-pdf 원격 전략은 GPL3 라이선스를 따르며 번들에 포함되어 있지 않습니다. 또한 모델 가중치에는 비상업적 용도 제한이 있습니다.

토픽

자주 묻는 질문

text-extract-api은(는) 무엇인가요?
PDF, 이미지, Office 문서를 Markdown 또는 구조화된 JSON으로 변환하는 셀프 호스팅 FastAPI 서비스 text-extract-api는 이미지, PDF, Office 파일을 Markdown 텍스트나 구조화된 JSON으로 변환하는 문서 추출 서비스입니다. FastAPI를 기반으로 비동기 작업 처리는 Celery로, OCR 결과 캐싱은 Redis로 수행합니다. EasyOCR, MiniCPM-V, Ollama를 통해 실행하는 Llama 3.2 Vision, 외부 marker-pdf 서버를 호출하는 원격 전략 등 여러 OCR 방식을 지원합니다.
text-extract-api은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
text-extract-api은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
text-extract-api은(는) 아직 유지보수되고 있나요?
6개월 이상 커밋 없음. text-extract-api의 마지막 커밋은 2025년 12월 8일입니다.
text-extract-api은(는) 어디에 사용할 수 있나요?
스캔한 송장이나 보고서를 후속 시스템에서 사용할 구조화된 JSON으로 변환합니다. 문서를 공유하거나 보관하기 전에 개인정보를 삭제합니다. 파일을 네트워크 밖으로 내보낼 수 없는 환경에서 온프레미스로 문서 OCR을 실행합니다. 문서 수집 API를 구축해 텍스트를 RAG 또는 검색 파이프라인에 전달합니다.
text-extract-api는 어떻게 설치하나요?
저장소를 클론합니다: git clone https://github.com/CatchTheTornado/text-extract-api.git 프로젝트 디렉터리로 이동합니다: cd text-extract-api Docker Compose로 모든 서비스를 시작합니다: docker-compose up --build
text-extract-api은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/CatchTheTornado/text-extract-api

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트