How to load/edit/run/save text files (.py) into an IPython notebook cell?


I’ve recently moved over to using IPython notebooks as part of my workflow. However, I’ve not been successful in finding a way to import .py files into the individual cells of an open IPython notebook so that they can edited, run and then saved. Can this be done?

I’ve found this in the documentation which tells me how to import .py files as new notebooks but this falls short of what I want to achieve.

Any suggestions would be much appreciated.

Asked By: aaronsstack



Drag and drop a Python file in the Ipython notebooks “home” notebooks table, click upload. This will create a new notebook with only one cell containing your .py file content

Else copy/paste from your favorite editor 😉

Answered By: Raphaël Braud

I have found it satisfactory to use ls and cd within ipython notebook to find the file. Then type cat your_file_name into the cell, and you’ll get back the contents of the file, which you can then paste into the cell as code.

Answered By: RussellStewart

EDIT: Starting from IPython 3 (now Jupyter project), the notebook has a text editor that can be used as a more convenient alternative to
load/edit/save text files.

A text file can be loaded in a notebook cell with the magic command %load.

If you execute a cell containing:


the content of will be loaded in the next cell. You can edit and execute it as usual.

To save the cell content back into a file add the cell-magic %%writefile at the beginning of the cell and run it. Beware that if a file with the same name already exists it will be silently overwritten.

To see the help for any magic command add a ?: like %load? or %%writefile?.

For general help on magic functions type “%magic”
For a list of the available magic functions, use %lsmagic. For a description
of any of them, type %magic_name?, e.g. ‘%cd?’.

See also: Magic functions from the official IPython docs.

Answered By: user2304916

To write/save


  • write/save cell contents into (use -a to append). Another alias: %%file

To run


  • run and output results in the current cell

To load/import


  • load "import" into the current cell

For more magic and help


  • list all the other cool cell magic commands.


  • for help on how to use a certain command. i.e. %run?


Beside the cell magic commands, IPython notebook (now Jupyter notebook) is so cool that it allows you to use any unix command right from the cell (this is also equivalent to using the %%bash cell magic command).

To run a unix command from the cell, just precede your command with ! mark. for example:

  • !python --version see your python version
  • !python run and output results in the current cell, just like %run (see the difference between !python and %run in the comments below).

Also, see this nbviewer for further explanation with examples.

Answered By: Aziz Alto

I have not found a satisfying answer for this question, i.e how to load edit, run and save. Overwriting either using %%writefile or %save -f doesn’t work well if you want to show incremental changes in git. It would look like you delete all the lines in and add all new lines, even though you just edit 1 line.

Answered By: Quynh Nguyen

to write in a file that exists or not use the following


to append to a file use -a argument

%%writefile -a

when you load the file

Answered By: Abdullah Megahed