PaperRead는 논문의 원본 PDF와 한국어 번역을 나란히 읽고, 논문 내용에 질문할 수 있는 개인용 로컬 앱입니다. arXiv 주소·번호, 공개된 PDF 직접 URL과 논문 소개 페이지 URL을 받으며, 내 PC의 PDF 파일도 첨부할 수 있습니다. 각 사용자가 자기 PC에서 실행하고 자기 ChatGPT 구독으로 로그인합니다.
논문을 열기만 하면 번역이나 질문 요청을 보내지 않습니다. 번역 시작과 질문 전송은 사용자가 직접 누를 때만 실행됩니다. 사용자가 번역이나 질문을 요청하면 해당 논문 내용이 Codex CLI를 거쳐 OpenAI에 전송됩니다. API 키는 필요하지 않습니다.
실제 로컬 실행 화면입니다. 예시 논문은 Vaswani 외, Attention Is All You Need이며, 한국어는 저장된 번역입니다. 원문 한 줄에 형광펜을 칠하고, 같은 내용의 한국어 문장에 메모를 단 모습입니다.
첫 화면에서 논문을 열고, 보관함에서 저장한 논문을 다시 읽습니다.
읽기 화면 옆에서 질문을 작성합니다. 아래는 질문 전송 전 화면입니다.
- 원문과 한국어 양쪽에 형광펜과 펜으로 표시하고, 하이라이트에 메모를 답니다. 형광펜과 펜은 색 4가지 중에서 고르고 두께를 조절합니다.
- 글자를 끌어 선택하면 하이라이트, 메모 달기, 질문에 인용, 복사 메뉴가 열립니다.
- 메모 모음에서 논문 전체의 하이라이트와 메모를 쪽 순서로 보고, 누르면 그 자리로 이동합니다.
Ctrl+F로 원문과 한국어를 함께 찾습니다.- 계정 메뉴에서 새 번역과 질문에 쓸 기본 모델을 정합니다.
- 번역은 앞쪽 두 쪽을 함께 시작하고, 끝난 쪽부터 한국어 지면이 나타납니다.
도구 막대와 메뉴는 Microsoft Edge의 PDF 보기와 비슷한 모양입니다. 자세한 사용법은 docs/사용법.md를 참고하세요.
- Windows(검증 환경). macOS 실행 방법도 아래에 안내하지만, 실제 Mac에서 로그인·번역·PDF 표시는 아직 검증하지 않았습니다.
- Node.js 24 이상
- 공식 Codex CLI 설치 및 실행 경로 등록
- ChatGPT 구독
Codex CLI 로그인은 PaperRead 화면의 계정 메뉴에서 시작합니다. 앱은 자료 폴더 아래 .codex-home에서 별도 로그인을 관리하며, 터미널의 codex login이나 다른 Codex 로그인은 사용하지 않습니다.
- arXiv 주소 또는 번호:
https://arxiv.org/abs/1706.03762,1706.03762v7 - 로컬 PDF 파일: 화면 위의 PDF 첨부를 누르고 내 PC의 파일을 선택합니다. 같은 PDF는 파일 이름이 달라도 저장한 논문과 번역을 재사용합니다.
- 공개 PDF 직접 URL:
https://aclanthology.org/2020.acl-main.550.pdf. 주소가.pdf로 끝나지 않아도 응답이 PDF이면 열 수 있습니다. - 공개 논문 소개 페이지: NeurIPS 예시, PMLR 예시. 페이지의 PDF 메타데이터 또는 명확한 PDF 링크를 찾습니다. 자동으로 찾지 못하면 PDF 직접 URL을 입력하세요.
URL로 여는 PDF는 HTTPS로 로그인 없이 접근할 수 있어야 합니다. 유료·로그인 전용 PDF의 URL 접근과 스캔 PDF의 OCR은 지원하지 않습니다. URL과 첨부 파일 모두 PDF 크기 제한은 50 MiB, 쪽 수 제한은 300쪽입니다. arXiv, 외부 PDF, 첨부 파일은 별도로 저장하며, 같은 외부 PDF URL이나 첨부 파일의 내용이 바뀌면 새 자료로 저장합니다. 보관함에서 다시 열면 저장된 원본과 번역을 그대로 읽습니다.
Windows의 Git Bash 또는 macOS의 터미널(zsh/bash)에서 이 저장소를 내려받고 프로젝트 폴더로 이동한 뒤 실행합니다. macOS에서는 Node.js와 공식 Codex CLI를 설치하고 codex --version으로 실행 경로를 확인하세요.
git clone https://github.com/nkjunbc/PaperRead.git
cd PaperRead
npm ci
npm run build
PAPERREAD_INDEX=./dist/client/index.html node --import tsx src/server/main.ts브라우저에서 http://127.0.0.1:7327을 엽니다. 서비스를 끝내려면 실행 중인 터미널에서 Ctrl+C를 누릅니다. 자세한 화면 사용법과 PowerShell 실행 방법은 docs/사용법.md를 참고하세요.
- 서버는 현재 PC의
127.0.0.1에서만 열립니다. 이 앱은 여러 사용자가 접속하는 원격 서버로 배포하는 용도가 아닙니다. - 논문, 번역, 하이라이트·메모·필기, 질문 대화, 기본 모델 설정은 기본적으로
%LOCALAPPDATA%\PaperRead에 저장됩니다. - macOS 자료 경로는
~/.local/share/paperread이며,XDG_DATA_HOME을 설정했다면 그 경로 아래paperread를 사용합니다. - Codex CLI 인증은 같은 자료 폴더의
.codex-home에 저장됩니다. 이 폴더를 공유하거나 Git에 올리지 마세요. PAPERREAD_DATA를 설정할 때 프로젝트 저장소 바깥의 폴더를 사용하세요. 앱 자료 폴더를 저장소 안에 두면 논문 파일이 Git에 포함될 수 있습니다.- PaperRead는 비밀번호, 쿠키, 토큰, API 키를 수집하지 않습니다. 로그아웃은 PaperRead 앱 전용 로그인만 끊습니다.
- 원문 PDF는 논문을 열 때 해당 사이트에서 다운로드합니다. 논문 전문은 사용자가 번역을 시작하거나 질문을 전송할 때 Codex CLI를 통해 OpenAI에 전달됩니다.
npm run build