Add README badges, demo GIF, CITATION.cff, and Euclid disclaimer

- Add PyPI, DOI, license, and Python version badges
- Add demo GIF to showcase UI
- Add pip install instructions
- Add note about Euclid Q1/IDR1 data optimisation
- Create CITATION.cff for proper academic citation

Author: gomezzz

.gitignore

@@ -232,3 +232,4 @@ job_tracking.json
 cutana_output/
 test_workflow_*
 examples/*.csv
+demo

CITATION.cff

@@ -0,0 +1,45 @@
+cff-version: 1.2.0
+message: "If you use this software, please cite it as below."
+title: "Cutana: A High-Performance Tool for Astronomical Image Cutout Generation at Petabyte Scale"
+type: software
+authors:
+  - family-names: "Gómez"
+    given-names: "Pablo"
+  - family-names: "Ruhberg"
+    given-names: "Laslo Erik"
+  - family-names: "Remmelgas"
+    given-names: "Kristin Anett"
+  - family-names: "O'Ryan"
+    given-names: "David"
+version: "0.1.2"
+date-released: 2025-11-28
+url: "https://github.com/ESA/Cutana"
+repository-code: "https://github.com/ESA/Cutana"
+license: "ESA-PL-Permissive-v2.4"
+keywords:
+  - astronomy
+  - image processing
+  - cutouts
+  - FITS
+  - Euclid
+  - ESA
+preferred-citation:
+  type: article
+  authors:
+    - family-names: "Gómez"
+      given-names: "Pablo"
+    - family-names: "Ruhberg"
+      given-names: "Laslo Erik"
+    - family-names: "Remmelgas"
+      given-names: "Kristin Anett"
+    - family-names: "O'Ryan"
+      given-names: "David"
+  title: "Cutana: A High-Performance Tool for Astronomical Image Cutout Generation at Petabyte Scale"
+  year: 2025
+  identifiers:
+    - type: doi
+      value: "10.48550/arXiv.2511.04429"
+    - type: other
+      value: "arXiv:2511.04429"
+      description: "arXiv preprint"
+  url: "https://arxiv.org/abs/2511.04429"

README.md

@@ -6,15 +6,35 @@
 [//]: # (the terms contained in the file 'LICENCE.txt'.)
 # Cutana - Astronomical Cutout Pipeline
 
+[![PyPI version](https://img.shields.io/pypi/v/cutana.svg)](https://pypi.org/project/cutana/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/cutana.svg)](https://pypi.org/project/cutana/)
+[![DOI](https://img.shields.io/badge/DOI-10.48550/arXiv.2511.04429-blue)](https://doi.org/10.48550/arXiv.2511.04429)
+[![License](https://img.shields.io/badge/License-ESA--PL%20Permissive-green)](LICENSE.txt)
+[![Python](https://img.shields.io/pypi/pyversions/cutana.svg)](https://pypi.org/project/cutana/)
+
 **Cutana** is a high-performance Python pipeline for creating astronomical image cutouts from large FITS datasets. It provides both an interactive **Jupyter-based UI** and a **programmatic API** for efficient processing of astronomical survey data like ESA Euclid observations.
 
+![Cutana Demo](assets/cutana_demo_2x.gif)
+
+> **Note:** Cutana is currently optimised for **Euclid Q1/IDR1 data**. Some defaults and assumptions are Euclid-specific:
+> - Flux conversion expects the `MAGZERO` header keyword (configurable via `config.flux_conversion_keywords.AB_zeropoint`)
+> - Filter detection patterns are tuned for Euclid bands (VIS, NIR-Y, NIR-H, NIR-J)
+> - FITS structure assumes one file per channel/filter
+>
+> For other surveys, you may need to adjust these settings or disable flux conversion (`config.apply_flux_conversion = False`).
+
 ## Support for Datalabs Users
 
 For users experiencing problems with Cutana in the ESA Datalabs environment, please open a service desk ticket at: https://support.cosmos.esa.int/situ-service-desk/servicedesk/customer/portal/5
 
 ## Quick Start
 ### Installation
 
+```bash
+pip install cutana
+```
+
+Or for development:
 ```bash
 # Create conda environment
 conda env create -f environment.yml