Notebook Intelligence

Notebook Intelligence (NBI) is an AI coding assistant and extensible AI framework for JupyterLab. It adds chat, inline edit, auto-complete, and an agent that can drive notebooks — backed by GitHub Copilot, an OpenAI-compatible or LiteLLM-compatible endpoint, local Ollama models, or Anthropic's Claude Code CLI.

NBI is free and open-source. Connect it to a free or paid LLM provider of your choice — GitHub Copilot, any OpenAI- or LiteLLM-compatible endpoint, Ollama (local), or Anthropic Claude (via the Claude Code CLI). Provider charges, when applicable, are paid directly to the provider.

Contents

• Requirements
• Quick start
• Concepts
• Feature highlights
  • Claude mode
  • Agent mode
  • ACP agent mode
  • Chatbook
  • Code generation with inline chat
  • Auto-complete
  • Chat interface
  • Cell output actions
  • Notebook toolbar generation
  • Multi-language and kernel-aware notebooks
  • Reload open files when changed on disk
• Configuration
  • Configuration files
  • Remembering GitHub Copilot login
• Built-in tools
• Model Context Protocol (MCP) support
  • MCP config example
• Rulesets
• Claude Skills
• Claude MCP Servers
• Claude Plugins
• Chat feedback
• Configuration readiness
• Performance diagnostics
• Documentation
• Further reading
• Roadmap
• License

Requirements

• Python 3.10+
• JupyterLab 4.x
• Node.js — required for Claude mode (the Claude Code CLI), for ACP agent mode, which launches its adapter with npx on every start, and for MCP servers that launch via npx.
• A fresh virtualenv or conda env is recommended so NBI doesn't conflict with system Python.

Quick start

pip install notebook-intelligence
jupyter lab     # restart JupyterLab if it was already running

After restart:

1. Click the NBI icon in the left sidebar to open the chat panel.
2. Open NBI Settings (gear icon in the chat panel, or Settings → Notebook Intelligence Settings).
3. Sign into your provider — for GitHub Copilot, click Sign in; for an OpenAI- or LiteLLM-compatible endpoint, paste an API key; for Ollama, point at your local daemon. To use Claude, enable Claude mode (see below).
4. Type a message in the chat panel and press Enter.

If the panel stays empty or login does nothing, see Troubleshooting.

Concepts

A short glossary you'll see referenced throughout these docs.