Installation Guide¶

Spyder is relatively like shooting fish in a barrel to install on Windows, Linux and macOS. Just make sure to read and follow these instructions with care.

If you meet problems, before posting a written report, please consult our comprehensive troubleshooting guide and search the effect tracker for your mistake message and problem description. These methods by and large set or isolate the great majority of install-related difficulties. Thanks!

Of import

Spyder now offers standalone installers for Windows and macOS, making it easier to get up and running with the awarding without having to download Anaconda or manually install it in your existing surroundings. While we still support Anaconda, nosotros recommend this install method on those platforms to avoid nearly issues with package conflicts and other issues.

Try Spyder online¶

Want to try out Spyder without installing information technology? With Folder you can work with a fully functional re-create 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

Standalone installers¶

Our standalone installers for Windows and macOS are available from Spyder 4.two onwards. We recommend using this installation method on those platforms, just we offer several other options for Linux, advanced users and specific needs, so go along reading if that's the case for you.

Downloading and installing¶

To download the supported Spyder installer for your platform, simply click the advisable link below. (For Linux, meet the Anaconda section). And then, double-click the downloaded file to open the installer. If a security warning pops up, you lot may need to click Yeah, OK, Open, Permit or similar.

On Windows, if a SmartScreen dialog appears, click More info followed by Run anyway, and and so proceed through the steps in the installer.

On macOS, open up the disk image and elevate Spyder to your Applications folder.

Windows Installer

macOS Installer

Note

"Low-cal" versions of both installers are besides bachelor from the releases page, which are somewhat smaller than the full installers. These lack a number of optional but recommended dependencies, such as NumPy, SciPy and Pandas, meaning that a few Variable Explorer features, including graphical data import wizards and support for rich brandish and editing of NumPy arrays and Pandas DataFrames, will not be available. Given this merely saves a pocket-sized amount of space while missing out on pregnant features, we recommend using the total installers unless minimizing download/install size and memory usage is a priority.

Running from a standalone install¶

To run Spyder when installed standalone, you can simply use your operating system's typical method of launching applications, such every bit opening it from the First menu on Windows (or the Taskbar, if you lot've pinned it in that location), or from Launchpad, Spotlight or the Applications folder on macOS (or the Dock, if yous've added information technology there).

On macOS, the kickoff time you open Spyder, you may see a message that information technology cannot be opened because the developer cannot be verified. If so, right-click on the application, select Open, so click Open in the resulting dialog, and the warning will no longer be shown. You can also click Open Anyway under in System Preferences.

For more than information on installing your own packages and using standalone Spyder with your existing Python environments, encounter our FAQ.

Anaconda¶

Spyder is included by default in the Anaconda Python distribution, which comes with everything you lot need to get started in an all-in-ane packet, and is our recommended installation method on Linux (and supported on the other platforms too).

Running with Anaconda¶

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

Anaconda Navigator showing Spyder

If Spyder does non launch via this method or y'all adopt to use the command line, open Anaconda Prompt (Windows) or your final (other platforms), type conda actuate base and then spyder .

New Conda surround¶

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

                conda create -n spyder-env                spyder                =                four

To install Spyder's optional dependencies likewise for full functionality, use the following command instead:

                conda create -n spyder-env                spyder                =                iv                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 certain to select the starting time carte du jour shortcut with (spyder-env) in the name, select the spyder-env environment on the left before launching it with Navigator, or blazon 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 come across our Guide to working with packages and environments in Spyder.

Alternative methods¶

Caution

While we offering alternative Spyder installation options for users who want them, we currently lack the resources to offer individual assistance for issues specific to installing via these alternative distributions. Therefore, we recommend you switch to our standalone installers (Windows and macOS) or Anaconda if y'all encounter installation bug you are unable to solve on your ain.

Windows¶

Spyder is included in the WinPython scientific Python distribution (although Anaconda'south conda package and environment manager is not). Y'all tin use Spyder immediately later installing, merely similar with Anaconda.

macOS¶

Thanks to the MacPorts project, Spyder tin can be installed using its port packet manager; nonetheless, the included Spyder version may be out of date or take MacPorts-specific issues outside of Spyder's command.

In that location are several versions available from which yous tin can choose.

Linux¶

Warning

Distribution packages are created by third parties, are often outdated relative to the current Spyder release, and may comprise bugs and be missing features relative to the current supported version. Every bit such, given nosotros are not able to provide official back up for them, we strongly recommend using Anaconda on Linux whenever practical (or pip, for advanced users).

Spyder can be installed via third-party distro packages on most mutual Linux distributions.

Running Spyder installed this way will generally be the aforementioned as any other distro-installed application. Alternatively, it can be launched from the concluding with spyder (or spyder3 , on older versions of some distros).

Other distributions¶

Spyder is as well available in other GNU/Linux distributions, like

  • Arch Linux

  • Fedora

  • Gentoo

  • openSUSE

Delight refer to your distribution's documentation for how to install Spyder.

Using pip¶

Warning

While this installation method is a feasible option for experienced users, installing Spyder (and other PyData-stack packages) with pip can atomic number 82 to a number of tricky issues, specially on Windows and macOS. While you are welcome to attempt this on your ain, we unfortunately do not have the resources to help you if you do run into problems, except to recommend our standalone installers (Windows and macOS) or Anaconda.

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

Annotation

Due to a known issue with some DEB-based Linux distributions (Debian, Ubuntu, Mint), you might besides need to install the pyqt5-dev-tools package get-go, with sudo apt install pyqt5-dev-tools .

You'll first desire to create and activate a virtual surroundings in which to install Spyder, via i of the post-obit methods.

With virtualenvwrapper :

              mkvirtualenv spyder-env workon spyder-env

Otherwise, on macOS/Linux/Unix:

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

or on Windows:

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

Later on 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 nether Python 2.

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

Updating Spyder¶

To update Spyder installed via our standalone packages on Windows and macOS, you'll currently need to manually download and install the latest release (if on Windows, make sure to remove the old version beginning from Control Panel/Organisation Settings).

If you installed Spyder through Anaconda, WinPython, MacPorts, or your arrangement bundle manager, update using those same methods. With Anaconda, just run (in Anaconda Prompt if on Windows, otherwise in your organization final):

              conda update anaconda conda update spyder

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

Development builds¶

If you desire to attempt the next Spyder version before information technology is released, you lot can! Y'all may desire to do this for fixing bugs in Spyder, adding new features, learning how Spyder works or simply getting a taste of what the IDE tin can do. For more than data, delight come across the Contributing Guide included with the Spyder source or on Github, and for further detail consult the Spyder evolution wiki.

Additional assist¶

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

Looking for general data virtually Spyder and its ecosystem? Run into our main website.

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

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

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

Seeking personalized aid from adept Spyder consultants? Visit OpenTeams.