v3.0.0a1
Pre-release3.0.0a1
Hey folks! This v3 release notably introduces AI personas that replace chat handlers, fixes various usability issues encountered in v3.0.0a0, and upgrades to LangChain v0.3 & Pydantic v2. π
AI personas
AI personas re-define how new messages are handled in Jupyter AI, and supersede the previous convention of "chat handlers" used in v2. AI personas are like "chatbots" available in every chat instance and can use any model/framework of their choice.
- Each chat can have any number of AI personas.
- You have to
@
-mention a persona to get it to reply. The available personas will be listed after typing@
, which shows a menu listing the available personas. - Currently, Jupyter AI only has a single AI persona by default: Jupyternaut.
- Each message may mention any number of AI personas, so you can send the same question to multiple personas.
- Personas can have a custom name & avatar.
- Custom AI personas can be added to your Jupyter AI instance by writing & installing a new package that provides custom AI personas as entry points.
- We plan to add more AI personas by default and/or provide library packages that add AI personas.
- More information will be available in the v3 user documentation once it is ready.
There's also a new v3 documentation page! Currently, only the developer documentation has been updated. Please read through the v3 developer docs if you are interested in writing your own AI personas. π€
- Link to new v3 developer docs: https://jupyter-ai.readthedocs.io/en/v3/developers/index.html
Planned future work
-
Jupyternaut in v3 is similar to Jupyternaut in v2, but currently lacks slash commands. We are planning to replace slash commands with agentic tools called by the chat model directly.
- In other words, Jupyternaut will infer your intent based on your prompt and automatically learn/generate/fix files by v3.0.0.
- We will develop this once we begin work on providing APIs for agentic tool use and integrating MCP support after v3.0.0b0 (beta development phase).
-
See the roadmap issue & GitHub milestones for more details on our future work: #1052
Enhancements made
- Introduce AI persona framework #1341 (@dlqqq)
- Separate
BaseProvider
for faster import #1338 (@krassowski) - Added new
gpt-4.1
models #1325 (@srdas) - Introduce AI persona framework #1324 (@dlqqq)
- [v3] Upgrade to jupyterlab-chat v0.8, restore context command completions #1290 (@dlqqq)
- Added help text fields for embedding providers in the AI Setting page #1288 (@srdas)
- Allow chat handlers to be initialized in any order #1268 (@Darshan808)
- Allow embedding model fields, fix coupled model fields, add custom OpenAI provider #1264 (@srdas)
- Refactor Chat Handlers to Simplify Initialization #1257 (@Darshan808)
- Make Native Chat Handlers Overridable via Entry Points #1249 (@Darshan808)
- Upgrade to LangChain v0.3 and Pydantic v2 #1201 (@dlqqq)
- Show error icon near cursor on inline completion errors #1197 (@Darshan808)
Bugs fixed
- Fix the path missing in inline completion request when there is no kernel #1361 (@krassowski)
- Periodically update the persona awareness to keep it alive #1358 (@brichet)
- Added a local identity provider. #1333 (@3coins)
- Handle missing field in config.json on version upgrade #1330 (@srdas)
- [3.x] Expand edge case handling in ConfigManager #1322 (@dlqqq)
- Open the AI settings in a side panel in Notebook application #1309 (@brichet)
- Add
default_completions_model
trait #1303 (@srdas) - Pass
model_parameters
trait to embedding & completion models #1298 (@srdas) - Migrate old config schemas, fix v2.31.0 regression #1294 (@dlqqq)
- Remove error log emitted when FAISS file is absent #1287 (@srdas)
- Ensure magics package version is consistent in future releases #1280 (@dlqqq)
- Correct minimum versions in dependency version ranges #1272 (@dlqqq)
- Allow embedding model fields, fix coupled model fields, add custom OpenAI provider #1264 (@srdas)
- Enforce path imports for MUI icons, upgrade to ESLint v8 #1225 (@krassowski)
- Fixes duplicate api key being passed inΒ
openrouter.py
#1216 (@srdas) - Fix MUI theme in Jupyter AI Settings #1210 (@MUFFANUJ)
- Fix Amazon Nova support (use
StrOutputParser
) #1202 (@dlqqq) - Remove remaining shortcut to focus the chat input #1186 (@brichet)
- Fix specifying empty list in provider and model allow/denylists #1185 (@MaicoTimmerman)
- Reply gracefully when chat model is not selected #1183 (@dlqqq)
Maintenance and upkeep improvements
- Revert "Introduce AI persona framework (#1324)" #1340 (@dlqqq)
- Add
pyupgrade --py39-plus
andautoflake
topre-commit
config #1329 (@rominf) - Ensure magics package version is consistent in future releases #1280 (@dlqqq)
- Correct minimum versions in dependency version ranges #1272 (@dlqqq)
- Remove the dependency on
jupyterlab
#1234 (@jtpio) - Upgrade to
actions/cache@v4
#1228 (@dlqqq) - Typo in comment #1217 (@Carreau)
Documentation improvements
- Overhaul v3 developer documentation #1344 (@dlqqq)
- Update documentation to show usage with OpenRouter API and URL #1318 (@srdas)
- Add information about ollama - document it as an available provider and provide clearer troubleshooting help. #1235 (@fperez)
- Add documentation for vLLM usage #1232 (@srdas)
- Update documentation for setting API keys without revealing them #1224 (@srdas)
- Typo in comment #1217 (@Carreau)
- Docs: Update installation steps to work in bash & zsh #1211 (@srdas)
- Update developer docs on Pydantic compatibility #1204 (@dlqqq)
- Update documentation to add usage of
Openrouter
#1193 (@srdas) - Fix dev install steps in contributor docs #1188 (@srdas)
Contributors to this release
(GitHub contributors page for this release)
@3coins | @brichet | @Carreau | @Darshan808 | @dlqqq | @ellisonbg | @fperez | @gogakoreli | @Jiya873 | @jtpio | @krassowski | @lumberbot-app | @MaicoTimmerman | @MUFFANUJ | @paulrutter | @pre-commit-ci | @rominf | @srdas