Spyder Installation Guide

[Keith Cogswell]

Ifyou 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!

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.Visit the Spyder Binder to get started using Spyder.

The standalone installers are our recommended method for most users on Windows and macOS, with experimental Linux support under active development.They work like any other IDE, where Spyder can be installed and updated independently of the Python environments you use to run your code.This avoids the problems with incompatible packages and broken installations users often face when mixing Spyder with the (Conda, etc) environments they use to run their code.

The standalone installers do not yet support installing third-party Spyder plugins not already bundled with them, though this feature is currently under development.For now, if you need this capability, we recommend a Conda-based distributions.

To download the supported Spyder installer for your platform, simply click the appropriate link below (for Linux, see the Conda-based distributions section).Then, double-click the downloaded file to open the installer.If a security warning pops up, you may need to click Yes, OK, Open, Allow or similar.

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.It can also be easily installed in the much lighter-weight Miniconda and Miniforge/Mambaforge, which include just Python and the Conda/Mamba package and environment manager by default (with Miniforge defaulting to the Conda-Forge channel, and Mambaforge using Mamba, a much faster alternative to Conda).This is our recommended installation method on Linux and for users with third-party Spyder plugins, as support for both of these in our standalone installers is still under active development.

You can then run Spyder by the same methods as with Anaconda, except that you need to make sure to launch 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.

With any Conda-based distribution and Spyder installed in its own environment (recommended), update Conda itself, active the environment, and finally update Spyder.In your system terminal (or Anaconda Prompt if on Windows), run:

The bundled Spyder version can often be quite out of date, missing new features and bug fixes from the latest version, and if you install, change or remove other packages, there is a significant chance of dependency conflicts or a broken Spyder installation.Therefore, we recommend installing Spyder into a new Conda environment to avoid all these issues.

To run the bundled version of 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.

These commands also update all your other packages, which is one reason we strongly recommend you use an isolated conda environment to avoid any potential unintended effects on other installed packages.

While this installation method is a viable option for experienced users, installing Spyder (and other PyData-stack packages) with pip can sometimes lead to tricky issues, particularly on Windows and macOS.While you are welcome to try it on your own, we are typically not able to provide individual support for installation problems with pip, except to recommend our Standalone installers (Windows and macOS) or a Conda-based distributions.

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

While we describe alternative Spyder installation options for users who prefer them, as these are third-party distributions that we have no direct involvement in, we are usually not able to offer useful individual assistance for problems specific to installing via these alternative methods.

Spyder is included in the WinPython scientific Python distribution, along with many other common numerical computing and data analysis packages.You can use Spyder immediately after installing, similar to Anaconda.

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

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.

Spyder is a free and open source scientific environment written in Python, for Python, and designed by and for scientists, engineers and data analysts.It features a unique combination of the advanced editing, analysis, debugging, and profiling functionality of a comprehensive development tool with the data exploration, interactive execution, deep inspection, and beautiful visualization capabilities of a scientific package.

Want to join the community of scientists, engineers and analysts all around the world using Spyder?Click the button below to download the suggested installer for your platform.We offer standalone installers on Windows and macOS, and as our Linux installer is are still experimental, we currently recommend the cross-platform Anaconda distribution for that operating system, which includes Spyder and many other useful packages for scientific Python.You can also try out Spyder right in your web browser by launching it on Binder.

The built-in interpreter of the standalone version doesn't currently support installing packages beyond the common scientific libraries bundled with it, so most users will want to have an external Python environment to run their own code, like with any other IDE.Also, the standalone installers don't yet work with third-party plugins, so users needing them should use Spyder through a Conda-based distribution instead.For a detailed guide to this and the other different ways to obtain Spyder, refer to our full installation instructions, and check out our release page for links to all our installers.Happy Spydering!

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

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.

To download the supported Spyder installer for your platform, simply click the appropriate link below.(For Linux, see the Anaconda section).Then, double-click the downloaded file to open the installer.If a security warning pops up, you may need to click Yes, OK, Open, Allow or similar.

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, and is our recommended installation method on Linux (and supported on the other platforms too).

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.

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:

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.

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 our standalone installers (Windows and macOS) or Anaconda if you encounter installation issues you are unable to solve on your own.

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

3a8082e126