{"id":1106,"library":"jupyter-console","title":"Jupyter Console","description":"Jupyter Console is a terminal-based console frontend for Jupyter kernels, offering an interactive computing experience directly in your terminal. It provides a rich interface for interacting with various Jupyter kernels, including Python, Julia, and R, building upon the single-process IPython terminal. The current version is 6.6.3 and it is actively maintained as part of the broader Project Jupyter ecosystem, with releases typically tied to updates in its subprojects.","status":"active","version":"6.6.3","language":"python","source_language":"en","source_url":"https://github.com/jupyter/jupyter_console","tags":["jupyter","console","terminal","interactive","cli","kernel"],"install":[{"cmd":"pip install jupyter-console","lang":"bash","label":"Install with pip"}],"dependencies":[],"imports":[{"note":"Most users interact with jupyter-console via the command-line; direct programmatic import for launching the console is less common.","symbol":"JupyterConsoleApp","correct":"from jupyter_console.app import JupyterConsoleApp"}],"quickstart":{"code":"jupyter console --kernel=python","lang":"bash","description":"Launch an interactive Python console session in your terminal. If no kernel is specified, it will attempt to find a default Python kernel."},"warnings":[{"fix":"Review custom code that relies on IPython's internal shell architecture and adapt to jupyter-console's separated `ZMQTerminalInteractiveShell`.","message":"Version 5.0 introduced significant architectural changes, notably disinheriting the shell class from IPython's interactive shell. This may affect advanced users who were directly subclassing or heavily customizing IPython's internal shell structures for jupyter-console.","severity":"breaking","affected_versions":">=5.0.0"},{"fix":"Ensure packages are installed in the Python environment associated with the kernel being used by `jupyter-console`. Use `import sys; print(sys.prefix)` inside the console to verify the active environment.","message":"When multiple Python environments are present, `ImportError: No module named...` errors can occur if the Jupyter kernel runs in a different environment than where a package was installed.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Update configuration files or programmatic settings to use `JupyterConsoleApp.confirm_exit` instead of the old path.","message":"The configuration option for confirming exit (`confirm_exit`) was moved from `ZMQTerminalInteractiveShell.confirm_exit` to `JupyterConsoleApp.confirm_exit` in version 5.3.","severity":"gotcha","affected_versions":">=5.3.0"},{"fix":"To gracefully quit both the console and stop the kernel in such scenarios, use `Ctrl-\\` (Ctrl-Backslash) instead of `Ctrl-D`.","message":"Exiting `jupyter console` with `Ctrl-D` when it's connected to a kernel *not* started by the console itself will leave the kernel running.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Ensure `jupyter console` is executed as a shell command (e.g., using `subprocess.run(['jupyter', 'console', '--kernel=python'])` in Python, or directly in a shell script), not as a Python statement.","message":"The command `jupyter console` was executed as Python code, leading to a `SyntaxError: invalid syntax`. This command should be run directly in a shell environment, not interpreted as Python syntax.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Execute `jupyter console --kernel=python` directly in your terminal, or use `subprocess.run()` if you intend to invoke it programmatically from Python.","message":"Attempting to run `jupyter console --kernel=python` directly within a Python script or interpreter will result in a `SyntaxError` because it is a shell command, not valid Python syntax.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"search_vec":"'6.6.3':52 'activ':56 'base':9 'broader':62 'build':40 'cli':79 'comput':18 'consol':2,4,10,76 'current':49 'direct':20 'ecosystem':65 'experi':19 'frontend':11 'includ':35 'interact':17,30,78 'interfac':28 'ipython':46 'julia':37 'jupyt':1,3,13,33,64,75 'kernel':14,34,80 'maintain':57 'offer':15 'part':59 'process':45 'project':63 'provid':25 'python':36 'r':39 'releas':67 'rich':27 'singl':44 'single-process':43 'subproject':74 'termin':8,23,47,77 'terminal-bas':7 'tie':69 'typic':68 'updat':71 'upon':41 'various':32 'version':50","created_at":"2026-04-05T13:05:58.153175+00:00","updated_at":"2026-04-16T15:58:32.821660+00:00","problems":[{"fix":"Ensure the package is installed in the active environment by running `pip install <package_name>` or `conda install <package_name>`. If using virtual environments, activate the correct environment before launching jupyter-console or explicitly install `ipykernel` in that environment and register it as a Jupyter kernel using `python -m ipykernel install --user --name=myenv --display-name='Python (myenv)'`.","cause":"The Python environment running Jupyter Console does not have the specified package installed, or Jupyter is using a different Python environment than where the package was installed.","error":"ModuleNotFoundError: No module named '<package_name>'"},{"fix":"First, verify Jupyter is installed with `pip show jupyter-console`. If installed, locate the executable (e.g., in `~/.local/bin` on Linux/macOS or `Scripts` folder of your Python installation on Windows) and add that directory to your system's PATH. Alternatively, try running `python -m jupyter_console` to bypass the PATH issue, or reinstall Jupyter using `pip install --upgrade jupyter-console`.","cause":"The directory containing the `jupyter-console` executable is not included in your system's PATH environment variable, or `jupyter-console` was not installed correctly.","error":"'jupyter-console' is not recognized as an internal or external command, operable program or batch file"},{"fix":"Install `ipykernel` in your desired Python environment (`pip install ipykernel` or `conda install ipykernel`) and then register it with Jupyter using `python -m ipykernel install --user --name=myenv --display-name='Python (myenv)'`. If running on a remote server or encountering 'Connection refused', ensure necessary ports are open and firewalls are configured correctly, and try launching with `jupyter console --ip=0.0.0.0` or checking for disk space issues.","cause":"Jupyter Console cannot find or connect to a Python kernel because `ipykernel` is not installed or registered in the environment, or there's a misconfiguration in the kernel specifications.","error":"Jupyter cannot find a kernel matching Python 3"},{"fix":"Try reinstalling the problematic package (e.g., `pip uninstall numpy pyzmq` then `pip install numpy pyzmq`). Ensure all Python environments are consistent and that `pywin32` is correctly installed if it's the root cause (`pip install pywin32`). Restarting the kernel or checking for conflicting Python installations can also help.","cause":"This error, common on Windows, indicates that a dynamic link library (DLL) required by a Python module (often NumPy or its dependencies like `pywin32`) could not be loaded, usually due to missing dependencies, corrupted installations, or environment conflicts.","error":"ImportError: DLL load failed: The specified module could not be found."}],"ecosystem":"pypi","meta_description":null,"install_score":100,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"6.6.3","cli_name":"jupyter-console","cli_version":"6.6.3","type":"library","homepage":"https://jupyter.org","github":null,"docs":null,"changelog":null,"pypi":"https://pypi.org/project/jupyter-console/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["data","ai-ml","web-framework"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-28","last_verified":"2026-06-28","next_check":"2026-07-28","install_tag":"verified"}}