|Astropy Logo|

:Versions: |Zenodo| |PyPI Status| |Supported Python Versions|
:Status: |Coverage Status| |Actions Status| |CircleCI Status| |Documentation Status|
:Tools: |Pre-Commit| |Ruff|
:Community: |pyOpenSci Peer-Reviewed|

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

.. |Supported Python Versions| image:: https://img.shields.io/pypi/pyversions/astropy
:target: https://pypi.org/project/astropy
:alt: Supported Python Versions of latest released astropy

.. |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

.. |pyOpenSci Peer-Reviewed| image:: https://pyopensci.org/badges/peer-reviewed.svg
:target: pyOpenSci/software-submission#251
:alt: pyOpenSci Peer-Reviewed