# Jupyter Kernel Mixing
This package provides a Jupyter Server extension that allows you to run local and remote
kernels side by side.
It does this by "mixing" the local and remote kernels together into a single collection
containing both.
This collection then keeps track of whether specific kernels were local or remote and
forwards any corresponding kernel requests accordingly.
## Installation
Install the `kernels-mixer` Python package using `pip`:
```sh
pip install kernels-mixer
```
## Setup
If you do not already have a Jupyter config file (e.g. `~/.jupyter/jupyter_lab_config.py`),
the first generate one with the following command:
```sh
jupyter lab --generate-config
```
The open your config file and add the following two lines to the end:
```py
import kernels_mixer
kernels_mixer.configure_kernels_mixer(c)
```
## Kernel Name Uniqueness
This extension expects that local and remote kernels have different names. If that is not
the case then the local kernel will override the remote kernel. For example, if there is
a local kernel named "python3", then any kernels in the remote kernel gateway named "python3"
will be hidden in favor of it.
When using this extension, it is recommended that the remote kernel gateway is set up to
add a prefix onto every kernel name in order to distinguish them from the local kernels.
Similarly, it is recommended that remote kernel display names are augmented to indicate
where they are running.
The default kernel gateway used with this extension is the regional GCP kernel gateway
hosted under `kernels.googleusercontent.com`, which ensures that both of those conditions
are followed.
Raw data
{
"_id": null,
"home_page": "https://github.com/GoogleCloudPlatform/jupyter-extensions/tree/master/kernels-mixer",
"name": "kernels-mixer",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": "Google, Inc.",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/38/31/62728d2f7d6876895ec8e617523850e5f826f5d037c1127e537ce5f2fe90/kernels_mixer-0.0.15.tar.gz",
"platform": null,
"description": "# Jupyter Kernel Mixing\n\nThis package provides a Jupyter Server extension that allows you to run local and remote\nkernels side by side.\n\nIt does this by \"mixing\" the local and remote kernels together into a single collection\ncontaining both.\n\nThis collection then keeps track of whether specific kernels were local or remote and\nforwards any corresponding kernel requests accordingly.\n\n## Installation\n\nInstall the `kernels-mixer` Python package using `pip`:\n\n```sh\npip install kernels-mixer\n```\n\n## Setup\n\nIf you do not already have a Jupyter config file (e.g. `~/.jupyter/jupyter_lab_config.py`),\nthe first generate one with the following command:\n\n```sh\njupyter lab --generate-config\n```\n\nThe open your config file and add the following two lines to the end:\n\n```py\nimport kernels_mixer\nkernels_mixer.configure_kernels_mixer(c)\n```\n\n## Kernel Name Uniqueness\n\nThis extension expects that local and remote kernels have different names. If that is not\nthe case then the local kernel will override the remote kernel. For example, if there is\na local kernel named \"python3\", then any kernels in the remote kernel gateway named \"python3\"\nwill be hidden in favor of it.\n\nWhen using this extension, it is recommended that the remote kernel gateway is set up to\nadd a prefix onto every kernel name in order to distinguish them from the local kernels.\n\nSimilarly, it is recommended that remote kernel display names are augmented to indicate\nwhere they are running.\n\nThe default kernel gateway used with this extension is the regional GCP kernel gateway\nhosted under `kernels.googleusercontent.com`, which ensures that both of those conditions\nare followed.\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "Jupyter server extension that allows mixing local and remote kernels together",
"version": "0.0.15",
"project_urls": {
"Homepage": "https://github.com/GoogleCloudPlatform/jupyter-extensions/tree/master/kernels-mixer"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "383162728d2f7d6876895ec8e617523850e5f826f5d037c1127e537ce5f2fe90",
"md5": "9689fd91dd8928eba54a7ca3ad19965e",
"sha256": "69f6a6e401a64d4b6ad83f726ecdf3b0e4a53b67e6a36f51ccb5875060fef887"
},
"downloads": -1,
"filename": "kernels_mixer-0.0.15.tar.gz",
"has_sig": false,
"md5_digest": "9689fd91dd8928eba54a7ca3ad19965e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 13555,
"upload_time": "2024-07-30T16:18:32",
"upload_time_iso_8601": "2024-07-30T16:18:32.673088Z",
"url": "https://files.pythonhosted.org/packages/38/31/62728d2f7d6876895ec8e617523850e5f826f5d037c1127e537ce5f2fe90/kernels_mixer-0.0.15.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-30 16:18:32",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "GoogleCloudPlatform",
"github_project": "jupyter-extensions",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "kernels-mixer"
}
JSON
