Installation

Quick Start

cd simplereader
make setup
make run

That's it. First run downloads models (~335MB).

Build Standalone App

make dist

Output: dist/SimpleReader-1.0.0.dmg

Manual Setup

If you prefer not to use make:

# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install dependencies
uv sync

# Run
uv run python -m reader

Manual Build

To build the macOS app bundle without make:

# Install dev dependencies
uv sync --extra dev

# Create app structure
uv run briefcase create macOS

# Build executable
uv run briefcase build macOS

# Package as DMG (adhoc signed)
uv run briefcase package macOS --adhoc-sign

Requirements

• macOS 13.0+
• Apple Silicon (M1/M2/M3/M4)
• ~500MB disk space

Troubleshooting

Unidentified Developer Warning

Right-click the app, select Open, click Open in dialog.

Or:

xattr -cr /path/to/SimpleReader.app

Models Not Downloading

Check internet connection. Models are stored in:

~/Library/Application Support/SimpleReader/models/