EIN -- Emacs IPython Notebook

Emacs IPython Notebook (EIN) lets you run Jupyter (formerly IPython) notebooks within Emacs. It channels all the power of Emacs without the idiosyncrasies of in-browser editing.

EIN is not tested on Doom or Spacemacs. There are known issues with both.

Org users please find ob-ein, a jupyter Babel backend.

EIN was originally written by [tkf]. A jupyter Babel backend was first introduced by [gregsexton].

Install

Clone this repo and make install. You will need Cask.

Usage

Start EIN using one of the following:

Open an .ipynb file normally in emacs and press C-c C-o, or,
M-x ein:run launches a jupyter process from emacs, or,
M-x ein:login to a running jupyter server

Use C-u M-x ein:login for services such as mybinder.org requiring cookie authentication.

Alternatively, ob-ein.

Reporting bugs

EIN is tested on GNU Emacs versions emacs-25-2 and later.

Please file issues using M-x ein:dev-bug-report-template.

You may also try to self-diagnose.

First invoke M-x ein:dev-start-debug. Then reproduce the error.

General logging M-x ein:log-pop-to-all-buffer.

Notebook server M-x ein:log-pop-to-request-buffer.

Kernel messaging (must be run from notebook buffer) M-x ein:dev-pop-to-debug-channels.

ob-ein

Configuration:

M-x customize-group RET org-babel
Org Babel Load Languages:
  Insert (ein . t)
  For example, '((emacs-lisp . t) (ein . t))

Snippet:

#BEGIN_SRC ein-python :session localhost :results raw drawer
  import numpy, math, matplotlib.pyplot as plt
  %matplotlib inline
  x = numpy.linspace(0, 2*math.pi)
  plt.plot(x, numpy.sin(x))
#+END_SRC

The :session is the notebook url, e.g., http://localhost:8888/my.ipynb, or simply localhost, in which case org evaluates anonymously. A port may also be specified, e.g., localhost:8889.

Language can be ein-python, ein-r, or ein-julia. The relevant jupyter kernel must be installed before use. Additional languages can be configured via:

M-x customize-group RET ein
Ob Ein Languages

Keymap (C-h m)

key             binding
---             -------

C-c          Prefix Command
C-x          Prefix Command
ESC          Prefix Command
C-:          ein:shared-output-eval-string-km
<C-down>     ein:worksheet-goto-next-input-km
<C-up>               ein:worksheet-goto-prev-input-km
<M-S-return> ein:worksheet-execute-cell-and-insert-below-km
<M-down>     ein:worksheet-move-cell-down-km
<M-up>               ein:worksheet-move-cell-up-km

C-x C-s              ein:notebook-save-notebook-command-km
C-x C-w              ein:notebook-rename-command-km

M-RET                ein:worksheet-execute-cell-and-goto-next-km
M-,          ein:pytools-jump-back-command
M-.          ein:pytools-jump-to-source-command
M-n          ein:worksheet-next-input-history-km
M-p          ein:worksheet-previous-input-history-km

C-c C-a              ein:worksheet-insert-cell-above-km
C-c C-b              ein:worksheet-insert-cell-below-km
C-c C-c              ein:worksheet-execute-cell-km
C-c C-e              ein:worksheet-toggle-output-km
C-c C-f              ein:file-open-km
C-c C-h              ein:pytools-request-tooltip-or-help-km
C-c C-k              ein:worksheet-kill-cell-km
C-c C-l              ein:worksheet-clear-output-km
C-c RET              ein:worksheet-merge-cell-km
C-c C-n              ein:worksheet-goto-next-input-km
C-c C-o              ein:notebook-open-km
C-c C-p              ein:worksheet-goto-prev-input-km
C-c C-q              ein:notebook-kill-kernel-then-close-command-km
C-c C-r              ein:notebook-reconnect-session-command-km
C-c C-s              ein:worksheet-split-cell-at-point-km
C-c C-t              ein:worksheet-toggle-cell-type-km
C-c C-u              ein:worksheet-change-cell-type-km
C-c C-v              ein:worksheet-set-output-visibility-all-km
C-c C-w              ein:worksheet-copy-cell-km
C-c C-x              Prefix Command
C-c C-y              ein:worksheet-yank-cell-km
C-c C-z              ein:notebook-kernel-interrupt-command-km
C-c ESC              Prefix Command
C-c !                ein:worksheet-rename-sheet-km
C-c +                ein:notebook-worksheet-insert-next-km
C-c -                ein:notebook-worksheet-delete-km
C-c 1                ein:notebook-worksheet-open-1th-km
C-c 2                ein:notebook-worksheet-open-2th-km
C-c 3                ein:notebook-worksheet-open-3th-km
C-c 4                ein:notebook-worksheet-open-4th-km
C-c 5                ein:notebook-worksheet-open-5th-km
C-c 6                ein:notebook-worksheet-open-6th-km
C-c 7                ein:notebook-worksheet-open-7th-km
C-c 8                ein:notebook-worksheet-open-8th-km
C-c 9                ein:notebook-worksheet-open-last-km
C-c {                ein:notebook-worksheet-open-prev-or-last-km
C-c }                ein:notebook-worksheet-open-next-or-first-km
C-c C-S-l    ein:worksheet-clear-all-output-km
C-c C-#              ein:notebook-close-km
C-c C-$              ein:tb-show-km
C-c C-'              ein:worksheet-turn-on-autoexec-km
C-c C-,              ein:pytools-jump-back-command
C-c C-.              ein:pytools-jump-to-source-command
C-c C-/              ein:notebook-scratchsheet-open-km
C-c C-;              ein:shared-output-show-code-cell-at-point-km
C-c <down>   ein:worksheet-move-cell-down-km
C-c <up>     ein:worksheet-move-cell-up-km

C-c C-x C-r  ein:notebook-restart-session-command-km

C-c M-+              ein:notebook-worksheet-insert-prev-km
C-c M-w              ein:worksheet-copy-cell-km
C-c M-{              ein:notebook-worksheet-move-prev-km
C-c M-}              ein:notebook-worksheet-move-next-km

License

Emacs IPython Notebook is licensed under GPL v3. See COPYING for details.