---
title: Translation Demo
emoji: 🌐
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 5.42.0
app_file: app.py
pinned: false
---

# 조선일보 번역 데모

한국어 기사를 영어로 번역하는 데모 애플리케이션입니다.

## 기능

1. **단어장 기반 용어 통일**: 한국어 텍스트에서 공식 영문명으로 용어를 통일합니다.
2. **전문 기사 본문 번역**: Solar Pro2 모델을 사용하여 전문적인 번역을 수행합니다.
3. **영문 제목 생성**: 번역된 본문과 한국어 제목을 바탕으로 영문 제목을 자동 생성합니다.

## 사용법

### 설치

1. 필요한 패키지 설치:

```bash
pip install gradio openai python-dotenv pandas
```

2. 환경 변수 설정:
   `.env` 파일을 생성하고 다음 내용을 추가:

```
OPENAI_API_KEY=your_upstage_api_key_here
```

### 실행

```bash
python app.py
```

브라우저에서 `http://localhost:7860`으로 접속하여 사용할 수 있습니다.

### 사용 방법

1. **한국어 입력**:

   - 왼쪽 패널에 한국어 제목과 본문을 입력합니다.

2. **번역 실행**:

   - "번역하기" 버튼을 클릭합니다.

3. **결과 확인**:
   - 오른쪽 패널에서 영어 번역 결과를 확인합니다.

## 처리 과정

1. **단어장 적용**: 한국어 텍스트의 고유명사나 기관명을 공식 영문명으로 치환
2. **본문 번역**: 전문 번역 프롬프트를 사용하여 본문을 영어로 번역 (벌크 분할 없음)
3. **제목 생성**: 번역된 본문과 한국어 제목을 바탕으로 영문 제목과 부제목 생성

### 제목 생성 세부사항

- **입력**: 번역된 본문(`ENG_CONTENT`), 의견 여부(`OPINION: Y`), 한국어 제목(`TITLE_KOR`)
- **출력**: JSON 형식으로 영문 제목(`eng_title`)과 부제목(`eng_subtitle`) 생성
- **표시**: 제목과 부제목을 구분하여 명확하게 표시

## 파일 구조

- `app.py`: 메인 애플리케이션 파일 (Gradio 인터페이스)
- `prompts.py`: 번역 및 제목 생성용 프롬프트 정의
- `vocabulary.csv`: 한영 용어 대조표 (단어장)
- `.env`: API 키 설정 파일 (사용자가 생성)

## 단어장 형식

`vocabulary.csv` 파일의 형식:

- `한글명`: 한국어 용어 (이 용어가 본문에 나오면 `영문명`으로 치환)
- `약칭`: 한국어 약칭 (이 용어가 본문에 나오면 `영어약칭`으로 치환)
- `영문명`: 영문 용어 (한글명의 대체 텍스트)
- `영어약칭`: 영어 약칭 (약칭의 대체 텍스트)

**치환 규칙:**

- `한글명` → `영문명`으로 치환
- `약칭` → `영어약칭`으로 치환
- 긴 용어부터 우선 치환하여 부분 매칭 오류 방지

## 주의사항

- Upstage Solar Pro2 API 키가 필요합니다.
- 인터넷 연결이 필요합니다.
- 번역 품질은 입력 텍스트의 품질과 API 모델 성능에 따라 달라질 수 있습니다.