Spyder Installation Steps

[Fermina Enge]

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.

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, as these methods generally fix or isolate the great majority of install-related complaints.Thanks!

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.

While this installation method is a viable option for experienced users, installing Spyder (and other SciPy 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.

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) conda update anaconda to update the distribution as a whole and conda update spyder to update Spyder specifically.

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 virtualenv or venv environment to avoid any potential unintended effects on other installed packages.

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.md document included with the Spyder source or on Github, and for further detail consult the Spyder development wiki.

The recommended and easiest way to do this is with conda (although experts may prefer pip). In a fresh environment (conda create -n your-name-here -c conda-forge python=3, then activate it), run the following:

(and using the same respective command, replacing 1 with 0, to switch back to the Spyder 3 version), or by clone-ing the spyder-kernels git repository to somewhere on your path and checking out the appropriate branch (0.x or master) corresponding to the version of Spyder (3 or 4) you would like to run, and running the commend pip install -e at the root.For any non-trivial development work, keeping two separate virtual environments (with conda-env or venv) for Spyder 3 and 4 makes this process much quicker and less tedious.

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:

3a8082e126