Troubleshooting

Debugging Guide

Sometimes unexpected things happen. In this case, please, open up an Issue and make sure to include the version of Hydrogen and Cantlet you lot are running. You can go this information by running atom --version from the command line.

Delight, also include the output or a screenshot of the debug messages. To access the debug messages follow these steps:

  1. Open the Settings tab past pressing (ctrl-,), select the Hydrogen package (Packages --> Hydrogen), and tick Enable Debug Messages: hydrogen-settings

  2. Open the programmer tools (View --> Developer --> Toggle Developer Tools or via shift-ctrl-i/cmd-alt-i): open-dev-tools

  3. Select the Console tab to see the debug logs and run the code causing the result: dev-tools

Common Issues

Installation fails on Linux 32-bit

At the moment we don't ship prebuilts for 32-bit Linux. Hence y'all'll need some additional toolling to build from source:

  • python (v2.7 recommended, v3.x.x is non supported for building Hydrogen)
  • make
  • A proper C/C++ compiler toolchain, like GCC

Use your distribution's packet manager to install.

If your default python is 3.ten, y'all need to run instead PYTHON=python2.vii apm install hydrogen or modify the default version for apm with apm config set python $(which python2.7) beforehand. Y'all can nevertheless use three.ten versions of Python in Hydrogen, but it will but build with two.x due to a longstanding consequence with gyp.

No kernel for grammar Xxx institute

Hydrogen requires a Kernel to run lawmaking. Checkout nteract.io/kernels for instructions on how to install the near popular kernels.

Cantlet won't option up kernels within a virtualenv unless Atom is launched as atom . inside the virtualenv. The alternative is to create a kernel specifically for a virtualenv.

No kernel for grammar Python found error on Mac Bone

First off, brand sure that you run

            python3 -m pip install ipykernel python3 -thousand ipykernel install --user

and

            jupyter --paths

shows IPython kernels you desire to use.

Even later the higher up steps have been done successfully, if Hydrogen still keeps complaining the "No kernel for grammar Python found" error on Mac OS, this workaround may help you solve information technology.

Hydrogen doesn't show my results.

Again, there are a number of possible causes and solutions:

  • If the result chimera but shows cheque marks (encounter issues #61, #68, #73, #88):

    • solved past upgrading the jupyter version (run across this comment );

  • If Hydrogen doesn't output whatever results for Atom version < ane.13 (see issue #326), bank check that you haven't disabled Utilize Shadow DOM under Settings > Editor. This option should be enabled.

  • If the spinner in the result bubble never stops (see event #53): This is issue hasn't been seen recently. Please, post in result #53 the details of your installation.

    Hydrogen stopped working afterward updating Cantlet

    Whenever your Atom is upgraded, the Hydrogen package needs to be rebuilt. Atom should prompt you to rebuild Hydrogen after upgrading. In case it doesn't, you can manually rebuild Hydrogen from the Panel that opens when executing Incompatible Packages: View via the control palette.

    Y'all tin can also admission this Console by clicking on the tiny blood-red problems icon at the bottom right of Cantlet.

    fullscreen-tiny-bug tiny-bug

    In instance the Atom GUI Rebuild Packages button doesn't work, yous can try running apm rebuild hydrogen (to rebuild) or apm install hydrogen (to reinstall) in the parcel directory then restarting Atom to resolve.

Setting environment variables on Windows

Hydrogen fails to import modules:

If hydrogen works for standard libraries but you come across ModuleNotFoundError: No module named 'your_package' for custom installed packages, check that the path of the kernel you are using is the one specified in the windows PATH. Especially when using virtual environments like virtualenv and anaconda ensure that the respective python executables are fix in the windows path.

To add the path, enter where python in the windows command line and chose the apporiate entry. And then, add it manually to the windows PATH, similarly as detailed below for the standard python path.

Hydrogen does not recognize python:

On Windows if Python is not added to your environment variables, Hydrogen won't be able to locate your Python installations (No kernel specs found).

Kernel specs not found

To solve this problem yous demand to add Python to your systems environment variables. This tin be done in 2 ways:

  • During Python installation
  • Manually adding in the Environment variables

During Python installation:

While installing Python bank check Add together Python to environs variables. It will do the rest of piece of work for y'all!

Python setup Wizard

If you already take Python installed then you may non need to uninstall it just follow the steps:

  • Become to the Uninstall or Alter a Programme Carte
  • Select your Python version
  • Click on the Uninstall/Change button
  • Select Alter from the appeared menu
  • Click on Adjacent
  • Bank check mark Add python to environment variables
  • And end the installation process

Adding python to system environment variables

Manually adding Python to Environment variables:

You lot can also add Python to the environment variables manually

  • In Control Panel search for environment variables
  • Click on Edit system surround variables
  • Click on Environment variables
  • From the System variables tab select Path and click on Edit
  • Click on New and add C:\Programme Files\Python36\Scripts\
  • Click on New once more and add together C:\Program Files\Python36\
  • Click on OK to finish, now your problem is fixed!

Adding environment Variables manually

You should see something like this,

Result

results matching ""

    No results matching ""