{"id":15043300,"url":"https://github.com/goerz/python-localvenv-kernel","last_synced_at":"2025-04-14T20:50:38.640Z","repository":{"id":207171552,"uuid":"718619737","full_name":"goerz/python-localvenv-kernel","owner":"goerz","description":"A Jupyter kernel that delegates to ipykernel in the .venv environment of a project folder","archived":false,"fork":false,"pushed_at":"2024-05-12T19:42:42.000Z","size":1464,"stargazers_count":10,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-28T09:04:07.818Z","etag":null,"topics":["ipython-kernel","jupyter","jupyter-notebook","kernel","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/goerz.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-11-14T13:14:39.000Z","updated_at":"2024-11-11T16:58:51.000Z","dependencies_parsed_at":null,"dependency_job_id":"792d3fee-f5fb-4799-814b-4cd1c73182f0","html_url":"https://github.com/goerz/python-localvenv-kernel","commit_stats":{"total_commits":20,"total_committers":1,"mean_commits":20.0,"dds":0.0,"last_synced_commit":"39c24d70bafe99d233538815dd5291eed1065806"},"previous_names":["goerz/python-localvenv-kernel"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goerz%2Fpython-localvenv-kernel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goerz%2Fpython-localvenv-kernel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goerz%2Fpython-localvenv-kernel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goerz%2Fpython-localvenv-kernel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/goerz","download_url":"https://codeload.github.com/goerz/python-localvenv-kernel/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248960913,"owners_count":21189990,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ipython-kernel","jupyter","jupyter-notebook","kernel","python"],"created_at":"2024-09-24T20:48:49.731Z","updated_at":"2025-04-14T20:50:38.569Z","avatar_url":"https://github.com/goerz.png","language":"Python","readme":"# Python Local `.venv` Kernel\n\n[![Github](https://img.shields.io/badge/goerz-python--localvenv--kernel-blue.svg?logo=github)](https://github.com/goerz/python-localvenv-kernel)\n[![Build Status](https://github.com/goerz/python-localvenv-kernel/workflows/CI/badge.svg)](https://github.com/goerz/python-localvenv-kernel/actions)\n[![PyPI](https://img.shields.io/pypi/v/python-localvenv-kernel.svg)](https://pypi.org/project/python-localvenv-kernel/)\n[![Conda Version](https://img.shields.io/conda/vn/conda-forge/python-localvenv-kernel.svg)](https://anaconda.org/conda-forge/python-localvenv-kernel)\n[![Conda Recipe](https://img.shields.io/badge/recipe-conda--forge-green.svg)](https://github.com/conda-forge/python-localvenv-kernel-feedstock)\n[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)\n\nA Jupyter kernel that delegates to `ipykernel` in the `.venv` environment of a project folder.\n\nDerived from [`poetry-kernel`](https://github.com/pathbird/poetry-kernel), see the [FAQ](https://github.com/goerz/python-localvenv-kernel/blob/master/FAQ.md#how-does-this-kernel-differ-from-poetry-kernel).\n\nSee the demo at the December 2023 Jupyter Community Call:\n\n[![Jupyter Community Call](https://img.youtube.com/vi/hUU77BfU-Kk/0.jpg)](https://www.youtube.com/watch?v=hUU77BfU-Kk\u0026t=360)\n\n\n## Installation\n\nThe `python-localvenv-kernel` package can be installed via `pip` (`pip install python-localvenv-kernel`) or as a [Conda package](https://github.com/conda-forge/python-localvenv-kernel-feedstock#about-python-localvenv-kernel-feedstock) (`conda install python-localvenv-kernel`).\n\nIt must be installed into the same environment as the Jupyter server, see [Usage](#usage) below.\n\n\n## Usage\n\n* Jupyter and the `python-localvenv-kernel` package should be installed in the same environment\n* The project folder must have a virtual (project) environment instantiated in a subfolder `.venv`. The name of folder can be overridden by setting the environment variable `KERNEL_VENV` (see [FAQ](https://github.com/goerz/python-localvenv-kernel/blob/master/FAQ.md#how-can-i-change-the-directory-for-the-virtual-environment))\n* The project environment must include the `ipykernel` package (but not `jupyter`)\n* Start Jupyter from the project folder\n* Select the \"Python (local .venv)\" kernel\n\n![Jupyter launcher screenshot (kernel selector)](https://github.com/goerz/python-localvenv-kernel/blob/master/.static/jupyter-screenshot.png?raw=true)\n\n![Jupyter launcher screenshot (notebook)](https://github.com/goerz/python-localvenv-kernel/blob/master/.static/jupyter-screenshot-2.png?raw=true)\n\n\n## FAQ\n\n[See `FAQ.md`.][FAQ]\n\n[FAQ]: https://github.com/goerz/python-localvenv-kernel/blob/master/FAQ.md\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoerz%2Fpython-localvenv-kernel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgoerz%2Fpython-localvenv-kernel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoerz%2Fpython-localvenv-kernel/lists"}