https://github.com/lsjsj92/upstage-document-parser-playground

Upstage document parser playground(w/ Python streamlit)
https://github.com/lsjsj92/upstage-document-parser-playground

document-parser documentparsing fastapi ocr playground python3 streamlit upstage

Last synced: 6 days ago
JSON representation

Upstage document parser playground(w/ Python streamlit)

• Host: GitHub
• URL: https://github.com/lsjsj92/upstage-document-parser-playground
• Owner: lsjsj92
• License: apache-2.0
• Created: 2025-10-11T11:50:47.000Z (7 months ago)
• Default Branch: main
• Last Pushed: 2025-10-26T10:18:48.000Z (7 months ago)
• Last Synced: 2025-10-27T02:44:34.746Z (7 months ago)
• Topics: document-parser, documentparsing, fastapi, ocr, playground, python3, streamlit, upstage
• Language: Python
• Homepage:
• Size: 3.4 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Upstage Document Parser Playground

Streamlit 기반의 웹 UI로, Upstage Document API의 파싱 결과를 시각적으로 검증하는 테스트 도구입니다.

![](asset/parsing_result.png) | ![](asset/parsing_result_table.png)

---|---

---

## 주요 기능

#### 상세한 설명

- https://lsjsj92.tistory.com/703

![](asset/blog.png)

* **다양한 포맷 지원**: 업스테이지의 document parsing  API를 이용해 PDF, DOCX, PPTX, HWP 등 문서 파싱

* **결과 시각화**: HTML 렌더링, Bounding Box 좌표, Element 상세 정보 확인

---

## 실행 방법

### 1. 사전 준비

* [Upstage Console](https://console.upstage.ai/)에서 **API Key** 발급

* **Python 3.9+** 설치

### 2. 설치 및 설정

```bash

# 1. 프로젝트 복제 및 이동

git clone https://github.com/lsjsj92/upstage-document-parser-playground.git

cd upstage-document-parser-playground

# 2. 필요 라이브러리 설치

pip install -r requirements.txt

# 3. API 키 설정

cp .env.tmp .env

# .env 파일에 발급받은 API 키를 입력하세요.

```

## 서버 실행

1. 터미널 1: 백엔드 실행

- python -m uvicorn backend.main:app --reload

2. 터미널 2: 프론트엔드 실행

- streamlit run frontend/app.py

브라우저에서 http://localhost:8501로 접속하세요.

# 파일 구조

```

.

├── LICENSE

├── README.md

├── asset

│   ├── blog.png

│   ├── parsing_result.png

│   └── parsing_result_table.png

├── backend

│   ├── __init__.py

│   ├── config.py

│   ├── main.py

│   ├── models

│   │   ├── __init__.py

│   │   └── document.py

│   ├── routers

│   │   ├── __init__.py

│   │   └── routes.py

│   ├── services

│   │   ├── __init__.py

│   │   ├── file_processor.py

│   │   ├── storage.py

│   │   └── upstage_client.py

│   └── utils

│       ├── __init__.py

│       └── helpers.py

├── frontend

│   ├── __init__.py

│   ├── app.py

│   ├── components

│   │   ├── __init__.py

│   │   ├── document_viewer.py

│   │   └── file_uploader.py

│   └── utils

│       ├── __init__.py

│       └── config.py

├── requirements.txt

└── storage

    ├── metadata.json  # 파싱 실행 시 생성

    ├── parsed         # 파싱 결과 저장

    └── uploads        # 업로드 파일 저장

```