|Astropy Logo|

|Actions Status| |CircleCI Status| |Coverage Status| |PyPI Status| |Documentation Status| |Pre-Commit| |Ruff| |Zenodo|

The Astropy Project is a community effort to develop a single core package for astronomy in Python and foster interoperability between packages used in the field. This repository contains the core library.

• Website <https://astropy.org/>_
• Documentation <https://docs.astropy.org/>_
• Slack <https://astropy.slack.com/>_
• Open Astronomy Discourse <https://community.openastronomy.org/c/astropy/8>_
• Astropy users mailing list <https://mail.python.org/mailman/listinfo/astropy>_
• Astropy developers mailing list <https://groups.google.com/g/astropy-dev>_

Installation

To install astropy from PyPI, use:

.. code-block:: bash

pip install astropy

For more detailed instructions, see the install guide <https://docs.astropy.org/en/stable/install.html>_ in the docs.

Contributing

|User Stats|

The Astropy Project is made both by and for its users, so we welcome and encourage contributions of many kinds. Our goal is to keep this a positive, inclusive, successful, and growing community that abides by the Astropy Community Code of Conduct <https://www.astropy.org/about.html#codeofconduct>_.

For guidance on contributing to or submitting feedback for the Astropy Project, see the contributions page <https://www.astropy.org/contribute.html>. For contributing code specifically, the developer docs have a guide <https://docs.astropy.org/en/latest/index_dev.html> with a quickstart. There’s also a summary of contribution guidelines <CONTRIBUTING.md>_.

Developing with Codespaces

GitHub Codespaces is a cloud development environment using Visual Studio Code in your browser. This is a convenient way to start developing Astropy, using our dev container <.devcontainer/devcontainer.json>_ configured with the required packages. For help, see the GitHub Codespaces docs <https://docs.github.com/en/codespaces>_.

|Codespaces|

Acknowledging and Citing

See the acknowledgement and citation guide <https://www.astropy.org/acknowledging.html>_ and the CITATION <https://github.com/astropy/astropy/blob/main/astropy/CITATION>_ file.

Supporting the Project

|NumFOCUS| |Donate|

The Astropy Project is sponsored by NumFOCUS, a 501(c)(3) nonprofit in the United States. You can donate to the project by using the link above, and this donation will support our mission to promote sustainable, high-level code base for the astronomy community, open code development, educational materials, and reproducible scientific research.

License

Astropy is licensed under a 3-clause BSD style license - see the LICENSE.rst <LICENSE.rst>_ file.

.. |Astropy Logo| image:: https://github.com/astropy/repo_stats/blob/main/dashboard_template/astropy_banner_gray.svg :target: https://www.astropy.org/ :alt: Astropy

.. |User Stats| image:: https://github.com/astropy/repo_stats/blob/cache/cache/astropy_user_stats_light.png :target: https://docs.astropy.org/en/latest/impact_health.html :alt: Astropy User Statistics

.. |Actions Status| image:: https://github.com/astropy/astropy/actions/workflows/ci_workflows.yml/badge.svg :target: https://github.com/astropy/astropy/actions :alt: Astropy’s GitHub Actions CI Status

.. |CircleCI Status| image:: https://img.shields.io/circleci/build/github/astropy/astropy/main?logo=circleci&label=CircleCI :target: https://circleci.com/gh/astropy/astropy :alt: Astropy’s CircleCI Status

.. |Coverage Status| image:: https://codecov.io/gh/astropy/astropy/branch/main/graph/badge.svg :target: https://codecov.io/gh/astropy/astropy :alt: Astropy’s Coverage Status

.. |PyPI Status| image:: https://img.shields.io/pypi/v/astropy.svg :target: https://pypi.org/project/astropy :alt: Astropy’s PyPI Status

.. |Zenodo| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.4670728.svg :target: https://doi.org/10.5281/zenodo.4670728 :alt: Zenodo DOI

.. |Documentation Status| image:: https://img.shields.io/readthedocs/astropy/latest.svg?logo=read%20the%20docs&logoColor=white&label=Docs&version=stable :target: https://docs.astropy.org/en/stable/?badge=stable :alt: Documentation Status

.. |Pre-Commit| image:: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white :target: https://github.com/pre-commit/pre-commit :alt: pre-commit

.. |Ruff| image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json :target: https://github.com/astral-sh/ruff :alt: Ruff

.. |NumFOCUS| image:: https://img.shields.io/badge/powered%20by-NumFOCUS-orange.svg?style=flat&colorA=E1523D&colorB=007D8A :target: https://numfocus.org :alt: Powered by NumFOCUS

.. |Donate| image:: https://img.shields.io/badge/Donate-to%20Astropy-brightgreen.svg :target: https://numfocus.org/donate-to-astropy

.. |Codespaces| image:: https://github.com/codespaces/badge.svg :target: https://github.com/codespaces/new?hide_repo_select=true&ref=main&repo=2081289 :alt: Open in GitHub Codespaces