Astropy: a community Python library for Astronomy

The Astropy Project is a community effort to develop a single core package for Astronomy in Python and foster interoperability between Python astronomy packages.

Current Version: 0.4.2

Please remember to acknowledge the use of Astropy!

Install Astropy

There are a number of options for installing the astropy package on MacOS X. Astropy can be installed using the MacPorts or Fink package managers, and is also included by default in the Anaconda Python Distribution (more details here), Enthought Canopy, and Ureka, which provide an easy way to get set up with a scientific Python distribution. MacPorts usually includes new releases almost immediately, but Anaconda and Canopy may not always include the latest version.

You can also install the latest version of Astropy using pip or by downloading the source code and installing it manually - see the Source tab above for more details.

There are a number of options for installing the astropy package on Linux. Astropy can be installed on some Linux distributions using the built-in package manager (apt-get, yum, etc.), and is also included by default in the Anaconda Python Distribution (see here for instructions on updating to the latest Astropy version), Enthought Canopy, and Ureka, which provide an easy way to get set up with a scientific Python distribution.

The package managers, Anaconda, and Canopy may not always include the latest version - in that case you can always install the latest version of Astropy using pip or by downloading the source code and installing it manually - see the Source tab above for more details.

There are a number of options for installing the astropy package on Windows. Astropy is included by default in the Anaconda Python Distribution and Enthought Canopy, both of which provide an easy way to get set up with a scientific Python distribution.

However, Anaconda and Canopy may not always include the latest version of Astropy, so if you need to install the latest version, you can either use the binary installers available on PyPI (usually made available a few days after each release) or you can install Astropy from source - see the Source tab above for more details.

To install Astropy from source, you can either use

pip install astropy

Alternatively, you can download a tarball for the latest release of astropy from PyPI, then expand the tarfile and run:

python setup.py install

to build and install the package. For more on installing from source code, see the relevant part of the documentation.

The latest developer code is available on GitHub. If you have git installed you can get the latest version with:

git clone https://github.com/astropy/astropy.git

If you don't have git installed, you can instead download a zip file of the latest development version.

Once you have the latest source code, you can build and install it with:

python setup.py install

For more on installing from source code, see the relevant part of the documentation.

Do none of the above instructions work for your system, or do you need more detailed instructions? Check out the installation instructions in our documentation.

What's Next?

Once you have installed Astropy, you can head over to the documentation for an overview of the functionality available in Astropy. Each section of the documentation contains a "Getting started" section that will demonstrate the basic functionality, and you will then also be able to browse the full documentation to find out more.

Get Started with Astropy

If you run into any issues when using Astropy, please report them using the issue tracker. Finally, If you have any questions regarding using Astropy, or have feedback on how we can improve the package, please head over to our feedback and contributing or help pages.

Contribute feedback or code Report issues

Support Astropy

If you use Astropy in your work, we would be grateful if you could include an acknowledgment in papers and/or presentations. See Acknowledging Astropy for details.

You can also purchase apparel and trinkets from fashion.astropy.org, and a portion of the profits go to support the project!