Skip to content

About

Read research papers with interactive diagrams, equations, and experiment comparisons

Resources

Stars

4 stars

Watchers

0 watching

Forks

Repository files navigation

PaperMaster

Read research papers by exploring their methods, testing their equations, and comparing their results.

简体中文 · Install · Quick start · Demos · npm

PaperMaster is a local reading workspace for research papers. Import a PDF or an arXiv link, then follow a method from its architecture diagram to an interactive equation and the experiments that test it. Save your findings as Markdown.

Install

Requires Node.js 22.16 or later. The npm package includes the built interface.

npm install -g papermaster-reader
papermaster

PaperMaster opens your browser and prints its local URL. In Windows PowerShell, use npm.cmd and papermaster.cmd if script execution policy blocks the shims.

Quick start

  1. Open 模型连接 (Model connections) and add a provider. For a Codex subscription, install the Codex CLI and run codex login with your ChatGPT account. You can select a model from the CLI's list.
  2. Click 导入论文 (Import paper), then upload a text-based PDF or paste an arXiv URL.
  3. Choose 完整精读 (Deep reading). Follow the interactive diagrams in the text, try the formula scenarios, and compare results in the experiment chapter. 泛读 (Skim) includes an animated overview. Select a repository snapshot to ground the diagrams in the available code.
  4. Save an observation to the main note or export the reading as Markdown. On an older reading, 生成交互版 creates a new interactive record from the same paper version.

Demos

Both recordings use reading results for Visual Scaffolding: Toward Native Multimodal Reasoning.

Skim the architecture. Play the flow inside the article and watch the diagram and the selected module explanation advance together.

The Visual Scaffolding architecture playing step by step in a PaperMaster skim

Try a formula in context. Switch between scenarios and see which grid cells are selected when their scores cross the threshold.

The Visual Scaffolding formula lab changing its selection as scenarios change

What you can do

Feature Workflow
Architecture explorer Play or step through a method inline. Select a module to inspect its input, operation, and output.
Formula lab Try preset scenarios or edit inputs. Deep reading can include separate labs for different steps of the method.
Experiment comparison Filter reported results and ablations, compare rows, and open the original figures or tables.
Guided reading Work through questions with feedback and resume where you left off.
Repository reading Connect a public GitHub repository and read the implementation at a recorded commit. Requires Git.
Markdown notes Save experiment comparisons or a specific formula run, and export results for later use.

Model providers and data

Connect a Codex subscription, an OpenAI-compatible endpoint, or a native OpenAI, Claude, or Gemini API. API connections use an environment variable or the Windows/macOS system credential store.

The paper library, reading history, and notes stay on your machine. Generation sends the needed paper excerpts to your selected model provider. The reading form lets you choose whether to include figure and table crops. Import currently requires a PDF with extractable text. Interactive coverage depends on the material available in the paper.

Development

git clone https://github.com/Kstheme/PaperMaster.git
cd PaperMaster
npm ci
npm test
npm run build
npm start

Use papermaster --help for local server options. See the interactive reading design and platform design for implementation details. Report reproducible bugs at GitHub Issues.

About

Read research papers with interactive diagrams, equations, and experiment comparisons

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages