Skip to content

armgit / SOMA

Public Imported from GitHub
0

Desktop app for designing parametric 3D models in CadQuery together with the coding agent of your choice

Doku: portables ZIP für Windows in README und Changelog

Kai-Jungsthoefela4d2d2a26adc
diff --git a/CHANGELOG.md b/CHANGELOG.md
index cc34bb0..d16f7d9 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -14,6 +14,8 @@ the version is bumped.
- "As CadQuery script" in the Export menu: the model as plain CadQuery that runs in CQ-editor, VS Code and other tools without SOMA, with parameters and standard parts. Importing it again gives back the original code.
- `soma cadquery export` and `soma cadquery import` on the command line, and the on-demand skill "CadQuery scripts" for converting scripts to `add_part()` and `param()`.
+- A portable ZIP for Windows on the releases page, to run SOMA without installing it.
+
### Changed
- A tidier start page: Recent models come first, with a filter by name. New model and Open sit next to the title, "From CadQuery script" in the arrow menu of New model. The agents take less space, and any other CLI agent works too. "Back to …" names the open model, Esc goes back as well.
diff --git a/README.md b/README.md
index c1c1621..ccd97ec 100644
--- a/README.md
+++ b/README.md
@@ -18,11 +18,11 @@ SOMA is not an agent of its own. Any CLI agent that can read files and run comma
## Install
-Download the package for your system from the [releases](https://github.com/Kai-Jungsthoefel/SOMA/releases): an installer for Windows, an AppImage or tar.gz for Linux, a dmg for macOS (Apple Silicon). Python, CadQuery, Git and CalculiX are included.
+Download the package for your system from the [releases](https://github.com/Kai-Jungsthoefel/SOMA/releases): an installer or a portable ZIP for Windows, an AppImage or tar.gz for Linux, a dmg for macOS (Apple Silicon). Python, CadQuery, Git and CalculiX are included.
- You need a CLI agent installed and logged in, for example Claude Code, OpenCode, Codex CLI or Gemini CLI. SOMA does not bring one
- The installed app takes over 1 GB of disk space, most of it for Python, CadQuery and OpenCascade
-- The packages are not signed yet. On Windows, SmartScreen warns on the first start ("More info" > "Run anyway"). On macOS, open the app the first time with right-click > Open
+- The packages are not signed yet. On Windows, SmartScreen warns on the first start ("More info" > "Run anyway"). For the portable ZIP, tick "Unblock" in its Properties before extracting to avoid the warning, and extract it to a local folder. On macOS, open the app the first time with right-click > Open
- Linux needs glibc 2.31 or newer
- There is no automatic update. Download a new version from the releases page
diff --git a/app/README.md b/app/README.md
index 3ddadad..e2b1a22 100644
--- a/app/README.md
+++ b/app/README.md
@@ -57,7 +57,7 @@ Jedes Betriebssystem baut sein eigenes Paket, die Python-Basisumgebung, CalculiX
```
# 1. Python-Basisumgebung: eigenständiges Python 3.12 (python-build-standalone über uv) mit requirements-base.txt, soma und CalculiX
python ../python/scripts/build_runtime.py --target "$LOCALAPPDATA/soma-dev/python-runtime"
-# 2. Paket (Windows: NSIS-Installer, Linux: AppImage und tar.gz, macOS: dmg für Apple Silicon)
+# 2. Paket (Windows: NSIS-Installer und ZIP, Linux: AppImage und tar.gz, macOS: dmg für Apple Silicon)
SOMA_RUNTIME="$LOCALAPPDATA/soma-dev/python-runtime" SOMA_RELEASE="$LOCALAPPDATA/soma-dev/release" npm run dist
# nur den entpackten Ordner (schneller, zum Prüfen): npm run dist:dir
# 3. Smoke-Suite gegen die gepackte App
@@ -67,7 +67,7 @@ SOMA_TEST_EXE="$LOCALAPPDATA/soma-dev/release/win-unpacked/SOMA.exe" node test/s
- Ohne `--target` und `SOMA_RUNTIME` liegt die Basisumgebung in `app/python-runtime`, die Pakete in `app/release` (beide in `.gitignore`). In einem synchronisierten Ordner (OneDrive, Netzlaufwerk) besser nicht: rund 1,4 GB in Zehntausenden Dateien.
- **Basisumgebung:** Ein venv lässt sich nicht verschieben, deshalb ein eigenständiges Python. Die Startprogramme (`soma`, `pip` …) bekommen einen relativen Pfad zum Python: unter Windows als `.cmd` (PowerShell, cmd) und ohne Endung (Git Bash), sonst als Shell-Vorspann. `build_runtime.py` prüft am Ende eine Kopie in einem Ordner mit Leerzeichen. `EXTERNALLY-MANAGED` bleibt, pip installiert nur in die Projektumgebung (E67).
- **Im Paket:** `resources/python` (Basisumgebung, `paths.ts` findet sie vor der Entwicklungsumgebung), `resources/app` mit `dist/`, `resources/` und nur `dugite` und `node-pty` aus `node_modules` (alles andere bündelt esbuild), ohne asar. Dazu `LICENSE.txt`, `MODEL-EXCEPTION.md` und `THIRD_PARTY_NOTICES.md` (von Hand gepflegt). Die Lizenztexte der npm-Pakete sammelt `esbuild.config.mjs` beim Build nach `dist/licenses/<paket>@<version>/`, weil esbuild sie beim Bündeln verliert.
-- **Windows:** Installation für den Nutzer nach `%LOCALAPPDATA%\Programs\SOMA` ohne Adminrechte, unsigniert (SmartScreen warnt beim ersten Start).
+- **Windows:** Installation für den Nutzer nach `%LOCALAPPDATA%\Programs\SOMA` ohne Adminrechte, unsigniert (SmartScreen warnt beim ersten Start). Dazu `win-unpacked` als ZIP zum Entpacken ohne Installation (nicht das Ziel `portable`, das bei jedem Start nach %TEMP% entpackt). Die App-Daten liegen auch dann unter `%APPDATA%`. Windows überträgt die Download-Markierung (Mark of the Web) beim Entpacken mit dem Explorer auf alle Dateien, ohne „Zulassen“ in den Eigenschaften des ZIPs warnt SmartScreen beim Start von `SOMA.exe` genauso.
- **macOS:** nur Apple Silicon (für Intel fehlt `cryptography` als Wheel), ad-hoc signiert, nicht notarisiert: Gatekeeper lässt die App erst nach Rechtsklick > Öffnen oder `xattr -cr /Applications/SOMA.app` starten. Die installierte App übernimmt beim Start den PATH einer Login-Shell, sonst fänden Agenten-Erkennung und Terminals nichts aus Homebrew oder npm.
- **Linux:** gebaut unter Ubuntu 22.04, braucht glibc 2.31 oder neuer (cadquery-ocp). gmsh braucht libGLU, libXft, libXinerama und libXcursor, `build_runtime.py` liefert sie mit. Ohne nutzbaren Grafiktreiber (VM, Remote-Desktop, xvfb) sperrt Chromium WebGL, bekommt der Viewer deshalb kein WebGL, merkt die App sich das in den App-Daten (`software-gl`) und startet mit `--ignore-gpu-blocklist` neu (Software-Rendering, `main.ts`). Die Tests legen den Merker unter xvfb vorab an (`SOMA_TEST_SOFTWARE_GL=1`). Unter Ubuntu 24.04 und neuer kann AppArmor die Sandbox von Electron im AppImage blockieren.
- Geprüft mit der Smoke-Suite: Windows (lokal und CI), Linux unter WSL mit Ubuntu 24.04 und xvfb, macOS in der CI (dort scheitern nur die Prüfungen mit Koordinaten im Viewer, der Bildschirm des Runners ist zu klein). Auf echten Rechnern kurz ausprobiert (2026-10-11): Linux unter Kubuntu mit Grafikkarte, macOS mit Apple Silicon, beide starten mit 3D-Ansicht.