spyder-kernels

library3.1.4pypypiunverified

Spyder-kernels provides the Jupyter kernels required for Spyder's console to run Python code. It enables Spyder to execute code in separate environments, ensuring isolation and flexibility for different projects. The current version is 3.1.4 and it typically releases new versions in sync with major Spyder IDE updates.

devops workflow

pip install spyder-kernels

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · SPYDER-KERNELS

spyder-kernels

devopspythonv3.1.4

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

To use spyder-kernels, simply install it in the Python environment you wish Spyder to interact with. Once installed, launch Spyder and select that environment as your console's interpreter (e.g., via `Tools > Preferences > Python interpreter`). Then, execute code directly in the IPython console.

import sys print(f"Hello from Spyder kernel!\nPython version: {sys.version}") # This code would be run directly in the Spyder IDE's console.

Debug

Known issues

breakingSpyder-kernels versions are tightly coupled with Spyder IDE versions. Installing a `spyder-kernels` version incompatible with your Spyder IDE might lead to kernel startup failures or unexpected behavior.

fix

Consult the official Spyder documentation for the correct `spyder-kernels` version range compatible with your Spyder IDE. For Spyder 5.x, you generally need `spyder-kernels>=2.0,<3.0`. For Spyder 6.x, you need `spyder-kernels>=3.0`.

affects: <2.0 (for Spyder 5.x), <3.0 (for Spyder 6.x)

gotchaTo run code in a specific environment from Spyder, `spyder-kernels` must be installed in *that specific environment*, not just in the environment where Spyder itself is installed.

fix

Activate your target environment (e.g., `conda activate my_project_env` or `source .venv/bin/activate`) and then run `pip install spyder-kernels`. Afterwards, configure Spyder to use this environment as its Python interpreter.

affects: All

gotchaMismatched or outdated `ipykernel` installations in the target environment can prevent the Spyder kernel from starting or cause it to crash.

fix

Ensure `ipykernel` is up-to-date and compatible with your `spyder-kernels` version. A clean install within your environment (`pip install --upgrade ipykernel`) or ensuring `spyder-kernels` installs its recommended `ipykernel` dependency often resolves this.

affects: All

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'spyder_kernels'

`spyder-kernels` is not installed in the Python environment currently selected by Spyder for its console.

fix

Activate the desired Python environment and install `spyder-kernels`: `pip install spyder-kernels`. Then, ensure Spyder is configured to use this environment as its interpreter.

Kernel died, restarting. The kernel crashed while executing code in the the console. This sometimes happens because of a bug in your code or in a package you are using. For more information, please check the console or the application log.

This generic error often indicates an issue with the Python environment, a conflict between `spyder-kernels` and other packages (like `ipykernel`), or an incompatible `spyder-kernels` version for your Spyder IDE.

fix

1. Verify `spyder-kernels` compatibility with your Spyder IDE version. 2. Ensure `ipykernel` is up-to-date in the target environment. 3. Try creating a fresh environment and installing only `spyder-kernels` and your project dependencies there.

Spyder is not starting up or console is unresponsive after environment change.

Often due to an outdated `spyder-kernels` in the environment, or an `ipykernel` conflict preventing the kernel from properly initializing.

fix

In the problematic environment, run `pip install --upgrade spyder-kernels ipykernel`. If the issue persists, try clearing Spyder's application data (as per Spyder's documentation, usually `~/.spyder-py3` or similar), or use a fresh Python environment.

Upgrade

Version history

3.1.4latest on PyPI · released Mar 25, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

56 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/spyder-ide/spyder-kernels ↗

packagehttps://pypi.org/project/spyder-kernels/ ↗

homepagehttps://www.spyder-ide.org ↗