==========================
Frequently asked questions
==========================

.. contents::
   :local:
   :depth: 1

.. _anaconda-faq-35:

How do I get Anaconda with Python 3.5?
======================================

There are three ways to get Anaconda with Python 3.5:

* We recommend that you download the latest version of Anaconda and then `make a Python 3.5 environment <https://conda.io/docs/py2or3.html>`_.

* Or download the latest version of Anaconda and run this command to install Python 3.5 in the root environment: ``conda install python=3.5``

* Or download the most recent Anaconda that included Python 3.5 by default, Anaconda 4.2.0. You can download it from our `archive <https://repo.continuum.io/archive/>`_. Scroll down the page until you find version 4.2.0 for your platform.


How do I get previous versions of Anaconda or older versions of packages?
=========================================================================

You can download previous versions of Anaconda from the `Anaconda
installer archive <https://repo.continuum.io/archive/>`_.

The installation procedures for previous versions are the same as the
installation for the current version. For graphical installs, double click
the downloaded installer file and follow the prompts. For command line
installs, run "bash filename.sh" and follow the prompts. The installer
filenames and hashes for previous versions will be different.

Older versions of packages can usually be downloaded from the `package
repository <https://repo.continuum.io/pkgs/>`_ or from
``https://anaconda.org/anaconda/PackageName``.

NOTE: Replace ``PackageName`` with the name of the desired package.

EXAMPLE: At https://anaconda.org/anaconda/beautifulsoup4 , previous versions of
beautifulsoup4 are shown on the **Files** tab.

You can also search for packages from the command line with
``conda search PackageName``.

NOTE: Replace ``PackageName`` with the name of the desired package.


I am behind a firewall. How can I download Anaconda?
====================================================

If your corporate security settings do not allow you to download a Windows .exe executable file,
download our `zipped file <https://repo.continuum.io/archive/.winzip/>`_.

.. _distribution-faq-air-gap:

How can I install Anaconda on an air gapped computer?
=====================================================

After you have the file, it's the same as any other install. Save a local copy
of the appropriate Anaconda installer for the non-networked computer. You can
copy the Anaconda installer using many different methods including a portable
hard drive, USB drive or CD.

After copying the installer to the air gapped machine, follow the
installation instructions for your operating system.


.. _distribution-faq-windows-folder:

In what folder should I install Anaconda on Windows?
====================================================

We recommend installing Anaconda or Miniconda into a directory that contains only 7-bit
ASCII characters and no spaces, such as ``C:\anaconda``. Do not install into paths
that contain spaces such as ``C:\Program Files`` or that include ``Unicode`` characters
outside the 7-bit ASCII character set. This helps ensure correct operation and
no errors when using any open source tools in either Python 3 or Python 2 conda
environments.

.. _distribution-faq-windows-path:

Should I add Anaconda to the Windows PATH?
==========================================

When installing Anaconda, we recommend that you do not add Anaconda to the
Windows PATH because this can interfere with other software. Instead, open
Anaconda with the Start Menu and select Anaconda Prompt, or use Anaconda
Navigator (Start Menu - Anaconda Navigator).

.. _distribution-faq-linux-path:

Should I add Anaconda to the macOS or Linux PATH?
=================================================

When installing Anaconda, we recommend that you do add Anaconda to the PATH
if you answer "No" during installation to the question "Do you wish the
installer to prepend the Anaconda<2 or 3>install location to PATH in your
``/home/<user>/.bashrc``?". Conda will not work until you add the PATH manually.

To add the PATH manually, open a text editor and open the file .bashrc or
.bash_profile from your home directory.  Add the line ``export PATH="/<path to anaconda>/bin:$PATH"``.

NOTE: Replace <path-to-anaconda> with the actual path of your installed
anaconda file.

Save the file. If you have any terminal windows open, close them all then open
a new one. You may need to restart your computer for the PATH change to take
effect.

What is the default path for installing Anaconda?
=================================================

If you accept the default option to install Anaconda on the "default path"
Anaconda is installed in your user home directory:

* Windows 10: ``C:\Users\<your-username>\Anaconda3\``
* macOS: ``/Users/<your-username>/anaconda3``
* Linux: ``/home/<your-username>/anaconda3``

NOTE: If your username includes spaces, as is common on Windows systems, you
should not accept the default path. See :ref:`distribution-faq-windows-folder`.

How can I use Anaconda on older Macintosh systems?
==================================================

* For macOS 10.5 and macOS 10.6, use the command line installers for Anaconda
  versions 1.8 and earlier. NOTE: These installer files end in ``.sh``, not
  ``.pkg``. Download from our `archive <https://repo.continuum.io/archive/>`_.

* For macOS 10.7 and macOS 10.8, use the command line installers for Anaconda
  versions 4.2 and earlier. Download from our
  `archive <https://repo.continuum.io/archive/>`_.

* For macOS 10.9, use the command line or graphical installers for Anaconda
  versions 5.1 and earlier. Download from our
  `archive <https://repo.continuum.io/archive/>`_. Qt and other packages
  released after Anaconda Distribution 5.1's release date of February 15th,
  2018 may not work on macOS 10.9, so it may be necessary not to update certain
  packages beyond this point.

How can I configure or opt out of the Intel Math Kernel Library (MKL)?
======================================================================

For information on configuring and uninstalling MKL, see the
:doc:`Anaconda MKL documentation <../mkl-optimizations/index>`.


How can I use TKinter?
======================

Make sure the conda package ``tk`` is installed::

  conda list tk

If it is not installed, run::

  conda install tk

Python programs can use TKinter with ``import Tkinter`` on Python 2 or ``import tkinter``
on Python 3.


How can I use Cython on macOS?
==============================

Cython needs a C compiler, so you need to install `Xcode <https://developer.apple.com/xcode/>`_.


How can I use Theano?
=====================

Theano requires `gcc <https://gcc.gnu.org/>`_ for acceleration.

To install Theano with acceleration:

* On Windows, run ``conda install theano``.

* On Linux and macOS run ``conda install gcc theano``.

NOTE: Theano is available from the default Anaconda channels for Windows,
macOS and Linux with the command ``conda install theano``.


How is CPython compiled?
=========================

* Python 2.6 and 2.7 were compiled with Visual Studio 2008.
* Python 3.3 and 3.4 were compiled with VS 2010.
* Python 3.5 was compiled with VS 2015.

How do I cite Anaconda in an academic paper?
=============================================

To cite Anaconda in an academic paper, use the recommended format. Example:

*Anaconda Software Distribution*. Computer software. Vers. 2-2.4.0. Anaconda, Nov. 2016. Web. <https://anaconda.com>.
