NOTE: The contents of this page are obsolete. Please see for installation instructions.

EMAN2 Mac OS X Visual Install Guide

This guide is intended for users who are new to the UNIX shell environment.

1. Copy the "EMAN2" folder to Applications


2. Configure shell environment

EMAN2 needs to be added to some shell environment variables (PATH, PYTHONPATH, etc.) to run. The "bash" shell is the default on Mac OS X, so we will add EMAN2's init script to bash's ".profile" file in your home directory. Add this line to your ".profile" file.

test -r /Applications/EMAN2/eman2.bashrc && source /Applications/EMAN2/eman2.bashrc

One easy way to open your ".profile" file for editing is with the following command:

touch ~/.profile; open -e ~/.profile

This will create the file if it doesn't exist, and open it in your default text editor. Add the EMAN2 init line and save the file.


This only needs to be done once. If you download a newer version of EMAN2, you can skip this step. Also, if you run an alternative shell, such as tcsh, see notes below.

IMPORTANT NOTE: If you already have a file called .bash_profile or .bash_login in your home directory, those files will be used in preference to .profile, and .profile may never get read. If you have one of these files, you should add the statement above to that file instead of .profile.

3. Run EMAN2

Restart your terminal program for a fresh shell. EMAN2 should now be installed and function properly.

You can check that your EMAN2 installation is working by running:

If anything doesn't work as it should, please provide the full output of (even if it's an error) with your help request.

To run EMAN2's graphical project interface, "cd" to a data directory and run ""


If you get a 'Bad Interpreter' error

It is probably due to Mountain Lion's new quarantining process. You can try this:

xattr -dr /Applications/EMAN2

Alternatively, you may have installed the wrong EMAN2 package for your operating system. Due to different Python versions, make sure you use the correct Mac OS X 10.6 build, or the Mac OS X 10.7 / 10.8 build.

Installing EMAN2 in my home directory

If you do not have Administrator privileges on your system or want to install EMAN2 in your home directory, you will want to modify the eman2.bashrc file to reflect the correct path to EMAN2 in the EMAN2DIR variable, e.g.:

export EMAN2DIR=/Users/irees/EMAN2

Other shells

If you run tcsh as your shell, the shell init file is "~/.cshrc", and the EMAN2 init script is eman2.cshrc:

test -r /Applications/EMAN2/eman2.cshrc && source /Applications/EMAN2/eman2.cshrc

EMAN2/Install/BinaryInstall_OSXVisualGuide (last edited 2015-06-05 19:07:36 by MichaelBell)