Metadata-Version: 2.1
Name: jupyter-kernel-provisioner-proxy
Version: 0.1.1
Summary: Jupyter kernel provisioner proxy
Project-URL: Homepage, https://github.com/davidbrochart/jupyter-kernel-provisioner-proxy
Author-email: David Brochart <david.brochart@gmail.com>
License: MIT
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: >=3.8
Requires-Dist: httpx-ws<1,>=0.4.0
Requires-Dist: httpx<1,>=0.24.1
Requires-Dist: jupyter-client
Requires-Dist: python-dateutil
Requires-Dist: pyzmq
Requires-Dist: rich-click<2,>=1.6.1
Requires-Dist: wsproto
Description-Content-Type: text/markdown

# jupyter-kernel-provisioner-proxy

A Jupyter kernel [provisioner](https://jupyter-client.readthedocs.io/en/stable/provisioning.html) that actually talks to a remote kernel through the kernel REST API of a Jupyter server.

## Usage

### Main server side

Install jupyter-kernel-provisioner-proxy:

```console
pip install jupyter-kernel-provisioner-proxy
```

Then install a kernelspec with the `jupyter-kernel-provisioner-proxy install` command.

```console
$ jupyter-kernel-provisioner-proxy install --help

 Usage: jupyter-kernel-provisioner-proxy install [OPTIONS]

╭─ Options ────────────────────────────────────────────╮
│ --display     TEXT  The kernel's display name        │
│ --language    TEXT  The kernel's language name       │
│ --kernel      TEXT  The kernel's name                │
│ --url         TEXT  The kernel server URL            │
│ --help              Show this message and exit.      │
╰──────────────────────────────────────────────────────╯
```

By default, `jupyter-kernel-provisioner-proxy install` will install a Python kernelspec, with the Jupyter server serving remote kernels at http://localhost:8000.

### Kernel server side

You can use [jupyter-server](https://github.com/jupyter-server/jupyter_server) or [jupyverse](https://github.com/jupyter-server/jupyverse) to serve remote kernels.

#### Using jupyter-server

```console
pip install jupyter-server
jupyter server --ServerApp.token='' --ServerApp.password='' --ServerApp.disable_check_xsrf=True --no-browser --port=8000
```

#### Using jupyverse

```console
pip install fps-kernels fps-noauth fps-frontend ipykernel
jupyverse
```
