Installation Guide

Spyder is relatively easy to install on Windows, Linux and macOS. Just make sure to read and follow these instructions with care.

If you run into problems, before posting a report, please consult our comprehensive Troubleshooting Guide and search the issue tracker for your error message and problem description. These methods generally fix or isolate the great majority of install-related difficulties. Thanks!

Try Spyder online

Want to try out Spyder without installing it? With Binder you can work with a fully functional copy of Spyder online that runs right in your web browser, no installation needed. Just visit the Spyder page on Binder to get started using Spyder now.

Spyder running on Binder

Using Anaconda

Important

If in doubt, you should install Spyder via this method; it generally has the least likelihood of potential pitfalls for non-experts, and we will be able to provide assistance if you do run into trouble.

Spyder is included by default in the Anaconda Python distribution, which comes with everything you need to get started in an all-in-one package.

This is the easiest way to install Spyder for any of our supported platforms, and the way we recommend to avoid unexpected issues we aren’t able to help you with.

Running Spyder

To run Spyder after installing it with Anaconda, the recommended method on Windows is to launch it via the Start menu shortcut. On other platforms, open Anaconda Navigator, scroll to Spyder under Home, and click Launch.

Anaconda Navigator showing Spyder

If Spyder does not launch via this method or you prefer to use the command line, open Anaconda Prompt (Windows) or your terminal (other platforms), type conda activate base then spyder.

New Conda environment

If you would like to have Spyder in a dedicated environment to update it separately from your other packages and avoid any conflicts, you can. Just run the following command in your Anaconda Prompt (Windows) or terminal (other platforms), for a minimal install of Spyder into a new environment called spyder-env:

conda create -n spyder-env spyder=4

To install Spyder’s optional dependencies as well for full functionality, use the following command instead:

conda create -n spyder-env spyder=4 numpy scipy pandas matplotlib sympy cython

To install Spyder from Conda-Forge instead of the default Anaconda channel, add -c conda-forge at the end of either of the previous commands.

You can then run Spyder by the same methods as above, except make sure to select the start menu shortcut with (spyder-env) in the name, select the spyder-env environment on the left before launching it with Navigator, or type conda activate spyder-env before launching it on the command line.

Running Spyder installation with conda

For more information on this approach, and using Spyder with your existing Python environments and packages, please see our Guide to working with packages and environments in Spyder.

Alternative methods

Caution

While we offer alternative Spyder installation options for users who desire them, we currently lack the resources to offer individual assistance for problems specific to installing via these alternative distributions. Therefore, we recommend you switch to Anaconda if you encounter installation issues you are unable to solve on your own.

Windows

Spyder is also included in the WinPython scientific Python distribution, although it doesn’t include Anaconda’s convenient conda package and environment manager like Anaconda. You can use it immediately after installing, just like with Anaconda.

macOS

Thanks to the MacPorts project, Spyder can be installed using its port package manager; however, the included Spyder version may be out of date or have MacPorts-specific issues outside of Spyder’s control.

There are several versions available from which you can choose.

Linux

Ubuntu

Using the official package manager:

sudo apt install spyder3

Note

The Ubuntu package is often outdated. If you find that is the case, please use the Debian package mentioned below, although it may also be out of date.

Debian Unstable

Using the package manager:

sudo apt install spyder3

Spyder’s official Debian package is available on the Debian package repository.

Other distributions

Spyder is also available in other GNU/Linux distributions, like

Please refer to your distribution’s documentation for how to install Spyder.

Running Spyder

How to launch Spyder after installation varies depending on your OS and install method, but with those featured here, it will generally be the same as for any other installed application. Alternately, you should be able to launch it from the terminal/command line with spyder or spyder3.

Using pip

Warning

While this installation method is a viable option for experienced users, installing Spyder (and other PyData-stack packages) with pip can lead to a number of tricky issues. While you are welcome to try this on your own, we unfortunately do not have the resources to help you if you do run into problems, except to recommend you use Anaconda instead.

You can install Spyder with the pip package manager, which comes by default with most Python installations. Before installing Spyder itself by this method, you need to acquire the Python programming language.

You’ll first want to create and activate a virtual environment in which to install Spyder, via one of the following methods.

With virtualenvwrapper:

mkvirtualenv spyder-env
workon spyder-env

Otherwise, on macOS/Linux/Unix:

python3 -m venv spyder-env
source spyder-env/bin/activate

or on Windows:

python -m venv spyder-env
spyder-env/Scripts/activate.bat

After activating your environment, to install Spyder and its other dependencies, run pip install spyder.

Running Spyder installation with pip

You may need to install a Qt binding (PyQt5) separately with pip if running under Python 2.

To launch Spyder after installing, ensure your environment is activated and run the spyder3 command.

Updating Spyder

If you installed Spyder through Anaconda (recommended), WinPython, MacPorts, or your system package manager, update using those same methods. With Anaconda, just run (in Anaconda Prompt if on Windows, otherwise in your system terminal):

conda update anaconda
conda update spyder

If you installed Spyder via the advanced/cross-platform method, pip, run pip install --upgrade spyder. This command will also update all Spyder dependencies, so we recommend you use an isolated virtual environment to avoid any potential unintended effects on other installed packages.

Development builds

If you want to try the next Spyder version before it is released, you can! You may want to do this for fixing bugs in Spyder, adding new features, learning how Spyder works or just getting a taste of what the IDE can do. For more information, please see the Contributing Guide included with the Spyder source or on Github, and for further detail consult the Spyder development wiki.

Additional help

Run in to a problem installing or running Spyder? Read our Troubleshooting Guide and FAQ.

Looking for general information about Spyder and its ecosystem? See our main website.

Need to submit a bug report or feature request? Check out our Github repository.

Want development-oriented help and information? Consult our Github wiki.

Have a help request or discussion topic? Subscribe to our Google Group.

Asking a quick question or want to chat with the dev team? Stop by our Gitter chatroom.