{
 "kind": "tool",
 "slug": "nbclient",
 "path": "tools/nbclient/",
 "name": "nbclient",
 "maker": null,
 "density": "basic",
 "crumbs": [
  [
   "Tools",
   "tools/"
  ],
  [
   "Markdown, editors and content",
   "tools/content-editors/"
  ]
 ],
 "lead": "Execute Jupyter notebooks programmatically for automation and testing.",
 "chips": [
  {
   "label": "Markdown, editors and content",
   "path": "tools/content-editors/"
  },
  {
   "label": "PYPI"
  }
 ],
 "primary": {
  "label": "Copy install command",
  "copy": "pip install nbclient"
 },
 "links": [
  {
   "label": "GitHub",
   "href": "https://github.com/jupyter/nbclient"
  },
  {
   "label": "Website",
   "href": "https://jupyter.org"
  }
 ],
 "track": "New versions, deprecation and license changes on your dashboard",
 "verdicts": [
  {
   "key": "license",
   "label": "License",
   "value": "BSD",
   "status": "yes",
   "sub": "Use it in paid apps",
   "quote": null,
   "note": "License from PyPI classifier.",
   "src": "https://github.com/jupyter/nbclient"
  },
  {
   "key": "maint",
   "label": "Maintained",
   "value": "Maintained",
   "status": "yes",
   "sub": "Last change Jun 5, 2026",
   "note": "Latest GitHub release Jun 5, 2026. ",
   "src": "https://github.com/jupyter/nbclient"
  },
  {
   "key": "pop",
   "label": "Used by agents' projects",
   "value": "7 projects",
   "status": "info",
   "sub": "#79 of 149 in its category",
   "note": "Dependency in 7 public GitHub projects set up for AI coding agents that we scanned (0.1%).",
   "src": null
  },
  {
   "key": "agent",
   "label": "Agent access",
   "value": "Install only",
   "status": "info",
   "sub": null,
   "note": "Agent skills for this library in the skills catalog; community skills are written by others, read them before you install.",
   "src": null
  }
 ],
 "vfoot": "From the package registry and GitHub, checked daily.",
 "blocks": [
  {
   "id": "overview",
   "nav": "Overview",
   "h2": "What nbclient does",
   "parts": [
    {
     "t": "prose",
     "text": "Execute Jupyter notebooks programmatically for automation and testing."
    }
   ]
  },
  {
   "id": "popularity",
   "nav": "Popularity",
   "h2": "nbclient popularity",
   "parts": [
    {
     "t": "stats",
     "items": [
      {
       "n": "55",
       "of": "/ 100",
       "l": "Gid Score, #1322 overall"
      },
      {
       "n": "14.4M",
       "l": "downloads a week, pypi"
      },
      {
       "n": "187",
       "l": "GitHub stars"
      },
      {
       "n": "7",
       "l": "agent projects use it"
      }
     ]
    },
    {
     "t": "small",
     "text": "Gid Score measures public popularity and activity, not quality.",
     "link": "How the Gid Score is calculated",
     "path": "tools/top/"
    }
   ]
  },
  {
   "id": "usage",
   "nav": "How it is used",
   "h2": "How nbclient is used",
   "parts": [
    {
     "t": "list",
     "items": [
      "nbclient is a dependency in 7 of the 6,254 public GitHub projects set up for AI coding agents that we scanned, too few to describe it from them alone. Our scan also samples projects by dependency (Solana 3,063, Ethereum and EVM 1,777, 3D and games 3,120, agent frameworks and SDKs 13,629); counting those, it appears in 257 projects, and what it is used with below comes from all of them.",
      "The most used alternative in our scan is nbconvert (10 projects).",
      "Projects that use it most often also use nbformat (99.6%), NumPy (98.1%), Beautiful Soup (96.9%)."
     ]
    },
    {
     "t": "h3",
     "text": "Often used with"
    },
    {
     "t": "rows",
     "rows": [
      {
       "l": "In 99.6% of its projects",
       "v": "nbformat",
       "path": "tools/nbformat/"
      },
      {
       "l": "In 98.1% of its projects",
       "v": "NumPy",
       "path": "tools/numpy/"
      },
      {
       "l": "In 96.9% of its projects",
       "v": "Beautiful Soup",
       "path": "tools/beautifulsoup4/"
      },
      {
       "l": "In 96.1% of its projects",
       "v": "IPython",
       "path": "tools/ipython/"
      },
      {
       "l": "In 93.0% of its projects",
       "v": "IPykernel",
       "path": "tools/ipykernel/"
      },
      {
       "l": "In 92.6% of its projects",
       "v": "pandas",
       "path": "tools/pandas/"
      },
      {
       "l": "In 91.4% of its projects",
       "v": "Pillow",
       "path": "tools/pillow/"
      },
      {
       "l": "In 87.2% of its projects",
       "v": "PyYAML",
       "path": "tools/pyyaml/"
      }
     ]
    }
   ]
  },
  {
   "id": "more",
   "nav": null,
   "spy_as": "usage",
   "h2": "More about nbclient",
   "parts": [
    {
     "t": "more",
     "items": [
      {
       "title": "More in Markdown, editors and content",
       "path": "tools/content-editors/",
       "items": [
        {
         "text": "react-markdown",
         "path": "tools/react-markdown/"
        },
        {
         "text": "remark-gfm",
         "path": "tools/remark-gfm/"
        },
        {
         "text": "Marked",
         "path": "tools/marked/"
        },
        {
         "text": "Jinja2",
         "path": "tools/jinja2/"
        },
        {
         "text": "gray-matter",
         "path": "tools/gray-matter/"
        },
        {
         "text": "Tiptap",
         "path": "tools/tiptap/"
        },
        {
         "text": "Shiki",
         "path": "tools/shiki/"
        },
        {
         "text": "highlight.js",
         "path": "tools/highlight-js/"
        }
       ]
      }
     ]
    }
   ]
  },
  {
   "id": "alternatives",
   "nav": "Alternatives",
   "h2": "Alternatives",
   "parts": [
    {
     "t": "alts",
     "items": [
      {
       "name": "nbclient",
       "me": true,
       "facts": [
        "BSD",
        "Gid 55",
        "14.4M/wk"
       ]
      },
      {
       "name": "nbconvert",
       "why": "Convert Jupyter notebooks to other formats like HTML, PDF, Markdown.",
       "path": "tools/nbconvert/",
       "facts": [
        "BSD",
        "Gid 65",
        "14M/wk"
       ]
      }
     ],
     "more": "Compare nbclient with another tool",
     "more_path": "tools/compare/"
    }
   ]
  },
  {
   "id": "start",
   "nav": "Get started",
   "h2": "Get started",
   "parts": [
    {
     "t": "install",
     "intro": "Install it.",
     "code": "pip install nbclient"
    },
    {
     "t": "gap",
     "text": "No step-by-step start for nbclient yet: we have not written its hand-checked card."
    }
   ]
  }
 ],
 "glance": [
  [
   "Package",
   "pypi nbclient"
  ],
  [
   "Category",
   "Markdown, editors and content"
  ],
  [
   "License",
   "BSD"
  ],
  [
   "Gid Score",
   "55.2"
  ],
  [
   "Rank in category",
   "#79 of 149"
  ],
  [
   "GitHub",
   "jupyter/nbclient"
  ],
  [
   "Last change",
   "Jun 5, 2026"
  ]
 ],
 "good": [],
 "checked_line": "From the package registry, GitHub and our scan of public agent projects; numbers update daily.",
 "logo": "https://agentgid.com/media/avatars/jupyter.png"
}