Metadata-Version: 2.3
Name: astra
Version: 1.2.0
Summary: Automated Survey observaTory Robotised with Alpaca
Author: Peter P. Pedersen, David Degen, Lionel Garcia, Sebastián Zúñiga-Fernández, Daniel Sebastian, Urs Schroffenegger
Author-email: Peter P. Pedersen <ppedersen@phys.ethz.ch>, David Degen <ddegen@phys.ethz.ch>, Lionel Garcia <garcia.lio@pm.me>, Sebastián Zúñiga-Fernández <sgzuniga@uliege.be>, Daniel Sebastian <sebastian@tls-tautenburg.de>, Urs Schroffenegger <urs.schroffenegger@unibe.ch>
License: GPL-3.0
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Requires-Dist: astrafocus>=0.1.5
Requires-Dist: astropy
Requires-Dist: photutils>=3.0.0
Requires-Dist: scipy
Requires-Dist: twirl>=0.5.2
Requires-Dist: sqlite3worker
Requires-Dist: alpyca>=3.1.2,<4
Requires-Dist: psutil
Requires-Dist: donuts
Requires-Dist: jinja2
Requires-Dist: matplotlib
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: pillow
Requires-Dist: fastapi[standard-no-fastapi-cloud-cli]
Requires-Dist: ruamel-yaml
Requires-Dist: cabaret>=0.5.4
Requires-Dist: astroquery>=0.4.11
Requires-Dist: requests
Requires-Python: ==3.11.*
Project-URL: Bug Tracker, https://github.com/ppp-one/astra/issues
Project-URL: Homepage, https://github.com/ppp-one/astra
Project-URL: Source, https://github.com/ppp-one/astra
Description-Content-Type: text/markdown

# Astra

[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](LICENSE)
[![Python 3.11](https://img.shields.io/badge/python-3.11-blue.svg)](https://www.python.org/downloads/)
[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
![Tests](https://github.com/ppp-one/astra/actions/workflows/format_and_test.yml/badge.svg?branch=main)
[![Docs](https://img.shields.io/badge/docs-brightgreen.svg)](https://docs.withastra.io/)

Astra (**Automated Survey observaTory Robotised with Alpaca**) is an open-source observatory control software for automating and managing robotic observatories. It integrates seamlessly with [ASCOM Alpaca](https://ascom-standards.org/api/) for hardware control.

![Astra themed art](docs/source/_static/astra-banner.jpg)

---

## Features

- **Fully Robotic** — Schedule once, observe automatically with error and bad weather handling
- **ASCOM Alpaca** — Compatible with your existing ASCOM equipment  
- **Cross-Platform** — Python based, runs on Windows, Linux, macOS  
- **Moving Targets** — Non-sidereal tracking of planets, comets, asteroids, and satellites from TLEs  
- **Web Interface** — Manage your observatory from any browser, use [cloudflared](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/get-started/) or similar to access outside your network
- **[Comprehensive Docs](https://docs.withastra.io/)** — Setup, usage, and module reference  

---

## Screenshots

<table>
  <tr>
    <td width="24%">
      <img src="docs/source/_static/ui-summary-tab.png" alt="Observatory overview"/>
      <p align="center"><em>Observatory overview</em></p>
    </td>
    <td width="24%">
      <img src="docs/source/_static/ui-log-tab.png" alt="System logs"/>
      <p align="center"><em>System logs</em></p>
    </td>
    <td width="24%">
      <img src="docs/source/_static/ui-weather-tab.png" alt="Weather monitoring"/>
      <p align="center"><em>Weather monitoring</em></p>
    </td>
    <td width="24%">
      <img src="docs/source/_static/ui-controls-tab.png" alt="Controls tab"/>
      <p align="center"><em>Controls tab</em></p>
    </td>
  </tr>
</table>

---

## Contributing

Contributions are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) or the [contributing guide](https://docs.withastra.io/contributing).

---

## License

Released under the [GNU GPL v3](LICENSE).

---

## Support

- [Documentation](https://docs.withastra.io/)  
- [Issue Tracker](https://github.com/ppp-one/astra/issues)  

---

## Citation

If you use Astra in published research, please cite it as:

```bibtex
@misc{https://doi.org/10.5281/zenodo.18890151,
  doi = {10.5281/ZENODO.18890151},
  url = {https://zenodo.org/doi/10.5281/zenodo.18890151},
  author = {Pedersen,  Peter P. and Degen,  David and Garcia,  Lionel and Zúñiga-Fernández,  Sebastián and Sebastian,  Daniel and Schroffenegger,  Urs and Queloz,  Didier},
  keywords = {observatory control software,  ocs,  astronomy,  control software,  ground-based,  telescope,  camera,  ascom,  survey telescope,  photometry,  imaging},
  title = {Astra},
  publisher = {Zenodo},
  year = {2026},
  copyright = {GNU General Public License v3.0 only}
}
```

and

```bibtex
@inproceedings{10.1117/12.3105437,
  author = {Peter P. Pedersen and David Degen and Lionel Garcia and Urs Schroffenegger and Daniel Sebastian and Sebasti{\'a}n Z{\'u}{\~n}iga-Fern{\'a}ndez and Brice-Olivier Demory and Elsa Ducrot and Micha{\"e}l Gillon and Matthew J. Hooton and Cl{\`a}udia Jan{\'o}-Mu{\~n}oz and James McCormac and Mathilde Timmermans and Amaury H. M. J. Triaud and Didier Queloz},
  title = {{Astra: an open-source fully autonomous robotic observatory control software}},
  volume = {14155},
  booktitle = {Software and Cyberinfrastructure for Astronomy IX},
  editor = {Jorge Ibsen and Valentina Alberti},
  organization = {International Society for Optics and Photonics},
  publisher = {SPIE},
  pages = {141552U},
  keywords = {observatory control software, robotic, ground-based, observatory, robotic astronomy, plate solving, autoguiding, autofocus},
  year = {2026},
  doi = {10.1117/12.3105437},
  URL = {https://doi.org/10.1117/12.3105437}
}
```

Zenodo DOI: [10.5281/zenodo.18890151](https://doi.org/10.5281/zenodo.18890151), Proceedings DOI: [10.1117/12.3105437](https://doi.org/10.1117/12.3105437), Arxiv DOI: [10.48550/arXiv.2607.12898](https://doi.org/10.48550/arXiv.2607.12898)
