Install¶
These steps are for release builds. To run from source, see Developer setup.
Before you install¶
Logic-Loom works on top of your own research setup. It does not install or sign in to any of these for you:
- Zotero with your library
- the Better BibTeX plug-in, with an auto-updating JSON export
- your PDFs, reachable from Zotero
- an LLM backend: a local model (Ollama, LM Studio), an agent CLI (Claude Code, Codex,
Gemini), NotebookLM through the
nlmCLI, or an API key. See LLM providers.
Download¶
Get the latest installer from the
installer releases page.
Each release attaches the platform installers and a SHA256SUMS.txt manifest.
Two release pages
Installers are built and published from CEmM2/Logic-Loom-releases. The source repository's releases carry only the source archives for the same version.
Check a download against the manifest before installing. On Linux:
On macOS:
On Windows (PowerShell), compare the printed hash with the matching line in
SHA256SUMS.txt:
Not every platform is guaranteed on every release. Check the assets attached to the release you want. If yours is missing, you can build from source.
macOS¶
- Download the
.dmg. - Open it and drag
Logic-Loom.appinto Applications. - Launch it from Applications.
If the build is not notarized, macOS may block the first launch. Right-click
Logic-Loom.app, choose Open, then confirm Open. If Gatekeeper still refuses,
remove the quarantine flag:
Windows¶
- Download the NSIS
-setup.exeinstaller (or the.msi). - Run it.
- If SmartScreen warns about an unsigned app, choose More info, then Run anyway, but only for a download whose checksum you verified.
Linux¶
Linux builds are x86_64 and need glibc 2.35 or newer: Ubuntu 22.04 or later, Debian 12
or later, or another distribution of the same age. Check yours with ldd --version.
Use the .AppImage or the .deb.
The two differ in what they need from your system:
- The AppImage carries its own WebKitGTK and GTK libraries, so it needs nothing from
your package manager except, on some systems,
libfuse2to mount itself (sudo apt install libfuse2, or run it with--appimage-extract-and-run). - The
.debuses your distribution's WebKitGTK (libwebkit2gtk-4.1-0), whichaptinstalls with it. If you cannot install that package, for example because your package mirror is unreachable, use the AppImage.
v0.3.0 Linux builds
The v0.3.0 Linux packages were built against glibc 2.43 by mistake and do not start on Ubuntu 24.04, Debian 13 or older. Use v0.3.1 or later, or run from source.
If no release build runs on your machine, you can run Logic-Loom from source in a browser, which needs neither the installer nor WebKitGTK.
Next¶
Continue with First run.