Skip to main content
Help us improve Python packaging – donate today!

IPython magic and CLI to manipulate the Python path

Project Description

pypath-magic provides a simple interface for adding modules and packages to your Python path. This page should provide a good overview, but you might also want to check out the original pypath-magic article and the article introducing the command-line interface

Unlike modifications to sys.path, this allows you to easily modify your path across sessions. Unlike modifications to environment variables, this doesn’t require you to explain to users, students, and colleagues how to modify environment variables.

Command-line interface

In addition to the namesake IPython magic interface, version 0.3 adds a command-line interface (CLI) that resembles the IPython interface. After installing the latest version (pip install pypath_magic), you’ll have access to a pypath command in your favorite terminal/shell.

An example IPython workflow with pypath-magic is described below. The CLI has a similar interface:

pypath <command> [PATH]

The standard commands are:

pypath add [PATH]       Add path to user's Python path.
pypath delete [PATH]    Delete path from user's Python path.
pypath [list]           List all paths defined by user.
pypath list-all         List all paths in user's Python path.
pypath path-file        Print path to user's path file.

Continue below to this in action for the IPython interface.

IPython magic

pypath-magic adds an IPython magic (err… Jupyter magic?) command for easily manipulating your Python path. To use the magic command, just load the extension from an IPython session:

In [1]: %load_ext pypath_magic

After loading, you will have access to the %pypath magic. You can type:

In [2]: %pypath

to list all the custom paths added by pypath-magic. When you get started, you won’t have anything there. To add some custom paths, just change to a directory and call %pypath -a:

In [3]: %cd path/to/my-repo

In [4]: ls

In [5]: %pypath -a
Added u'/absolute/path/to/my-repo' to path.

In [6]: %pypath

Now you can reuse those helper functions:

In [7]: from plot_helpers import plot_slope_marker

Changes to your python path will persist across IPython sessions, and those paths will be available outside of IPython. If you later want to delete a directory from your path, just use %pypath -d:

In [8]: %cd path/to/my-repo

In [9]: %pypath -d
Deleted u'/absolute/path/to/my-repo' from path.

You can also list your entire python path with %pypath -l:

In [10]: %pypath -l


For additional usage information, type:

In [11]: %pypath?


To install using pip:

$ pip install pypath_magic

To install from source:

$ git clone
$ cd pypath-magic
$ python install

If you get an error like:

error: invalid command 'egg_info'

you probably need to update setuptools:

pip install --upgrade setuptools


  • Python 2.7/3.4 (older versions probably work, but this is not tested)
  • IPython >= 1.1
  • setuptools >= 0.7


New BSD (a.k.a. Modified BSD). See LICENSE file in this directory for details.

Release history Release notifications

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
pypath_magic-0.3.1.tar.gz (7.2 kB) Copy SHA256 hash SHA256 Source None Jan 21, 2015

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page