Continuum Analytics: Documentation

# Anaconda install

On MS Windows, OS X, and Linux, it is best to install Anaconda for the local user, which does not require administrator permissions and is the most robust type of installation. For users on any of the three platforms who need to do so, Anaconda can also be installed system wide, which does require administrator permissions.

TIP: If you don’t want the hundreds of packages included with Anaconda, you can download Miniconda, a mini version of Anaconda that includes just conda, its dependencies, and Python.

## Anaconda for Windows install

Download the Anaconda installer.

Optional: Verify data integrity with MD5 or SHA-256. more info on hashes

Double click the Anaconda installer and follow the prompts to install to the default location.

NOTE: Do not install as Administrator unless admin privileges are required.

NOTE: If you encounter any issues during installation, please temporarily disable your anti-virus software during install, then immediately re-enable it.

After a successful installation you will see output like this:

When your install is complete, jump to Verify your install

## Anaconda for OS X graphical install

1. Download the Anaconda installer.

2. Optional: Verify data integrity with MD5 or SHA-256. more info on hashes

3. Double click the .pkg file. Answer the prompts on Introduction, Read Me, and License screens.

4. On Destination Select screen, you must select “Install for me only.”

   IMPORTANT: If you get the error message “You cannot install Anaconda in this location”, reselect “Install for me only”.

5. On “Installation Type” you may choose to install in another location. Standard install will put Anaconda in your home user directory .

   NOTE: Advanced users may select “customize” to not add Anaconda to the bash PATH:

6. Click the Install button.

After a successful installation you will see output like this:

When your install is complete, begin using Anaconda with the instructions in What’s next?

## Anaconda for OS X command line install

1. Go to the DOWNLOAD ANACONDA NOW page. Beneath the “Graphical Installer” buttons for Anaconda for OS X, there are command-line text links for Python versions 2.7 and 3.5.

2. Download the command line installer for Anaconda with Python 2.7 or Anaconda with Python 3.5.

3. Optional: Verify data integrity with MD5 or SHA-256. more info on hashes

4. Python 2.7: Open the Terminal.app or iTerm2 terminal application and enter the following:

   `bash ~/Downloads/Anaconda2-4.0.0-MacOSX-x86_64.sh`

   Or for Python 3.5 enter the following:

   `bash ~/Downloads/Anaconda3-4.0.0-MacOSX-x86_64.sh`

   NOTE: You should include the `bash` command regardless of whether you are actually using the bash shell.

The output of a successful installation will include the messages “Installation finished.” and “Thank you for installing Anaconda!”

When your install is complete, begin using Anaconda with the instructions in What’s next?

## Linux install

In your browser download the Anaconda installer for Linux.

Optional: Verify data integrity with MD5 or SHA-256. more info on hashes

Open a terminal window and type the following:

    bash ~/Downloads/Anaconda3-4.0.0-Linux-x86_64.sh

NOTE: Replace ~/Downloads with your actual path and Anaconda3-4.0.0-Linux-x86_64.sh with your actual file name.

NOTE: Accept the default location or select a user-writable install location such as `~/anaconda`.

NOTE: Install Anaconda as a user unless root privileges are required.

Follow the prompts on the installer screens, and if unsure about any setting, simply accept the defaults, as they can all be changed later.

NOTE: If you select the option to not add the Anaconda directory to your bash shell PATH environment variable, you may later add this line to the file .bashrc in your home directory: `export PATH="/home/username/anaconda/bin:$PATH"` Replace /home/username/anaconda with your actual path.

The output of a successful installation will include the messages “Installation finished.” and “Thank you for installing Anaconda!”

Finally, close and re-open your terminal window for the changes to take effect.

When your install is complete, begin using Anaconda with the instructions in What’s next?

## Silent mode install

You can use silent mode to automatically accept default settings and have no screen prompts appear during install.

## Uninstall Anaconda

There are two ways to uninstall Anaconda. You can do a simple remove of the program, or download and use the Anaconda-Clean program to remove the program and any program configuration files.

### Simple remove

WINDOWS: In the Control Panel, choose “Add or Remove Programs” or “Uninstall a program” and then select “Python 3.5 (Anaconda)” or your version of Python.

OS X: Open the Terminal.app or iTerm2 terminal application and remove your entire Anaconda directory, which will have a name such as “anaconda2” or “anaconda3”, by entering the following command: `rm -rf ~/anaconda3`

LINUX: Open a terminal window and remove your entire Anaconda directory, which will have a name such as “anaconda2” or “anaconda3”, by entering the following command: `rm -rf ~/anaconda3`

### Anaconda-Clean remove

On all systems, remove Anaconda by opening a terminal window (on Windows: Start - Command Prompt) and install the conda package:

> conda install anaconda-clean

Next, in the same window, run Anaconda-Clean with one of these three options:

- Remove all Anaconda-related files and directories with a prompt to answer “yes” before deleting each one (type “clean”)
- Remove all Anaconda-related files and directories without being prompted to delete each one (type “clean –yes”)
- Remove all Anaconda-related files and directories and create a backup copy of the file/directory in a .anaconda_backup folder in your home directory (type “clean –backup”)

## Updating from older Anaconda versions

You can easily update to the latest Anaconda version by updating conda, then Anaconda as follows:

    conda update conda
    conda update anaconda

## Verify your install

On all systems, you can confirm that Anaconda is installed and working by opening a terminal window (on Windows: Start - Command Prompt) and entering a command such as ‘conda list’. If Anaconda is installed and working, this will display a list of installed packages and their versions.

Another way to confirm that Anaconda is installed and working by opening a terminal window (on Windows: Start - Command Prompt) and entering the command ‘python’ to run the Python shell. If Anaconda is installed and working, the version information it displays when it starts up will include “Continuum Analytics, Inc.”. Use the command ‘quit()’ to exit the Python shell.

## What’s next?

If you had any trouble with installation, please see the information on Anaconda support.

If you are new to Anaconda and the conda package manager, we recommend you try the Anaconda Navigator, the easy graphical interface for working with Anaconda.

If you prefer to use a terminal window or command prompt, download the conda cheat sheet, try the conda test drive, and learn more about using conda.

For examples of data science and data visualization using Anaconda, see the Continuum Analytics developer blog, which has examples such as using Anaconda and Datashader to map US Census data and using Anaconda and Bokeh to analyze data from firefighter helmet sensors.