text-generator / README.md
mimic12's picture
Update README.md
762064a verified
|
raw
history blame
2.58 kB
metadata
title: Text Generator
emoji: 🌖
colorFrom: red
colorTo: green
sdk: gradio
sdk_version: 5.35.0
app_file: app.py
pinned: false
license: mit
short_description: 강좌 실습용

🇰🇷↔️🇬🇧 Gradio 기반 한국어-영어 번역기

Hugging Face의 최신 오픈소스 모델을 활용하여 만든 간단하고 강력한 한국어-영어 양방향 번역기입니다. Gradio를 사용하여 누구나 쉽게 사용할 수 있는 웹 UI를 제공하며, Google Colab 환경에서 손쉽게 실행할 수 있도록 설계되었습니다.

✨ 주요 기능

양방향 번역: 한국어 → 영어, 영어 → 한국어 번역을 모두 지원합니다.

고성능 모델 사용: NHN DQ에서 NLLB 모델을 미세 조정한 최신 모델을 사용하여 번역 품질이 우수합니다.

직관적인 UI: Gradio 기반의 웹 인터페이스를 통해 코드를 모르는 사용자도 쉽게 이용할 수 있습니다.

간편한 실행: Google Colab 노트북이나 로컬 환경에서 몇 줄의 코드만으로 바로 실행 가능합니다.

⚙️ 사용된 모델

이 프로젝트는 NHN DQ(Data & Quality) 팀에서 Meta AI의 NLLB 모델을 한국어 번역에 맞게 미세 조정한 모델을 기반으로 합니다.

한국어 → 영어: NHNDQ/nllb-finetuned-ko2en

영어 → 한국어: NHNDQ/nllb-finetuned-en2ko

🚀 시작하기

사전 준비 프로젝트를 실행하기 위해 다음 라이브러리가 필요합니다.

transformers sentencepiece accelerate gradio torch

실행 방법

1. Google Colab 에서 실행 (권장)

app.py 파일의 전체 코드를 복사합니다.

Google Colab (colab.research.google.com)에서 새 노트를 엽니다.

코드 셀에 복사한 코드를 붙여넣고 실행(▶️)합니다.

실행 완료 후 나타나는 공개 URL 링크를 클릭하여 번역기를 사용합니다.

2. 로컬 환경에서 실행

이 저장소를 클론하거나 app.py 파일을 다운로드합니다.

터미널에서 다음 명령어로 필요한 라이브러리를 설치합니다.

Bash

pip install transformers sentencepiece accelerate gradio torch 다음 명령어로 파이썬 스크립트를 실행합니다.

Bash

python app.py

터미널에 출력되는 로컬 URL(예: http://127.0.0.1:7860)을 웹 브라우저에서 엽니다.

🛠️ 주요 기술

Python

Hugging Face Transformers: 최신 AI 모델을 쉽게 사용할 수 있도록 돕는 라이브러리

Gradio: 기계학습 모델을 위한 빠르고 간편한 UI 라이브러리

PyTorch: 핵심 딥러닝 프레임워크