devscholar-jupyter 0.2.0

DevScholar for JupyterLab - Link research papers (arXiv, DOI, IEEE) directly in your notebooks with hover metadata and PDF preview

DevScholar for JupyterLab

Your Notebooks, Connected to Knowledge.

DevScholar automatically detects research paper references (arXiv, DOI, IEEE, Semantic Scholar) in your Jupyter notebooks and provides rich metadata on hover, PDF preview, and citation management.

Features

1. Automatic Paper Detection

Detects paper references in both code comments and markdown cells:

• arXiv: arxiv:1706.03762, https://arxiv.org/abs/2301.12345
• DOI: doi:10.1038/nature14539, https://doi.org/...
• IEEE: ieee:726791, IEEE Xplore URLs
• Semantic Scholar: Paper URLs and Corpus IDs
• OpenAlex: openalex:W1234567890

2. Rich Hover Metadata

Hover over any paper reference to see:

• Title & Authors
• Abstract
• Publication Year
• Citation Count
• Direct links to PDF and paper page

3. Smart Highlighting

Paper references are automatically underlined with color-coded indicators by source type.

4. Search & Cite

Search for papers by name and insert citations directly into your notebook:

• Use Ctrl/Cmd+Shift+P or Command Palette → "Search & Cite Paper"
• Search by title, author, or keyword
• Results from OpenAlex with citation counts
• Inserts properly formatted citations

5. PDF Preview

Preview paper PDFs directly inside JupyterLab:

• Click "Preview PDF" in hover tooltip
• Navigate pages with keyboard arrows
• Zoom in/out controls
• Works with arXiv and open access papers

6. Citation Management

• Export Bibliography: Generate BibTeX for all papers in your notebook

7. Zotero Sync

Two-way sync between your notebooks and Zotero library:

• Export papers from notebooks to Zotero
• Import citations from Zotero
• Link workspaces to Zotero collections
• Duplicate detection

8. Mendeley Sync

Two-way sync with Mendeley:

• Export papers to Mendeley
• Import citations from Mendeley
• Link workspaces to Mendeley folders

Installation

Prerequisites

• JupyterLab >= 4.0

Install from PyPI

pip install devscholar-jupyter

Install from source (development)

git clone https://github.com/pallaprolus/devscholar-jupyter.git
cd devscholar-jupyter
pip install -e .
jupyter labextension develop . --overwrite

Usage

1. Open any Jupyter notebook
2. Add paper references in comments or markdown:

In code cells:

# Implements attention mechanism from arxiv:1706.03762
def attention(q, k, v):
    ...

In markdown cells:

This implementation is based on the Transformer architecture
described in [arxiv:1706.03762](https://arxiv.org/abs/1706.03762).

3. Hover over references to see metadata
4. Use Command Palette → "DevScholar: Export Bibliography" to get BibTeX

Commands

Command	Description
DevScholar: Show All Paper References	List all papers found in the notebook
DevScholar: Search & Cite Paper	Search and insert citations
DevScholar: Export Bibliography (BibTeX)	Copy BibTeX for all papers

Settings

Configure via Settings → Advanced Settings Editor → DevScholar:

Setting	Default	Description
highlightPapers	true	Highlight paper references
showTooltips	true	Show metadata on hover
parseCodeCells	true	Detect papers in code comments
parseMarkdownCells	true	Detect papers in markdown
prefetchMetadata	true	Auto-fetch metadata
cacheMaxAge	7	Cache duration in days

Related Projects

• DevScholar for VS Code - The original VS Code extension

Roadmap

• Paper detection in code and markdown cells
• Hover metadata from arXiv, DOI, OpenAlex
• BibTeX export
• Search & cite dialog
• PDF preview panel
• Zotero/Mendeley sync
• Google Colab support (browser extension)

Contributing

Contributions welcome! Please see CONTRIBUTING.md for guidelines.

License

MIT License - see LICENSE for details.

---

Part of the DevScholar ecosystem - Connecting code to knowledge.