Install

Use a notarized GitHub Release, or build the MIT application source yourself. No account is required.

Requirements

• macOS 13.3 or later
• Apple Silicon (M1 and later)
• About 1 GB free disk space for default on-device models (Whisper is optional)
• Network for the first model download and for Sparkle updates

Release build

1. Download the latest notarized build from GitHub Releases.
2. Open the DMG and drag OneSentence to Applications.
3. On first launch, grant Microphone and Accessibility permission, then let the app download models from Hugging Face.

The app checks for updates via Sparkle at https://onesentence.app/appcast.xml.

A notarized DMG is a mixed-license bundle (MIT application source plus upstream model licenses), not MIT-only software. See Credits.

Build from source

Requirements: macOS 13.3+, Xcode 16+, Mise.

git clone https://github.com/snowy-0wl/onesentence-app.git
cd onesentence-app
mise run setup
mise run tg          # generate Xcode workspace (Tuist)
mise run build       # Debug build
open OneSentence.xcworkspace

Tests: ./scripts/dev/test.sh --tier 1. See CONTRIBUTING.md and AGENTS.md.

Models

Runtime ML weights are not in git. They live on Hugging Face snowy-0wl/onesentence-models and are downloaded on first use. Licenses: Whisper MIT, Parakeet CC BY 4.0, Supertonic OpenRAIL-M.

For local development:

git lfs install
huggingface-cli download snowy-0wl/onesentence-models --local-dir deps/assets/onesentence-models

More detail: Credits and NOTICE.