Skip to main content
The Omi desktop app for macOS lives in desktop/macos/. It is a Swift Package Manager project, and run.sh builds and launches it. There is no Xcode project to open.

​
Setup

1

Clone the repository

2

Install the prerequisites

Install the toolchain and code-signing identity listed in the desktop README.
3

Build and run a named bundle

This builds the app, starts a local Python backend, and launches the bundle. Always use a named omi-* bundle, so you never install over the production Omi or Omi Beta apps.

​
Where the details live

The macOS component keeps its own guides next to the code: desktop/macos/README.md and desktop/macos/docs/ cover the build flavors, signing, testing, and release process. Those docs are the source of truth; this page only points you there. For what the shipped app does (capture modes, permissions, surfaces), see Omi for Mac.