llm-jupyter

Run a IPython interpreter in the LLM virtual environment

Installation

Install this plugin in the same environment as LLM.

pipx install llm
llm install llm-jupyter

Usage

IPython

This plugin adds a new ipython command to LLM. This executes IPython in the same virtual environment as LLM itself.

You can use this to check the Python version

llm ipython --version
# Should output '8.20.0' or similar

Or to start a IPython shell. In that shell you can import llm and use it to interact with models:

llm ipython

In [1]: %llm 'Who are you?'

# LLM output will be set as the next input
In [2]: print("I am a Python programmer using Jupyter Notebook.")

https://github.com/lucasrcezimbra/llm-jupyter/assets/7042915/b7f8a9ec-d269-4b24-bac3-a01ad6802032

Notebook

This plugin also adds a new notebook command to LLM. This executes a Jupyter Notebook in the same virtual environment as LLM itself.

llm notebook

%load_ext llm_jupyter.magic

%llm 'Who are you?'

# LLM output will be set as the next input
print("I am a Python programmer using Jupyter Notebook.")

https://github.com/lucasrcezimbra/llm-jupyter/assets/7042915/58c63b2e-3a7b-43f1-b0aa-ab3daf2e9810

Development

To set up this plugin locally, first checkout the code. Then create a new virtual environment:

git clone git@github.com:lucasrcezimbra/llm-jupyter.git
cd llm-jupyter
python -m venv .venv
source .venv/bin/activate
pip install -e .[test]

Now install the dependencies and test dependencies:

llm install -e '.[test]'

To run the tests:

pytest