Logic-Loom¶

Logic-Loom is a desktop app for research workflows. It turns a Zotero library into a searchable Obsidian vault with zotero-summarizer, and adds optional knowledge-graph tooling from AKMS, paper discovery, a computational-mechanics compiler from MechDSL, and read-only views of agent memory.
It is a Tauri desktop shell (Rust + React) that starts a local Python API, the
logic-loom-api sidecar, and talks to it over a random local port. Nothing leaves
your machine unless you configure a cloud LLM provider.
Six modes¶
Every workflow belongs to one of six modes, picked from the top bar.
| Mode | What it is for | Needs |
|---|---|---|
| zsum | Run the zotero-summarizer pipeline and browse the published vault | Core install |
| AKMS | Batch node generation, node review, the read-only graph explorer, Learn | akms extra |
| Assistant | Paper discovery, source batches, workflow runs, workspace search | Core install |
| MechDSL | Compile % mechanics LaTeX into FEM solver code |
mechdsl extra |
| Failure Memory | Inspect .failure-memory lesson registries; opt-in operator mode |
failure-memory extra + configured projects |
| Records | Browse akms-records stores and their record graph | records extra + configured stores |
Release builds include every extra. When a mode's requirements are missing, its tabs show a setup message instead of failing.
The top bar also holds the theme switch (system, light, dark) and a Logo switch for the backdrop logo: a small mark in the bottom-right corner (the default), hidden, or full size behind the page.
Where to start¶
- Using the app: Install, then First run.
- Configuring it: Configuration and LLM providers.
- Working on the code: Developer setup and Architecture.
- What changed: Changelog and the installer releases.