Skip to main content
OpenIDEA opens .ipynb files in a notebook editor. You can edit code and Markdown cells, run them on a Python kernel that the IDE starts for you, and save the result back to the same file.

​
Requirements

  • A Python interpreter with ipykernel installed (pip install ipykernel). OpenIDEA never installs packages for you. If ipykernel is missing, the editor shows an error with the hint Install ipykernel in the selected Python environment, then restart the kernel.
  • A trusted project. Running cells is blocked while the project is in Restricted Mode.
  • Notebooks in nbformat 4. Other versions are refused and the file is left untouched.

​
Open a notebook

Open any .ipynb file from the Project tool window, Go to File or the command line. It opens in the notebook editor instead of as raw JSON. The toolbar at the top of the editor has:

​
Choose the Python interpreter

The interpreter list shows the Python environments OpenIDEA detects, plus the project interpreter. If you don’t pick one, the notebook uses the project’s Python interpreter, or the first detected environment. Your choice is remembered per notebook. Change it while no cell is running.
For a virtual environment, select its own python (for example .venv/bin/python). OpenIDEA does not resolve the symlink to the base interpreter, so the kernel runs inside the environment.
Each open notebook gets its own kernel process. Closing the notebook shuts its kernel down.

​
Edit cells

Every cell has a small toolbar:
  • Cell type list: Code, Markdown or Raw.
  • Run Cell (code cells), or Edit Markdown / Preview Markdown (Markdown cells). Double-click a rendered Markdown cell to edit it.
  • Move Cell Up, Move Cell Down, Insert Code Cell Below, Delete Cell.
Use Add Code Cell and Add Markdown Cell at the end of the notebook to append cells. Code cells show the execution count ([3]) next to the cell toolbar. Raw cells and cell types OpenIDEA doesn’t know are shown read-only; their content is kept as it is.

​
Keyboard

These keys are handled by the notebook editor itself and are not part of the keymap settings.

​
Outputs

Outputs are written into the notebook file when you save, the same way Jupyter does.

​
Limits

  • Only Python kernels are supported. Kernels for other languages and remote Jupyter servers are not.
  • Interactive widgets (ipywidgets) and JavaScript outputs do not run.
  • Undo and redo are not available while cells are running.