jupyter-ai-router
Core routing layer of Jupyter AI
Decision gist · record as of 2026-08-14
Yes, if you are building a Jupyter AI extension and need to handle chat events. The router eliminates boilerplate chat lifecycle management and provides a clean callback interface. Install friction is low, maintenance is active, and the BSD license is unrestrictive. Not applicable for standalone use outside the Jupyter AI ecosystem.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires jupyter-server and jupyterlab-chat as runtime dependencies; intended for use within Jupyter AI extensions, not standalone.
- Low friction install with only two runtime dependencies (jupyter-server and jupyterlab-chat).
- Active maintenance: released 6 days ago with recent commits.
License · maintenance · safety
permissive license (permissive) — BSD 3-Clause License permits free use, modification, and distribution with attribution and liability disclaimer—standard permissive terms suitable for most projects.
last release 2026-08-08 (6 days) · last repo commit 2026-08-11 · 2 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 92,825 downloads/mo, #13,419 on PyPI
Alternatives
Verify before relying
pip install jupyter_ai_router
# In a Jupyter AI extension:
router = self.serverapp.web_app.settings.get("jupyter-ai", {}).get("router")
router.observe_chat_init(lambda room_id, ychat: print(f"Chat {room_id} started"))
router.observe_slash_cmd_msg("room-id", "help", lambda room_id, cmd, msg: print(msg.body))- Whether the router automatically persists across Jupyter server restarts or requires re-registration.
- Performance characteristics when handling many concurrent chat rooms or high message volume.
- Compatibility with custom YChat implementations beyond the standard Jupyter AI stack.
What it is and what it does
jupyter_ai_router is a JupyterLab server extension that implements the foundational message routing layer for Jupyter AI. It automatically detects when new chat sessions are initialized and establishes observers on their message streams, then routes incoming messages to registered callbacks based on type—slash commands (like /help or /ai-generate) are separated from regular chat messages. Other extensions register callbacks via methods like observe_chat_init, observe_slash_cmd_msg, and observe_chat_msg to handle specific events without managing chat lifecycle themselves.
The router supports regex pattern matching for slash command handlers, allowing extensions to match exact commands or families of commands. It depends on jupyter-server and jupyterlab-chat, making it part of the Jupyter AI ecosystem rather than a standalone tool. The extension is actively maintained, supports Python 3.9 through 3.13, and is designed to be consumed by other Jupyter AI extensions via the web app settings dictionary.
Use it for
- Build a Jupyter AI extension that responds to custom slash commands by registering a callback with observe_slash_cmd_msg and pattern matching.
- Detect when users start new chat sessions to initialize extension-specific state or connect to external services.
- Route regular chat messages to a custom handler for logging, filtering, or preprocessing before they reach the main chat interface.
- React to chat document resets (when .chat files are modified directly) to synchronize extension state with the updated document.
- Implement multi-room chat monitoring by registering separate callbacks for different room_ids to track activity across sessions.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are building a Jupyter AI extension and need to handle chat events.
The router eliminates boilerplate chat lifecycle management and provides a clean callback interface. Install friction is low, maintenance is active, and the BSD license is unrestrictive. Not applicable for standalone use outside the Jupyter AI ecosystem.
Install
jupyter-ai-router on PyPI
Before you install
Low friction install with only two runtime dependencies (jupyter-server and jupyterlab-chat). Active maintenance: released 6 days ago with recent commits.
Requires jupyter-server and jupyterlab-chat as runtime dependencies; intended for use within Jupyter AI extensions, not standalone.
License in practice
BSD 3-Clause License permits free use, modification, and distribution with attribution and liability disclaimer—standard permissive terms suitable for most projects.
Quickstart
pip install jupyter_ai_router
# In a Jupyter AI extension:
router = self.serverapp.web_app.settings.get("jupyter-ai", {}).get("router")
router.observe_chat_init(lambda room_id, ychat: print(f"Chat {room_id} started"))
router.observe_slash_cmd_msg("room-id", "help", lambda room_id, cmd, msg: print(msg.body))Verify before relying
- Whether the router automatically persists across Jupyter server restarts or requires re-registration.
- Performance characteristics when handling many concurrent chat rooms or high message volume.
- Compatibility with custom YChat implementations beyond the standard Jupyter AI stack.
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagesjupyter-serverjupyterlab-chat |
| Maintenance | Actively maintained 6 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 92,825 / month, #13,419 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Framework :: JupyterFramework :: Jupyter :: JupyterLabFramework :: Jupyter :: JupyterLab :: 4Framework :: Jupyter :: JupyterLab :: ExtensionsFramework :: Jupyter :: JupyterLab :: Extensions :: PrebuiltLicense :: OSI Approved :: BSD LicenseProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.9 |
Evidence: jupyter_ai_router-0.0.7-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “jupyter chat message routing”
- jupyter-ai-routerProvides the core message routing layer for Jupyter AI, automatically…
- chainlitChainlit provides a web UI framework for building conversational AI…
- jupyter-ai-chat-commandsProvides default chat commands for Jupyter AI, including file…
Give your agent the search over MCP, or paste the wish link into any chat.
More Application Frameworks packages
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Textual is a Python framework for building cross-platform user interfaces that run in the terminal or web browser using a modern, component-based API.
Install it if you're developing CLI tools, dashboards, or interactive terminal applications.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Build and connect to Model Context Protocol servers that expose tools, resources, and prompts to LLM applications over stdio, HTTP, or SSE transports.
Install it if you need to build or connect to servers.
Werkzeug is a WSGI utility library providing request/response objects, URL routing, an interactive debugger, HTTP utilities, and a development server for building web applications.
See also jupyter-ai-chat-commands · jupyterlab-chat · jupyter-ai-persona-manager · jupyterlab-commands-toolkit · jupyter-ai · jupyter-ai-acp-client · semantic-router · jupyter-ai-magics · tuspyserver · jupyterlab_notebook_awareness