Installation¶

macpymessenger requires macOS and Python 3.14 or newer. It sends through the Messages app by running AppleScript.

Install with uv¶

uv add macpymessenger

This updates your project environment and records the dependency.

pip install macpymessenger

Import the package to check that Python can find it:

python -c "from macpymessenger import Configuration; print(Configuration())"

This also checks that the bundled AppleScript exists and is readable.

Check the installed package metadata if needed:

pip show macpymessenger

Python is too old. Run python --version. You need Python 3.14 or newer.

The platform is not macOS. The package can install elsewhere, but sending messages requires macOS, AppleScript, and Messages.app.

A custom script path fails. Configuration(send_script_path=...) checks the file immediately. Make sure the file exists and can be read.

When working on this repository itself, install the development dependencies:

uv sync

Then run commands inside the environment with uv run.