Dev Setup - Desktop

Here is a simple tutorial to help developers run AgeLapse Desktop in a development environment.

For Non-Devs:

Not a developer and just looking to install the app? Click here: https://agelapse.com

Clone the repository

git clone https://github.com/hugocornellier/agelapse

Set working directory to agelapse-desktop
```
cd agelapse/agelapse-desktop
```
Configure the Python environment
- Ensure you have Python 3.10.11 installed. (NOTE: You must use Python 3.10.11):
```
python3 --version  # should output Python 3.10.11
```
- Create and activate a new virtual environment:
```
python3 -m venv .venv
source .venv/bin/activate    # On Windows: .venv\Scripts\activate
```
- Install the project dependencies (select the file matching your platform):
```
pip install -r requirements/requirements-<platform>.txt
```
  Replace <platform> with mac-arm64, mac-x86_64, or windows.
Run the application
```
python main.py
```

Build a distributable (optional)
To generate a standalone executable, run PyInstaller with the appropriate spec file:

pyinstaller spec/macos-arm64.spec    # macOS ARM64
pyinstaller spec/macos-x86_64.spec   # macOS x86_64
pyinstaller spec/windows.spec        # Windows