Installation
LMMs-Lab Writer is available for macOS and Windows.
Download
Visit the download page to get the latest version for your platform.
macOS
Homebrew (Recommended)
The easiest way to install on macOS is via Homebrew — no security warnings, and auto-updates built in:
brew tap EvolvingLMMs-Lab/tap
brew install --cask lmms-lab-writerTo update later:
brew upgrade lmms-lab-writerIf Homebrew reports an architecture mismatch on Intel Macs, install the Intel (x64) DMG/PKG from the download page.
Manual Installation
Two formats are available from the download page:
- DMG (
.dmg) — Drag-and-drop installation. Open the image and drag the app to your Applications folder. - PKG (
.pkg) — Guided installer. Double-click and follow the wizard.
Both Apple Silicon (aarch64) and Intel (x64) builds are provided.
Since the app is not yet signed with an Apple Developer certificate, macOS will block it. Remove the quarantine attribute first:
# For DMG
xattr -cr ~/Downloads/LMMs-Lab\ Writer_*.dmg
# For PKG
xattr -cr ~/Downloads/LMMs-Lab_Writer_*.pkgThen open the file and install normally.
Alternative: Right-click the downloaded file → select Open → click Open in the dialog → proceed with installation.
Windows
-
Download
LMMs-Lab Writer_x.x.x_x64-setup.exe(recommended) or the.msiinstaller from the download page. -
Run the installer and follow the prompts.
-
Launch from the Start Menu or desktop shortcut.
Note: Windows SmartScreen may show a warning because the app is not yet code-signed. Click More info → Run anyway to proceed.
Requirements
LaTeX Distribution
A LaTeX distribution is required to compile documents. The app auto-detects your installation and will prompt you if none is found.
macOS:
| Distribution | Size | Notes |
|---|---|---|
| TinyTeX | ~150 MB | Lightweight, auto-installs missing packages. Recommended for most users. |
| MacTeX | ~5 GB | Full TeX Live distribution. Includes everything out of the box. |
| BasicTeX | ~100 MB | Minimal TeX Live. You may need to install extra packages manually. |
Windows:
| Distribution | Size | Notes |
|---|---|---|
| TinyTeX | ~150 MB | Lightweight, auto-installs missing packages. Recommended for most users. |
| MiKTeX | ~200 MB | Auto-installs missing packages on first use. Popular choice on Windows. |
| TeX Live | ~5 GB | Full distribution. Includes everything out of the box. |
Supported LaTeX Engines
The app supports these compilation engines:
- pdfLaTeX — Standard engine, fastest compilation
- XeLaTeX — Native Unicode support, can use system fonts (recommended for CJK)
- LuaLaTeX — Modern, programmable engine with Lua scripting
- Latexmk — Automated build tool that runs LaTeX the correct number of times
All engines are auto-detected from your LaTeX distribution.
Git (Optional)
For version control features (staging, committing, diffing, pushing):
- Install Git
For GitHub integration (creating repos, publishing directly from the app):
- Install the GitHub CLI
Build from Source
LMMs-Lab Writer is open source. To build from source you need:
git clone https://github.com/EvolvingLMMs-Lab/lmms-lab-writer.git
cd lmms-lab-writer
pnpm install
pnpm tauri:buildThe built app will be in apps/desktop/src-tauri/target/release/bundle/:
- macOS:
macos/LMMs-Lab Writer.app - Windows:
nsis/LMMs-Lab Writer_*-setup.exe
Updating
The app includes a built-in updater that notifies you when new versions are available. You can also check manually from the releases page.
If you installed via Homebrew, run:
brew upgrade lmms-lab-writer