Repository navigation
Desktop
nodemode-ai edited this page Nov 8, 2026
·
1 revision
The desktop app is a Tauri 2 shell (src-tauri/) around the same interface, with the engine frozen into a sidecar binary.
-
./build_appdoes the whole build from a fresh clone on macOS or Linux, one command: it checks Python, Node, the Xcode tools and Rust (installing Rust with rustup into~/.cargowhen missing), runsinstall_allandinstall_desktop, builds the window, freezes the engine, runstauri build, retries once after a clean when the Rust compile fails, then on macOS packs a disk image and copiesformlit.appto Applications, and on Linux leaves a .deb (--installinstalls it with apt).--lite,--no-install,--openand--cleanchange those steps; everything is logged tobuild_app.log../formlit desktop buildruns it. On Windows,build_app.batdoes the same from a fresh clone: it checks Python, Node 22 and Rust, runssetup\install_all.bat(--litepasses through),setup\install_desktop.batandsetup\desktop_build.bat, stops at the first failing step with a sentence saying so, and--openopens the folder with the .msi and setup .exe. It does not install Rust for you and writes no log file. -
./formlit install-desktopinstalls PyInstaller and checks the Rust and Tauri toolchain. -
./formlit freezebuildsformlit-enginewith PyInstaller frombackend/formlit_engine.py(collecting the app, uvicorn, rawpy, numba and llvmlite, ONNX Runtime, reportlab and imagecodecs, and bundlingshared/and the built frontend) intosrc-tauri/binaries/, which git ignores. Command modules and publish services that the engine imports by name are listed with--hidden-importinsetup/freeze_backendandfreeze_backend.bat; the new binary must pass--selfcheck(every one of those modules imports) before it is copied. -
./formlit desktop devruns the shell against the dev frontend.
At launch the shell shows a splash, spawns the sidecar with FORMLIT_PORT=8390 (the frozen entry marks itself as the desktop engine and serves the bundled interface), reads the port from the engine's startup line, and loads the interface from it. The port is fixed so the formlit plugin's bridge always finds /mcp; when something already listens on 8390 the sidecar takes a free port instead and the window still follows it. Closing the window stops the engine. .fldb catalogs are associated with the app. In-app updates come from GitHub Releases once the updater key is set (see Releasing).