spyder

GitHub

Official repository for Spyder - The Scientific Python Development Environment

RAW Doc

Repository: spyder-ide/spyder


Stars: 9196

README.md

!Spyder β€” The Scientific Python Development Environment

Copyright Β© 2009– Spyder Project Contributors and others (see AUTHORS.txt)

*Some source files and icons may be under other authorship/licenses; see
NOTICE.txt.*

Project status

![license](./LICENSE.txt)
![pypi version](https://pypi.org/project/spyder/)
![conda version](https://anaconda.org/conda-forge/spyder)
![download count](https://anaconda.org/conda-forge/spyder)
![OpenCollective Backers](#backers)
![OpenCollective Sponsors](#sponsors)
![Join the chat at https://gitter.im/spyder-ide/public](https://gitter.im/spyder-ide/public)<br>
![PyPI status](https://github.com/spyder-ide/spyder)

Build status

![Win](https://github.com/spyder-ide/spyder/actions/workflows/test-win.yml)
![Mac](https://github.com/spyder-ide/spyder/actions/workflows/test-mac.yml)
![Linux](https://github.com/spyder-ide/spyder/actions/workflows/test-linux.yml)
![Coverage Status](https://coveralls.io/github/spyder-ide/spyder?branch=master)
![codecov](https://codecov.io/gh/spyder-ide/spyder)
![Crowdin](https://crowdin.com/project/spyder)
![Nightly conda-based installers](https://github.com/spyder-ide/spyder/actions/workflows/installers-conda.yml?query=branch%3Amaster)

Try Spyder online

![Binder for the latest Spyder release](https://mybinder.org/v2/gh/spyder-ide/binder-environments/spyder-stable?urlpath=git-pull%3Frepo%3Dhttps%253A%252F%252Fgithub.com%252Fspyder-ide%252FSpyder-Workshop%26urlpath%3Ddesktop%252F%26branch%3Dmaster) :point_left: Click on this link to run the latest Spyder version in your browser.

![Binder for Spyder from the 6.x branch](https://mybinder.org/v2/gh/spyder-ide/binder-environments/6.x?urlpath=git-pull%3Frepo%3Dhttps%253A%252F%252Fgithub.com%252Fspyder-ide%252Fspyder%26urlpath%3Ddesktop%252F%26branch%3D6.x%26depth%3D500) :point_left: Click on this link to check the next Spyder 6 version.

![Binder for Spyder from the master branch](https://mybinder.org/v2/gh/spyder-ide/binder-environments/master?urlpath=git-pull%3Frepo%3Dhttps%253A%252F%252Fgithub.com%252Fspyder-ide%252Fspyder%26urlpath%3Ddesktop%252F%26branch%3Dmaster%26depth%3D500) :point_left: Click on this link to test changes in our master branch.

----

How Spyder looks


!Screenshot of Spyder's main window

----

Help support Spyder, the community-developed scientific IDE!

Spyder development is made possible by contributions from our global user
community, along with organizations like NumFOCUS
and Quansight.
There are numerous ways you can help, many of
which don't require any programming. If you'd like to make a donation to help fund further improvements,
we'd really appreciate it.

Thanks for all you do to make the Spyder project thrive! More details

----

Overview

Spyder is a powerful scientific environment written in Python, for Python,
and designed by and for scientists, engineers and data analysts. It offers 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.

Beyond its many built-in features, its abilities can be extended even further
via its plugin system and API. Furthermore, Spyder can also be used as a PyQt5
extension library, allowing you to build upon its functionality and embed
its components, such as the interactive console, in your own software.

For more general information about Spyder and to stay up to date on the
latest Spyder news and information, please check out our new website.


Core components

* Editor

Work efficiently in a multi-language editor with a function/class browser,
real-time code analysis tools (pyflakes, pylint, and pycodestyle),
automatic code completion (jedi and rope),
horizontal/vertical splitting, and go-to-definition.

* Interactive console

Harness the power of as many IPython consoles as you like with full
workspace and debugging support, all within the flexibility of a full
GUI interface. Instantly run your code by line, cell, or file,
and render plots right inline with the output or in interactive windows.

* Documentation viewer

Render documentation in real-time with Sphinx for any class or function,
whether external or user-created, from either the Editor or a Console.

* Variable explorer

Inspect any variables, functions or objects created during your session.
Editing and interaction is supported with many common types, including
numeric/strings/bools, Python lists/tuples/dictionaries, dates/timedeltas,
Numpy arrays, Pandas index/series/dataframes, PIL/Pillow images, and more.

* Development tools

Examine your code with the static analyzer, trace its execution with the
interactive debugger, and unleash its performance with the profiler.
Keep things organized with project support and a built-in file explorer, and
use find in files to search across entire projects with full regex support.


Documentation

You can read the Spyder documentation online on the Spyder Docs website.


Installation

For a detailed guide to installing Spyder, please refer to our
installation instructions.

The easiest way to install Spyder on any of our supported platforms
is to download it as part of the Anaconda
distribution, and use the conda package and environment manager to keep it
and your other packages installed and up to date.

If in doubt, you should always install Spyder via this method to avoid
unexpected issues we are unable to help you with; it generally has the
least likelihood of potential pitfalls for non-experts, and we may be
able to provide limited assistance if you do run into trouble.

Other installation options exist, including:

* The WinPython distribution for Windows
* The MacPorts project for macOS
* Your distribution's package manager (i.e. apt-get, yum, etc) on Linux
* The pip package manager, included with most Python installations

However, we lack the resources to provide individual support for users who
install via these methods, and they may be out of date or contain bugs outside
our control, so we recommend the Anaconda version instead if you run into issues.


Troubleshooting

Before posting a report, please carefully read our Troubleshooting Guide
and search the issue tracker
for your error message and problem description, as the great majority of bugs
are either duplicates, or can be fixed on the user side with a few easy steps.
Thanks!


Contributing and Credits

Spyder was originally created by Pierre Raybaut, and is currently maintained by
Carlos CΓ³rdoba and an international
community of volunteers.

You can join usβ€”everyone is welcome to help with Spyder!
Please read our contributing instructions
to get started!

Certain source files are distributed under other compatible permissive licenses
and/or originally by other authors.
The icons for the Spyder 3 theme are derived from Font Awesome 4.7 (Β© 2016 David Gandy; SIL OFL 1.1).
Most Spyder 2 theme icons are sourced from the Crystal Project icon set (Β© 2006-2007 Everaldo Coelho; LGPL 2.1+).
Other Spyder 2 icons are from Yusuke Kamiyamane (Β© 2013 Yusuke Kamiyamane; CC-BY 3.0),
the FamFamFam Silk icon set
(Β© 2006 Mark James; CC-BY 2.5), and the KDE Oxygen icons (Β© 2007 KDE Artists; LGPL 3.0+).

See NOTICE.txt
for full legal information.


Running from a git clone

Please see the instructions in our
Contributing guide
to learn how to do run Spyder after cloning its repo from Github.

Dependencies

Important Note: Most or all of the dependencies listed below come
with Anaconda and other scientific Python distributions, so you don't need
to install them separately in those cases.

Build dependencies

When installing Spyder from its source package, the only requirement is to have
a Python version equal or greater than 3.8.

Runtime dependencies

The basic dependencies to run Spyder are:

* Python 3.9+: The core language Spyder is written in and for.
* PyQt5 5.15+: Python bindings for Qt, used for Spyder's GUI.

The rest our dependencies (both required and optional) are declared in
this file.


Sponsors

Spyder is funded thanks to the generous support of

![Chan Zuckerberg Initiative](https://chanzuckerberg.com/)![Numfocus](https://numfocus.org/)


and the donations we have received from our users around the world through Open Collective:

![Sponsors](https://opencollective.com/spyder#support)


More information

Main Website

Download Spyder (with Anaconda)

Online Documentation

Spyder Github

Troubleshooting Guide and FAQ

Development Wiki

Gitter Chatroom

Google Group

@Spyder_IDE on Twitter

@SpyderIDE on Facebook

Support Spyder on OpenCollective