Pytheia100 v1.1.0 — Installation & Setup Guide

Date: 2025-09-04 Product: Pytheia100 Version: 1.1.0

This guide walks you through installing, verifying, and running Pytheia100 v1.1.0. It covers license verification, integrity checks, dependency installation, configuration, and troubleshooting.

---

1. Prerequisites

> If Windows console shows raw color codes (e.g., `\x1b[35m`), install Colorama: 
powershell
pip install colorama

---

2. Download the v1.1.0 package

Unzip the full release into your working directory, e.g., `C:\Pytheia\Prod\Pytheia100_v1.1.0`.

---

3. Verify integrity (recommended)

The release includes an integrity manifest (`INTEGRITY.json`) and a validator script.

bash

From the extracted folder

python validate_integrity.py --root .
You should see `[OK]` lines for `Pytheia100_main.py`, `Pytheia100_core.py`, and `config.py`, then a final success message.

---

4. Verify license (Ed25519)

Make sure you have a properly signed `pytheia_license.json` (`{"payload":{...},"signature":""}`). To verify the signature against your public key:

bash
python verify_ed25519.py --public-key pytheia_public_key.pem --license pytheia_license.json

Expected result: `[OK] License signature is VALID.`

---

5. Install dependencies

Windows (PowerShell)

powershell
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install --upgrade pip
pip install -r requirements.txt

macOS / Linux (bash/zsh)

bash
python3 -m venv .venv
source .venv/bin/activate
pip install --upgrade pip
pip install -r requirements.txt

> Tip: For reproducibility and security, pin versions in `requirements.txt` (e.g., `numpy==1.26.4`) and regenerate the SBOM.

---

6. Configure

Edit `config.py` to point to your dataset and desired settings.

Key fields:

Custom pointing model (optional): Provide `pointing_model(coord1, coord2, terms, aux1=None, aux2=None, kwargs)` in `config.py` that returns two dictionaries: `(stack1, stack2)` where each maps `term -> numpy array` for the first/second coordinate, respectively.

---

7. Run

From the project root:

Windows (PowerShell)

powershell
.\.venv\Scripts\Activate.ps1
python .\Pytheia100_main.py

macOS / Linux

bash
source .venv/bin/activate
python ./Pytheia100_main.py
You should see logs similar to: 

[INFO] Pytheia100 v1.1.0 | Org: Organization XYZ
[INFO] Mode: azel | Data: Ecam_astrometry_pm-02-04-2025.dat
[INFO] Selected terms (...): [...]
[INFO] Output directory: My_Pointing_model_results\terms_xxxxxxxx
HTML report path is printed at the end, e.g.: 

[INFO] HTML report path: My_Pointing_model_results\terms_XXXX\combined_results_bayesian.html

---

8. Outputs

---

9. SBOM & compliance

---

10. Troubleshooting

---

11. Upgrading from v1.0.0

---

12. Support