Basic configuration

You should find your .ipython directory first. Go to ~/.ipython (in Linux) or ~/_ipython (in win32).

There you will find (at the point of writing this) files ipy_user_conf.py and ipy_profile_sh.py. The user_conf is always imported (executed), while ipy_profile_sh.py is executed when you start ipython by ipython -p sh (i.e. you select the profile "sh", for shell like operation).

An example ipy_user_conf.py:

import IPython.ipapi
ip = IPython.ipapi.get()

def main():
    import ipy_jed_conf
    o = ip.options()

    # An example on how to set options
    o.autocall = 1

main()

This sets the "autocall" config variable (as described elsewhere in the manuals) to 1.

If you include

import ipy_defaults

to your config file (as done in ipy_profile_sh.py), you can basically ignore the old style ipythonrc configuration altogether and do everything in the new python-based config system. You should make your ipythonrc (or ipythonrc.ini) empty in that case to not confuse the source of config settings (because ipythonrc is still parsed for backwards compatibility reasons).