orion-gz/EasyPaper
orion-gz/EasyPaper has 42 GitHub stars and 7 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 20:19 UTC. Last push 2026-11-10.
What you can do
- Side-by-side source and AI translation with sentence-level alignment
- Context-aware AI chat, pre-reading briefs, summaries, and vocabulary support
- Research workspace with library, AI Chats, research graph, reading analytics, and recommendations
- Annotations, highlights, floating memos, and annotated PDF export
측정된 스타 증가
- in 24h
- 0
- in 7 days
- 기록 수집 중
- in 15 days
- 기록 수집 중
- in 1 month
- 기록 수집 중
서로 겹치는 기간의 순증가량이며 일별 합계가 아닙니다. 측정값이 없으면 비워 둡니다. 스타는 관심도를 나타내며 품질을 보장하지 않습니다.
소개
Workspace for documents with AI
AIREADME.ko.md
OriginalEasyPaper는 PDF를 AI로 번역하고, 읽고, 주석을 남기고, 문서 내용을 바탕으로 대화할 수 있는 웹·데스크톱 워크스페이스입니다. 로컬 Ollama, Gemini, Claude, OpenAI와 Antigravity·Claude Code·Codex CLI를 지원합니다.
연구 모드 워크스페이스
두 가지 읽기 모드
| 모드 | 대상 | 주요 기능 |
|---|---|---|
| 연구 모드 | 논문, 서베이, 학위 논문, 프리프린트, 학술 보고서 | 논문 구조·방법론·근거·인용 분석, 연구 그래프, 논문 비교, 읽기 전 브리핑 |
| 일반 문서 모드 | 기술 문서, 서적, 기사, 보고서, 매뉴얼, 정책 문서, 발표 자료 등 | 문서 유형별 번역, 요약, 어휘, 문서 중심 질의응답, 전문 검색, 문서 개요 |
현재 두 모드 모두 PDF를 입력으로 사용합니다. 일반 문서 모드에서는 문서 목적과 유형에 맞는 기능을 활용할 수 있습니다.
추가 스크린샷
![]() |
![]() |
| 연구 모드 대시보드 | 일반 문서 모드 대시보드 |
![]() |
![]() |
| 뷰어와 AI 어시스턴트 | 그림·이미지 참조 오버레이 |
![]() |
![]() |
| 주석과 플로팅 메모 | 인용 참고문헌 오버레이 |
![]() |
![]() |
| 라이브러리 | AI Chats |
![]() |
![]() |
| 연구 그래프 히트맵 | 읽은 기록 |
주요 기능
- 원문과 AI 번역문을 나란히 보는 문장 단위 정렬 뷰어
- 문서 맥락 기반 AI 채팅, 읽기 전 브리핑, 요약, 어휘 지원
- 라이브러리, AI Chats, 연구 그래프, 읽기 분석, 추천을 갖춘 연구 워크스페이스
- 하이라이트, 주석, 플로팅 메모, 주석 포함 PDF 내보내기
- 연구 PDF의 인용·그림·표·수식 참조 오버레이
- Windows, macOS, Linux용 네이티브 데스크톱 앱 및 자체 호스팅 웹 앱
빠른 시작
데스크톱 앱
최신 릴리스에서 설치 파일을 받을 수 있습니다. Tauri 기반 앱에는 백엔드 사이드카가 포함되어 있어 Python과 Node.js 추가 설치가 필요하지 않습니다.
| OS | 설치 파일 |
|---|---|
| Windows | .msi 또는 .exe |
| macOS (Apple Silicon) | _aarch64.dmg |
| Linux | .AppImage, .deb, 또는 .rpm |
첫 실행 시 온보딩에서 AI Provider 를 선택하고 설정합니다. 서명되지 않은 데스크톱 빌드는 운영체제 보안 경고를 표시할 수 있습니다.
[!IMPORTANT] 주의사항 macOS: 앱이 완전히 서명되지 않은 상태라 최신 macOS(Ventura 이후)에서는 우클릭 → 열기로 우회되지 않고 "앱이 손상되었기 때문에 열 수 없습니다" 라는 오해의 소지가 있는 메시지가 뜹니다. 실제로 파일이 손상된 게 아니라 다운로드 시 붙는 quarantine 속성 때문이니, 터미널에서 아래 명령으로 지운 뒤 다시 실행하세요.
xattr -cr /Applications/EasyPaper.appWindows: "Windows의 PC 보호" 화면에서 추가 정보 → 실행을 선택하면 정상적으로 설치됩니다.
소스로 실행하기
Python 3.8+, Node.js 16+, npm이 필요합니다. Ollama는 선택 사항입니다. 아래 스크립트를 통해 쉽게 실행할 수 있습니다.
git clone https://github.com/orion-gz/EasyPaper.git
cd EasyPaper
./scripts/sh/setup.sh
./scripts/sh/start.sh
Windows에서는 scripts\bat\setup.bat을 실행한 뒤 scripts\bat\start.bat을 실행하세요. 서버가 시작되면 http://localhost:8000에서 사용할 수 있습니다.
Docker
git clone https://github.com/orion-gz/EasyPaper.git
cd EasyPaper
docker compose up -d --build
서버는 http://localhost:8000에서 실행됩니다. 데이터는 /data 볼륨에 보존되며, 중지는 docker compose down으로 할 수 있습니다.
초기 계정
| 항목 | 값 |
|---|---|
| 아이디 | admin |
| 비밀번호 | admin |
로그인 후 설정에서 계정을 변경하세요.
테스트
cd backend
.venv/bin/pip install -r requirements-dev.txt
.venv/bin/python -m pytest tests/ -v
cd frontend
npm install
npm run build
npm run test:e2e
CLI 기반 AI Provider
EasyPaper는 시작 시 설치·로그인된 agy, claude, codex CLI를 감지합니다. 감지된 공급자는 모델 선택기에서 바로 사용할 수 있으며 API 공급자와 Ollama도 함께 지원합니다.
변경 이력은 CHANGELOG.md에서 확인할 수 있습니다.








