Get started
Download & install
Download channels, system requirements, install notes, where your data lives.
Mosael is a local-first desktop app: editing, export and workflows all run offline; AI features (LLMs / voiceover / generation) need the corresponding API keys configured in Settings.
Download#
Installers are published on GitHub Releases:
| Platform | Artifact | Notes |
|---|---|---|
| macOS | Mosael-<version>-arm64.dmg | Apple Silicon (M-series) |
| Windows | Mosael Setup <version>.exe | Windows 10 / 11 (x64), NSIS installer |
The app silently checks Releases for a newer version after launch and prompts you to download; there is also a "Check for updates" button under Settings → Local backend → Version.
- The backend engine and ffmpeg are bundled — works out of the box.
- Local transcription / voice-clone models download on first use (hundreds of MB to several GB); 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
Official releases are built by CI: maintainers push a v* tag and GitHub Actions packages mac / win and attaches both to the Release (see the repository README).
Where your data lives#
Everything (accounts / projects / media / settings) lives on your own machine in ~/.mosael (Windows: C:\Users\<you>\.mosael), outside the app bundle — upgrades and reinstalls keep your data.
Next: Quick start.