Posted on Oct 3rd, 2018

Some notes on setting up iPython on macOS.

Create a configuration file with the command shown below. The file will be located at ~/.ipython/profile_default/ipython_config.py. The settings in ipython_config.py apply to all iPython sessions. See the documentation at ipython.readthedocs.io for a full list of configuration options.

ipython profile create

In the newly created ipython_config.py file. Uncomment the following two lines and edit them as follows:

c.InteractiveShellApp.gui = 'osx'
c.InteractiveShellApp.matplotlib = 'osx'

As of Matplotlib version 3.0, a framework build of python is needed when using the osx backend with Matplotlib and iPython. This framework build can be invoked with pythonw rather than python (see here for more details). Run the following command to install the framework build:

conda install python.app

To run iPython with the framework build, you can point pythonw to the ipython path or create an alias in ~/.bash_profile as follows:

alias ipy="pythonw /Users/gavin/miniconda3/bin/ipython"