Skip to content

Qwen3.8-Flash-Next on any consumer hardware: one-click install for Windows / Linux. Strata inference engine, OpenAI/Anthropic API on localhost, optional image input.

C++

desktop: tester README templates (hashes filled at build time), plain_path warning

Niko1221e1168345f1a9
diff --git a/apps/desktop/src-tauri/src/main.rs b/apps/desktop/src-tauri/src/main.rs
index f838e3014..7c0e45cb7 100644
--- a/apps/desktop/src-tauri/src/main.rs
+++ b/apps/desktop/src-tauri/src/main.rs
@@ -281,6 +281,7 @@ fn resource_dir(app: &tauri::AppHandle) -> Result<PathBuf, String> {
/// Tauri returns Windows paths in the verbatim form (`\\?\C:\...`). Node cannot take such a path as
/// its entry script (`EISDIR ... lstat 'C:'`), so the host died at once and the window sat
/// unresponsive until the health wait gave up. Use the ordinary drive (or UNC) form.
+#[cfg_attr(target_os = "linux", allow(dead_code))]
fn plain_path(p: PathBuf) -> PathBuf {
let text = p.to_string_lossy().into_owned();
if let Some(rest) = text.strip_prefix(r"\\?\UNC\") {
diff --git a/apps/desktop/tester/README-linux.txt.in b/apps/desktop/tester/README-linux.txt.in
new file mode 100644
index 000000000..c2282ec2b
--- /dev/null
+++ b/apps/desktop/tester/README-linux.txt.in
@@ -0,0 +1,70 @@
+STRATA FOR LINUX - TESTER BUILD
+===============================
+
+This is a test version of the Strata desktop app for Linux. The AI engine is already inside the file, so there is nothing to
+install for it and no engine to download. Only the AI model itself is downloaded (from Hugging Face), when you pick one.
+Please keep this file to yourself: it is not a public release.
+
+File: @APPIMAGE@ (about @SIZE_GB:@APPIMAGE@@ GB)
+Checks: sha256 @SHA256:@APPIMAGE@@
+ To check your copy: sha256sum @APPIMAGE@ - the long number must be the same.
+
+
+WHAT YOU NEED
+-------------
+* Ubuntu 22.04 or newer (22.04, 24.04 and 26.04 are what it was built for), or Fedora 44. 64-bit, on a normal desktop session.
+* An NVIDIA graphics card, RTX 20 series or newer (built and checked for RTX 30 cards; the RTX 40 and RTX 50 series are inside too).
+ If the computer also has AMD or Intel graphics (for example a Ryzen with built-in graphics), Strata ignores them and uses the NVIDIA card.
+* The NVIDIA driver, version 580 or newer (best). Version 575 or newer works too.
+ To see yours, open a terminal and type: nvidia-smi - the number next to "Driver Version" is it.
+ If the driver is older, Strata tells you in one line which version to install. To install a newer one:
+ Ubuntu: open "Software & Updates" > "Additional Drivers", or run: sudo ubuntu-drivers install and restart.
+ Fedora: use the NVIDIA driver from RPM Fusion (akmod-nvidia), and sudo dnf install xorg-x11-drv-nvidia-cuda so that nvidia-smi exists.
+* 32 GB of RAM or more is best (the model list shows what fits your computer).
+* Disk: about 3 GB for the app and its engine, plus 40 to 70 GB for each model you download.
+* FUSE 2 (libfuse2). Ubuntu 26.04 does not have it by default; install it once:
+ Ubuntu 22.04: sudo apt install libfuse2 Ubuntu 24.04 / 26.04: sudo apt install libfuse2t64
+ (or skip it by running the file with --appimage-extract-and-run , see "IF IT DOES NOT START" below).
+
+
+START IT
+--------
+1. Save the file somewhere you can find it, for example your Downloads folder.
+2. Make it runnable. Either right-click the file > Properties > Permissions > "Allow executing file as program",
+ or in a terminal:
+ chmod +x @APPIMAGE@
+3. Double-click it, or start it from a terminal (a terminal also shows messages if something goes wrong):
+ ./@APPIMAGE@
+
+The very first start takes about a minute longer: the engine that came with the app is unpacked into your home folder
+(~/.local/share/strata). Later starts are quick. Then open the Models page, pick a model and press the install button.
+A model download is big; it carries on where it stopped if it is interrupted.
+
+Closing the window stops Strata and the engine. (In browser mode closing the tab does not: see BROWSER MODE below.)
+To stop a running Strata from a terminal: ./@APPIMAGE@ --quit
+
+
+@INCLUDE:common-troubleshoot.txt@
+
+
+PLEASE TELL US ABOUT THE WINDOW
+-------------------------------
+This is one of the first times the Linux window runs on real graphics desktops. In your report please say:
+ - which Linux and which desktop (for example "Ubuntu 26.04, GNOME, Wayland" or "Fedora 44, GNOME, Wayland"),
+ - your graphics card and driver version (nvidia-smi),
+ - whether the Strata window showed up and worked: yes / opened in the browser instead / blank / closed by itself,
+ - for a blank or closed window: what you typed (any of the lines above) and what changed.
+If you started it from a terminal, copy what it printed there.
+
+
+WHAT TO SEND BACK
+-----------------
+Open Settings > Engine > Diagnostics > View logs > Save logs. Send the saved file, plus a few words about what you did and what you saw
+(a photo of the screen is fine).
+
+
+WHERE THINGS ARE (to remove Strata completely, delete the file and these folders)
+--------------------------------------------------------------------------------
+ ~/.strata settings, chats, prepared model files
+ ~/.local/share/strata the unpacked engine
+ ~/Documents/Strata downloaded models (Models) and your work folder (Workspace)
diff --git a/apps/desktop/tester/common-troubleshoot.txt b/apps/desktop/tester/common-troubleshoot.txt
new file mode 100644
index 000000000..262408e5b
--- /dev/null
+++ b/apps/desktop/tester/common-troubleshoot.txt
@@ -0,0 +1,39 @@
+IF IT DOES NOT START
+--------------------
+* A message about "FUSE" or "libfuse.so.2". AppImages need FUSE 2, and Ubuntu 26.04 does not install it any more
+ (this is what happens on a fresh Ubuntu 26.04: "dlopen(): error loading libfuse.so.2"). Install it once:
+ Ubuntu 22.04: sudo apt install libfuse2
+ Ubuntu 24.04 and 26.04: sudo apt install libfuse2t64
+ Fedora: sudo dnf install fuse fuse-libs
+ CachyOS / Arch: sudo pacman -S fuse2
+ Then start it again. Without FUSE you can still run it, a little slower to start because it unpacks itself first:
+ ./@APPIMAGE@ --appimage-extract-and-run
+* The app window does not open, or it closes by itself. This build does not give up: Strata keeps running and opens in your web
+ browser instead ("browser mode"). You will see a notification and, in a terminal, this line:
+ Strata opened in your browser because the app window couldn't start on this computer.
+ Everything works in the browser tab except updating the app itself (see BROWSER MODE below). Please tell us it happened, with your
+ Linux, desktop and graphics driver. The window is the part of Strata that depends most on your computer's graphics setup.
+* The window opens but stays blank or white: this build already switches off WebKit's DMA-BUF drawing, which is the usual cause.
+ If it is still blank, try these one at a time, and tell us which one (if any) helped:
+ WEBKIT_DISABLE_COMPOSITING_MODE=1 ./@APPIMAGE@
+ GDK_BACKEND=x11 ./@APPIMAGE@
+ WEBKIT_DISABLE_DMABUF_RENDERER=1 ./@APPIMAGE@
+ or just use browser mode (next section).
+* Inside a virtual machine or a remote desktop without graphics acceleration the window may be blank or may close at once.
+ Run Strata on the computer's own desktop, not through a remote session.
+
+
+BROWSER MODE (Strata in your web browser instead of the app window)
+------------------------------------------------------------------
+Start it on purpose with:
+ ./@APPIMAGE@ --browser (or: STRATA_UI=browser ./@APPIMAGE@)
+Strata starts its engine and opens http://127.0.0.1:47831/ in your default browser. The address works on your own computer only; nothing is
+reachable from the network.
+* Closing the browser tab does NOT stop Strata or its engine, because the tab is only a view. To stop everything, use the menu
+ (the "More" entry at the bottom left) > "Quit Strata", or in a terminal: ./@APPIMAGE@ --quit
+* Starting the AppImage again while Strata runs does not start a second copy: it opens another tab (browser mode) or brings the window forward.
+* What works in a browser tab as in the window: chat, models, Monitor, Settings, choosing a folder (a folder dialog needs zenity or kdialog;
+ without one Strata asks you to type the folder path), "open file" and "show in folder" (Strata opens them for you), downloads, the assistant.
+* What does NOT work in browser mode: updating the app itself (Settings > Updates says so in plain words; the engine updates still work and
+ you can update the app by starting it from its icon without --browser), and the app window's own title bar and window buttons (your
+ browser has its own). There is no desktop notification from the page itself; Strata sends the one it needs.