opennb 0.2.0

Open Jupyter notebooks from GitHub repositories or URLs directly in Jupyter.

opennb 📓

📓 Open Jupyter notebooks from GitHub repositories or URLs directly in Jupyter. Very useful in conjunction with uv run.

:books: Table of Contents

• Installation
• Usage
  • Arguments
• Examples
• Features
• License
• Contributing

Installation

Install using pip:

pip install opennb

Or using uv:

uv pip install opennb

Usage

Open a notebook from a GitHub repository:

opennb owner/repo#path/to/notebook.ipynb

Specify a branch:

opennb owner/repo@branch#path/to/notebook.ipynb

Open directly from a URL:

opennb https://example.com/notebook.ipynb

Use with uv run to install dependencies and open a notebook in one go:

uv run --with owner/repo opennb owner/repo#path/to/notebook.ipynb

For example, to open a notebook from the pipefunc repository and ensure its dependencies are installed:

uv run --with "pipefunc[docs]" opennb pipefunc/pipefunc/example.ipynb

Arguments

All arguments after the notebook specification are passed directly to jupyter notebook:

opennb owner/repo#notebook.ipynb --port 8888 --no-browser

Examples

Open a notebook from the main branch:

opennb scipy/scipy#doc/source/tutorial/basic.ipynb

Open from a specific branch:

opennb pandas-dev/pandas@main#doc/source/getting_started/intro_tutorials/01_table_oriented.ipynb

Open with custom Jupyter settings:

opennb owner/repo#notebook.ipynb --NotebookApp.token='my-token'

Features

• 📦 Open notebooks directly from GitHub repositories
• 🔄 Automatic default branch detection
• 🌳 Support for specific branches
• 🔗 Direct URL support
• 🚀 Pass-through of Jupyter notebook arguments
• 📥 Integration with uv run for dependency management

License

MIT License

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.