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
Measured star growth
- in 24h
- 0
- in 7 days
- Collecting history
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Workspace for documents with AI
AIREADME.md
OriginalEasyPaper is a web and desktop workspace for translating, reading, annotating, and discussing PDFs with AI. Use local Ollama, Gemini, Claude, OpenAI, or supported CLI providers including Antigravity, Claude Code, and Codex.
Research mode workspace
Two reading modes
| Mode | For | What it emphasizes |
|---|---|---|
| Research mode | Papers, surveys, theses, preprints, and academic reports | Paper structure, methods, evidence, citations, research graphs, comparisons, and pre-reading briefs |
| General document mode | Technical documentation, books, articles, reports, manuals, policies, presentations, and other general documents | Document-aware translation, summaries, vocabulary, focused Q&A, full-text search, and document overviews |
Both modes currently accept PDF files. General document mode lets you use features appropriate to the purpose and type of each document.
More screenshots
![]() |
![]() |
| Research mode dashboard | General document mode dashboard |
![]() |
![]() |
| Viewer and AI assistant | Figure and image reference overlay |
![]() |
![]() |
| Annotations and floating memos | Citation reference overlay |
![]() |
![]() |
| Library | AI Chats |
![]() |
![]() |
| Research graph heatmap | Reading records |
Features
- 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
- Reference, figure, table, and equation overlays for research PDFs
- Native desktop apps for Windows, macOS, and Linux, plus a self-hosted web app
Quick start
Desktop app
You can download the installer for your platform from the latest release. The Tauri desktop app includes the backend sidecar, so no additional Python or Node.js installation is required.
| OS | Installer |
|---|---|
| Windows | .msi or .exe |
| macOS (Apple Silicon) | _aarch64.dmg |
| Linux | .AppImage, .deb, or .rpm |
At first launch, choose and configure an AI Provider in the onboarding flow. Unsigned desktop builds can trigger an operating-system security warning.
[!IMPORTANT] Note macOS: Because the app is not fully signed, recent versions of macOS (Ventura and later) may show the misleading message “The application cannot be opened because it is damaged” instead of allowing you to bypass the warning with right-click → Open. The file is not actually damaged; this is caused by the quarantine attribute added during download. Remove it in Terminal with the command below, then try again.
xattr -cr /Applications/EasyPaper.appWindows: On the “Windows protected your PC” screen, select More info → Run anyway to install normally.
Run from source
Requirements: Python 3.8+, Node.js 16+, and npm. Ollama is optional. The scripts below make setup and startup straightforward.
git clone https://github.com/orion-gz/EasyPaper.git
cd EasyPaper
./scripts/sh/setup.sh
./scripts/sh/start.sh
On Windows, run scripts\bat\setup.bat, then scripts\bat\start.bat. Open http://localhost:8000 after the server starts.
Docker
git clone https://github.com/orion-gz/EasyPaper.git
cd EasyPaper
docker compose up -d --build
Open http://localhost:8000. Data is persisted in the /data volume. To stop the service, run docker compose down.
Initial account
| Field | Value |
|---|---|
| Username | admin |
| Password | admin |
Change these credentials in Settings after signing in.
Testing
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-based AI Providers
EasyPaper detects installed and authenticated agy, claude, and codex CLIs at startup. Select any detected provider from the model picker; API providers and Ollama remain available as alternatives.
See CHANGELOG.md for release notes.








