jupyter-ai-persona-manager
The core manager & registry for AI personas in Jupyter AI
Decision gist · record as of 2026-08-14
Yes, if you are running JupyterLab 4.0+ and want to create or use custom AI personas in Jupyter AI chat. The package is actively maintained, has low install friction, carries no security vulnerabilities, and is permissively licensed. Install it as a dependency when building persona plugins, or as a base package if you intend to develop custom personas locally.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires JupyterLab >= 4.0.0 and Python >= 3.10.
- Personas are discovered via entry points or from .jupyter/personas/ directory; restart JupyterLab or use /refresh-personas command to load new personas.
- Low install friction with a pure-Python wheel.
License · maintenance · safety
permissive license (permissive) — BSD 3-Clause License permits use, modification, and distribution with minimal restrictions—suitable for both open-source and proprietary projects. No copyleft obligations.
last release 2026-07-23 (22 days) · last repo commit 2026-08-12 · 3 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 99,542 downloads/mo, #13,016 on PyPI
Alternatives
Verify before relying
pip install jupyter_ai_persona_manager
from jupyter_ai_persona_manager import BasePersona, PersonaDefaults
from jupyterlab_chat.models import Message
class MyPersona(BasePersona):
@property
def defaults(self):
return PersonaDefaults(
name="MyPersona",
description="Custom assistant",
system_prompt="You are helpful."
)
async def process_message(self, message: Message):
self.send_message(f"You said: {message.body}")- Whether avatar serving at /api/ai/avatars/{filename} works reliably when multiple personas share the same filename.
- Performance characteristics when many personas are registered or when processing high-volume messages.
- Compatibility with Jupyter AI versions other than the latest.
What it is and what it does
jupyter_ai_persona_manager is the core registry and lifecycle manager for AI personas in Jupyter AI chat environments. It provides BasePersona (an abstract base class for custom assistants), PersonaManager (for registration and lifecycle), and entry-point-based discovery so that personas can be packaged as plugins and automatically discovered. Each persona is analogous to a bot in other chat systems—a distinct AI assistant with its own behavior, model, and capabilities that can coexist in the same chat.
Developers use it to create custom personas by subclassing BasePersona, implementing a process_message method, and registering via Python entry points or by placing persona files in .jupyter/personas/. The package handles avatar serving, multi-user awareness, and automatic discovery. It integrates with jupyterlab-chat and jupyter-server, making it the foundation for extending Jupyter AI with custom assistants.
Use it for
- Create a custom code-review assistant persona that analyzes notebook cells and provides feedback on code quality and style.
- Build a research-focused persona that integrates with external APIs (e.g., Ollama, OpenAI) to provide domain-specific answers in Jupyter chat.
- Develop a local development helper persona loaded from .jupyter/personas/ for iterative testing without restarting JupyterLab.
- Register multiple personas via entry points so users can @-mention different AI assistants for different tasks in the same chat.
- Extend Jupyter AI with a persona that queries internal documentation or knowledge bases specific to an organization.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are running JupyterLab 4.0+ and want to create or use custom AI personas in Jupyter AI chat.
The package is actively maintained, has low install friction, carries no security vulnerabilities, and is permissively licensed. Install it as a dependency when building persona plugins, or as a base package if you intend to develop custom personas locally.
Install
jupyter-ai-persona-manager on PyPI
Before you install
Low install friction with a pure-Python wheel. Active maintenance (last commit 2026-08-12, released 2026-07-23) and current Python support (3.10–3.14). Depends on jupyter-server, jupyterlab-chat, and other Jupyter ecosystem packages, all standard in JupyterLab environments.
Requires JupyterLab >= 4.0.0 and Python >= 3.10. Personas are discovered via entry points or from .jupyter/personas/ directory; restart JupyterLab or use /refresh-personas command to load new personas.
License in practice
BSD 3-Clause License permits use, modification, and distribution with minimal restrictions—suitable for both open-source and proprietary projects. No copyleft obligations.
Quickstart
pip install jupyter_ai_persona_manager
from jupyter_ai_persona_manager import BasePersona, PersonaDefaults
from jupyterlab_chat.models import Message
class MyPersona(BasePersona):
@property
def defaults(self):
return PersonaDefaults(
name="MyPersona",
description="Custom assistant",
system_prompt="You are helpful."
)
async def process_message(self, message: Message):
self.send_message(f"You said: {message.body}")Verify before relying
- Whether avatar serving at /api/ai/avatars/{filename} works reliably when multiple personas share the same filename.
- Performance characteristics when many personas are registered or when processing high-volume messages.
- Compatibility with Jupyter AI versions other than the latest.
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 7 packagesimportlib-metadatajupyter-ai-routerjupyter-server-fileidjupyter-serverjupyterlab-chatpycrdtpydantic |
| Maintenance | Actively maintained 22 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 99,542 / month, #13,016 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.14 |
Evidence: jupyter_ai_persona_manager-0.1.2-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 ai personas”
- jupyter-ai-persona-managerProvides the foundational infrastructure for managing and registering…
- jupyter-ai-chat-commandsProvides default chat commands for Jupyter AI, including file…
- jupyter-ai-acp-clientProvides a JupyterLab extension that integrates Agent Client Protocol…
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-acp-client · jupyter-ai-chat-commands · jupyter-ai-router · jupyterlab-commands-toolkit · jupyter-ai · jupyterlab-chat · jupyter-ai-magics · jupyter-ai-tools · ipylab · jupyter-mcp-tools