nbcat 0.9.4

cat for jupyter notebooks

📦 nbcat

nbcat lets you preview Jupyter notebooks directly in your terminal. Think of it as cat, but for .ipynb files.

🚀 Features

• Fast and lightweight with minimal external dependencies
• Preview remote notebooks without downloading them
• Supports for all Jupyter notebook versions - including legacy formats

📦 Installation

From the command line using pip:

pip install nbcat

🛠️ Quickstart

$ nbcat notebook.ipynb

You can pass URLs as well.

$ nbcat https://raw.githubusercontent.com/akopdev/nbcat/refs/heads/main/tests/assets/test4.ipynb

Example use case with fzf command that lists all .ipynb files and uses nbcat for previewing them:

find . -type f -name "*.ipynb" | fzf --preview 'nbcat {}'

🧪 Testing & Development

Run the tests:

make test

Check code quality:

make format lint

🙌 Contributing

Contributions are welcome! Please open an issue or pull request.

📄 License

Distributed under the MIT License. See LICENSE for more information.

🔗 Useful Links

• 📘 Documentation: coming soon
• 🐛 Issues: GitHub Issues
• 🚀 Releases: GitHub Releases

---

Made with ❤️ by Akop Kesheshyan