Download & install

Mosael is local-first: editing local media and exporting can work offline. A workflow needs a network when its nodes do. Configure a provider or subscription login for remote AI; download model weights before using local transcription or local voice cloning (a cloned voice can also be spoken by Bailian's CosyVoice, with nothing to download).

Download#

Both channels carry the same installers:

The app silently checks the latest stable Release after launch and prompts you to download; there is also a "Check for updates" button under Settings → Local app → Version. GitHub prereleases are opt-in and must be downloaded from the Releases page explicitly.

• The backend engine and ffmpeg are bundled — works out of the box.
• Local transcription / voice-clone / voice-separation runtimes are installed by a deployment admin under Admin → Engines (on the desktop app, you are the deployment admin), and some model weights download on first use; together that is hundreds of MB to several GB, so keep 10GB+ of disk free.

Run from source (development)#

From the repository root:

pnpm install
pnpm dev          # backend + frontend + Electron

Package the desktop build:

pnpm build:mac    # frontend + sidecar + publisher + backend (PyInstaller) + .app
pnpm dist:mac     # same flow, produces a .dmg for distribution

Local macOS packaging requires a signing identity, provisioning profile and notarization credentials; see the repository’s macOS signing guide.

Official releases are built by CI: maintainers push a v* tag and GitHub Actions packages macOS and Windows and attaches both installers to the Release. Tags with a suffix such as -beta1 remain prereleases and do not replace the latest stable build (see the repository README).

Where your data lives#

In the default local mode, accounts, projects, media and backend settings live on your own machine in ~/.mosael (Windows: C:\Users\<you>\.mosael), outside the app bundle — upgrades and reinstalls keep your data. Admin → Deployment → Data & diagnostics makes a full backup and restores from one.

Next: Quick start.

Set the theme, background and interface font in Appearance. With a remote backend, project data lives on that server. Back up the active backend data directory before upgrading.