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++

tester READMEs: --save-logs, crash log location, the app version from Cargo.toml

Niko1221430618274121
diff --git a/apps/desktop/scripts/make-tester-readme.sh b/apps/desktop/scripts/make-tester-readme.sh
index db9ec3039..e38103c80 100644
--- a/apps/desktop/scripts/make-tester-readme.sh
+++ b/apps/desktop/scripts/make-tester-readme.sh
@@ -6,6 +6,7 @@
# Why: a README that carries a hand-pasted sha256 goes stale the moment the file is rebuilt (the Ubuntu 26.04 tester compared the file
# with the old build's hash). The template holds placeholders instead, and this script fills them from the real files:
# @APPIMAGE@ the AppImage's file name
+# @APP_VERSION@ the app version, read from apps/desktop/src-tauri/Cargo.toml
# @SHA256:<name>@ sha256 of the file <name> found in one of the --files-dir folders
# @SIZE_GB:<name>@ its size in GB with one decimal
# @INCLUDE:<file>@ (alone on a line) the contents of <file> from the template's folder, with the same placeholders
@@ -56,11 +57,14 @@ fi
[ -n "$APPIMAGE" ] || usage
TDIR="$(cd "$(dirname "$TEMPLATE")" && pwd)"
+# the app version has one source (the same file Tauri and the shell use)
+APP_VERSION="$(grep -m1 '^version = ' "$TDIR/../src-tauri/Cargo.toml" | cut -d'"' -f2)"
+[ -n "$APP_VERSION" ] || { echo "make-tester-readme: no version in $TDIR/../src-tauri/Cargo.toml" >&2; exit 1; }
TMP="$(mktemp)"; trap 'rm -f "$TMP" "$TMP.2"' EXIT
# includes first (one level), then the placeholders
while IFS= read -r line || [ -n "$line" ]; do
if [[ "$line" =~ ^@INCLUDE:([^@]+)@$ ]]; then tr -d '\r' < "$TDIR/${BASH_REMATCH[1]}"; else printf '%s\n' "$line"; fi
-done < <(tr -d '\r' < "$TEMPLATE") | sed "s|@APPIMAGE@|$APPIMAGE|g" > "$TMP"
+done < <(tr -d '\r' < "$TEMPLATE") | sed "s|@APPIMAGE@|$APPIMAGE|g; s|@APP_VERSION@|$APP_VERSION|g" > "$TMP"
# @SHA256:name@ and @SIZE_GB:name@
while IFS= read -r token; do
diff --git a/apps/desktop/tester/README-amd-rx7900.txt.in b/apps/desktop/tester/README-amd-rx7900.txt.in
index 45f0f7749..82efc0341 100644
--- a/apps/desktop/tester/README-amd-rx7900.txt.in
+++ b/apps/desktop/tester/README-amd-rx7900.txt.in
@@ -1,4 +1,4 @@
-STRATA FOR LINUX - TESTER BUILD FOR AMD RX 7000 (RDNA3) CARDS (RX 7900 XTX)
+STRATA @APP_VERSION@ FOR LINUX - TESTER BUILD FOR AMD RX 7000 (RDNA3) CARDS (RX 7900 XTX)
=====================================================================
This is a private test version of Strata for Linux with an AMD graphics card. Please keep it to yourself: it is not a public release.
@@ -63,7 +63,8 @@ give it that file and it can do the setup for you). The installer starts a tiny
WHAT TO SEND BACK
-----------------
-* The desktop app: Settings > Engine > Diagnostics > View logs > Save logs. Send the saved file.
+* The desktop app: Settings > Engine > Diagnostics > View logs > Save logs. Send the saved file. If the window crashed or would not open, run
+ ./@APPIMAGE@ --save-logs in a terminal instead and send the file it writes in your Downloads folder (it includes the crash log).
* The terminal app: the output of strata doctor (and uname -r , id , ls /dev/kfd /dev/dri ).
* The speed: the tokens-per-second numbers. The app shows "generating - N tok/s" while it answers. In the terminal app,
with the server running: strata bench run --url http://127.0.0.1:8080 --suite serving-smoke --repeat 2 --out ~/strata-bench-1
@@ -87,6 +88,6 @@ WHAT WE TESTED AND WHAT WE DID NOT
WHERE THINGS ARE (to remove Strata completely, delete the files and these folders)
---------------------------------------------------------------------------------
~/.strata settings, chats, prepared model files
- ~/.local/share/strata the unpacked engine and the terminal app
+ ~/.local/share/strata the unpacked engine and the terminal app, and logs/ (what the app printed, and a crash log if the window ever crashes)
~/.local/bin/strata the terminal app's command
~/Documents/Strata downloaded models (Models) and your work folder (Workspace)
diff --git a/apps/desktop/tester/README-amd-rx9070.txt.in b/apps/desktop/tester/README-amd-rx9070.txt.in
index f74d359bc..0aad07762 100644
--- a/apps/desktop/tester/README-amd-rx9070.txt.in
+++ b/apps/desktop/tester/README-amd-rx9070.txt.in
@@ -1,4 +1,4 @@
-STRATA FOR LINUX - TESTER BUILD FOR AMD RX 9000 (RDNA4) CARDS (RX 9070 XT)
+STRATA @APP_VERSION@ FOR LINUX - TESTER BUILD FOR AMD RX 9000 (RDNA4) CARDS (RX 9070 XT)
=====================================================================
This is a private test version of Strata for Linux with an AMD graphics card. Please keep it to yourself: it is not a public release.
@@ -63,7 +63,8 @@ give it that file and it can do the setup for you). The installer starts a tiny
WHAT TO SEND BACK
-----------------
-* The desktop app: Settings > Engine > Diagnostics > View logs > Save logs. Send the saved file.
+* The desktop app: Settings > Engine > Diagnostics > View logs > Save logs. Send the saved file. If the window crashed or would not open, run
+ ./@APPIMAGE@ --save-logs in a terminal instead and send the file it writes in your Downloads folder (it includes the crash log).
* The terminal app: the output of strata doctor (and uname -r , id , ls /dev/kfd /dev/dri ).
* The speed: the tokens-per-second numbers. The app shows "generating - N tok/s" while it answers. In the terminal app,
with the server running: strata bench run --url http://127.0.0.1:8080 --suite serving-smoke --repeat 2 --out ~/strata-bench-1
@@ -85,6 +86,6 @@ WHAT WE TESTED AND WHAT WE DID NOT
WHERE THINGS ARE (to remove Strata completely, delete the files and these folders)
---------------------------------------------------------------------------------
~/.strata settings, chats, prepared model files
- ~/.local/share/strata the unpacked engine and the terminal app
+ ~/.local/share/strata the unpacked engine and the terminal app, and logs/ (what the app printed, and a crash log if the window ever crashes)
~/.local/bin/strata the terminal app's command
~/Documents/Strata downloaded models (Models) and your work folder (Workspace)
diff --git a/apps/desktop/tester/README-linux.txt.in b/apps/desktop/tester/README-linux.txt.in
index c2282ec2b..a261a62b0 100644
--- a/apps/desktop/tester/README-linux.txt.in
+++ b/apps/desktop/tester/README-linux.txt.in
@@ -1,5 +1,5 @@
-STRATA FOR LINUX - TESTER BUILD
-===============================
+STRATA FOR LINUX - TESTER BUILD (Strata @APP_VERSION@)
+=====================================================
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.
@@ -61,10 +61,12 @@ 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).
+If the window crashed or would not open, the app window is not available for that: run ./@APPIMAGE@ --save-logs in a terminal instead.
+It writes strata-logs-<date>.txt in your Downloads folder (including the crash log of the window); send that file.
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
+ ~/.local/share/strata the unpacked engine, and logs/ (what the app printed, and a crash log if the window ever crashes)
~/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
index 262408e5b..65135efbb 100644
--- a/apps/desktop/tester/common-troubleshoot.txt
+++ b/apps/desktop/tester/common-troubleshoot.txt
@@ -11,8 +11,11 @@ IF IT DOES NOT START
* 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 terminal also says "The app window crashed (signal 11 ...)" and where the crash log is. 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, and run
+ ./@APPIMAGE@ --save-logs
+ which puts the crash log and the other logs into one file in your Downloads folder (it needs no window). Send us that file.
+ A crash during the very first start does not stop the engine's unpacking: Strata keeps working in the browser.
* 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@
diff --git a/tests/desktop/test_tester_readme.py b/tests/desktop/test_tester_readme.py
index d128e46a9..3e4bb2bce 100644
--- a/tests/desktop/test_tester_readme.py
+++ b/tests/desktop/test_tester_readme.py
@@ -39,7 +39,7 @@ class TesterReadmeTests(unittest.TestCase):
text = self.out.read_text()
self.assertIn(sha(app), text)
self.assertNotIn("@APPIMAGE@", text)
- for needle in ("libfuse2t64", "Ubuntu 26.04", "--browser", "--quit", NOTICE):
+ for needle in ("libfuse2t64", "Ubuntu 26.04", "--browser", "--quit", "--save-logs", "Strata 0.2.0-beta", NOTICE):
self.assertIn(needle, text)
run("--verify", self.out, "--files-dir", self.files)