← Getting Started

Installation

Download and install the SourcePrep desktop app on your local machine.

Prerequisites

  • OS: macOS (11+) or Windows (10+). Linux is supported but experimental.
  • Disk: ~500 MB for the app + embedding model. Index size depends on your codebase.

Download

SourcePrep is a native desktop application. Choose your platform:

macOS

  1. Open the downloaded .dmg file.
  2. Drag SourcePrep into your Applications folder.
  3. Launch SourcePrep from Applications (or Spotlight: Cmd+Space → "SourcePrep").

On first launch, macOS may ask you to confirm the app is from an identified developer. Click "Open" to proceed.

Windows

  1. Run the downloaded .msi installer.
  2. Follow the installation wizard (default settings are fine).
  3. Launch SourcePrep from the Start Menu or Desktop shortcut.

Verify Installation

When you launch SourcePrep, it automatically starts the background daemon. You should see the dashboard appear with a green "Connected" status.

The app also installs a prep CLI command. You can verify it in your terminal:

prep --version

Licensing

SourcePrep is free to use with up to 3 active projects and all features included. To unlock unlimited projects, purchase a license at sourceprep.io/pricing.

Payments are processed by Lemon Squeezy (our Merchant of Record). After purchase, enter your license key in the app to activate. Activation requires a one-time internet connection; after that, SourcePrep works fully offline.

Upgrading

SourcePrep checks for updates automatically and notifies you when a new version is available. You can also download the latest version from sourceprep.io/download.

Next Steps

Once installed, head over to the Quick Start guide to index your first project.