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++
Docs: add SAFETY.md (what Strata downloads, when it uses the internet, what stays local, how downloads are checked, what the agent may do) and link it
Niko122125492e4a6bc4
diff --git a/README.md b/README.mdindex f608ad23a..21b1ea666 100644--- a/README.md+++ b/README.md@@ -29,6 +29,7 @@ agents. Nothing leaves your PC.- **Works with your tools.** It speaks the OpenAI and Anthropic APIs, so Claude Code, Codex CLI, OpenCode and other agents connect to it.- **Reads pictures.** They are on by default.- **Free.** MIT license, no account, no cloud.+- **Private.** No telemetry. What Strata downloads, when it uses the internet and how it checks downloads is in [docs/SAFETY.md](docs/SAFETY.md).Version 0.2.0-beta · engine 0.1.45.3diff --git a/SECURITY.md b/SECURITY.mdindex 8b05515e2..85ad66c26 100644--- a/SECURITY.md+++ b/SECURITY.md@@ -92,3 +92,4 @@ If that is not enough: save the script (`curl -fsSLO https://github.com/Niko1221run it from the file; or install the desktop app or build from source instead and check the code you build.Strata has not had an outside security audit yet.+What Strata downloads, when it uses the internet, what stays on your PC and how downloads are checked is written up in [docs/SAFETY.md](docs/SAFETY.md).diff --git a/docs/INSTALL.md b/docs/INSTALL.mdindex ec533147f..74cf35334 100644--- a/docs/INSTALL.md+++ b/docs/INSTALL.md@@ -227,7 +227,8 @@ any PC (to try it). Problems and results on real hardware are welcome as GitHub**The Terminal:** `strata update --check`, then `strata update` (see [the Terminal](#the-terminal)). Add `--app` todownload the app's installer too. Models and saved tuning presets are never downloaded, replaced or deleted by an-update. How the signed update feed works: [packaging/UPDATES.md](../packaging/UPDATES.md).+update. How the signed update feed works: [packaging/UPDATES.md](../packaging/UPDATES.md). What Strata downloads and+how it checks it: [SAFETY.md](SAFETY.md).**From source: `UPDATE.bat`** (Linux: `./update.sh`) updates Strata without starting the model - for when the GPU is busy withsomething else, or you just want the new version ready. In a `git clone` it runs `git pull`, then does whatdiff --git a/docs/SAFETY.md b/docs/SAFETY.mdnew file mode 100644index 000000000..8d243ff32--- /dev/null+++ b/docs/SAFETY.md@@ -0,0 +1,189 @@+# Is Strata safe and private?++This page says what Strata downloads, where from, when it uses the internet, what stays on your PC and how the downloads+are checked. Everything here comes from reading the code of this version. Each section names the files, so you or anyone+you trust can check it. Where Strata does less than you might hope, the page says so.++## At a glance++- **Your chats, prompts, files, pictures and models stay on your PC.** They leave only when you choose it: you add an+ outside model service, you open the server to other devices or to the internet, or the agent searches the web or opens a page+ (see [What the agent can do](#what-the-coding-agent-can-do-on-your-pc)).+- **There is no telemetry.** Strata sends no usage data, no crash reports and no analytics, and has no account to sign in to.+- **Starting and running a model never downloads anything.** Downloads and updates are separate steps that you start.+- **The server listens on your PC only.** Reaching it from another device needs an API key.+- **Downloads are checked.** Updates come from a signed feed. Some model files are checked against a fixed SHA-256, others+ against a fixed version of their repository and for completeness (the details are [below](#how-downloads-are-checked)).+- **The coding agent asks before it changes anything** in its default mode. It does not ask before it searches the web.+- **The code is open.** Anyone can read it, and security problems go to [SECURITY.md](../SECURITY.md).++## Does Strata phone home?++No. A search of the app, the Terminal, the engine server and the installers found no analytics library, no crash+reporter and no code that reports usage anywhere. The app's privacy notes say the same+(`apps/host/src/components/PrivacyNotes.tsx`: "Strata sends no usage telemetry").++Some things sound similar and stay on your PC:++- The Monitor, `/metrics` and `/v1/telemetry` show hardware readings (temperature, speed, memory) to you. They are served+ from your own PC, and they need your API key when you set one.+- On Linux, when the app window crashes, a crash log is written to a folder on your disk. Nothing sends it. **Save logs**+ (Settings, Engine, Diagnostics) puts a text file in your Downloads folder, and you decide whether to attach it to a bug report.+- The coding agent is a separate component (the DeepSeek Harness, MIT). It has its own telemetry switch, and Strata starts it+ with that switch off (`apps/host/server/agent/harness-runtime.mjs`).++Like any download, each connection below shows the other side your IP address and the file you asked for.++## When Strata uses the internet++| What | Where it goes | When |+| --- | --- | --- |+| Model files, the picture reader, the speed-up layer (MTP) | huggingface.co, or the mirror in `HF_ENDPOINT` if you set one | When you install a model |+| The same files from ModelScope, for PCs that cannot reach Hugging Face | modelscope.cn | Only if you ask for it (`--source modelscope`). Strata never switches to it by itself |+| Engine, Terminal and Control updates | The signed feed on GitHub Releases of Niko1221/Strata | When you install an engine, press **Update engine**, or run `strata update`. Opening **Settings, Engine** in the app also reads the feed to see whether an update exists |+| App updates | `latest.json` on the same GitHub Releases, through Tauri's updater | When you press **Check for updates** or **Update Strata**, and when you open **Settings, Engine** |+| llama.cpp source code (a fixed commit) | github.com/ggml-org/llama.cpp | During a model install, if it is not on your PC yet. Strata uses only its model-preparation scripts |+| Web search and web pages | DuckDuckGo, with Bing as the second source; or Exa, Perplexity or DeepSeek if you save a key for them. Any page the agent is asked to open goes to that page's site | When the agent uses its search or "open web pages" tool |+| Outside model services | The service you add (OpenAI, Anthropic, OpenRouter, a server on your network and others) | Only for chats with that model, and only after you add its key |+| Cloudflare tunnel | Cloudflare, through the `cloudflared` program | Only while you have the tunnel on, and it will not start without an API key |+| Tailscale, local network | Not Strata's traffic. Strata only reads Tailscale's status and shows the address | Only if you choose that access in `strata launch` |+| An image link in an API request | The address in the link | Only when a program sends your server a request with an `http(s)` image link. `--offline` refuses it |+| Remote tool servers (MCP) | The address you put in the run config | Only when you add one |+| A website you open in the app's preview pane | That website | Only when you type an address into **Open a website** |+| Share to X or Reddit (Monitor screenshot) | Your browser opens x.com or reddit.com with a caption and a link to the Strata page | Only when you click it. The screenshot is saved to your disk, not uploaded |++That is the full list found in the code. Some details:++- **Nothing checks for updates in the background.** The app does not check when it starts. The checks in the table run when+ you open Settings, Engine, press a button or run a command. The Terminal fetches an engine by itself only when none is+ installed, and `strata launch` asks first.+- **Starting and serving never download.** `strata serve` and the app's load button fetch nothing. The app sets+ `STRATA_PACKAGED=1` and `STRATA_NO_ACQUIRE=1` for its parts (`apps/desktop/src-tauri/src/main.rs`), and the downloaders+ refuse to run under them (`strata_control/acquisition.py`, `apps/host/server/acquisition.mjs`). That is why the app+ never downloads `cloudflared` for you while it runs.+- **The engine itself has no network code.** The part of Strata that runs the model (`src/`, `include/`, `sycl/`, `metal/`)+ contains no networking. The app's own pages load no fonts, scripts or trackers from the internet.+- **Building from source** reaches more places. Python from python.org or winget (`START-HERE.bat`), a standalone Python+ from GitHub on a Mac (`setup.sh`), Python packages from PyPI (`requirements.txt`, pinned versions), NVIDIA's CUDA libraries+ from PyPI and, on Ubuntu and Debian, NVIDIA's apt key and packages, AMD's ROCm wheels, the Vulkan SDK from LunarG, and+ llama.cpp and stable-diffusion.cpp source from GitHub. These run only while you run the setup.++## What stays on your PC++- **Chats, prompts, attached files and pictures** are handled by the engine on your PC. The app keeps chats in its own+ storage on your disk. Models are in the folder you chose.+- **API keys** you save for outside services are kept in a file that only your user account can open. They are not+ encrypted. (`apps/host/server/model-providers.mjs`)+- **The server listens on `127.0.0.1`**, this PC only. The app fixes that address (`STRATA_BIND=127.0.0.1`), and the engine+ server's default is the same (`serve/server.py`, the `--host` option).+- **Sharing needs a key.** The app's "Share with other devices" and the Cloudflare tunnel will not start without an API+ key, and the shared port answers only `/v1/models`, `/v1/chat/completions` and `/v1/messages`+ (`apps/host/server/local-share.mjs`, `cloudflare.mjs`). `strata launch` makes a key for you when you pick anything wider than+ this computer. The bare engine server (`serve/server.py`) only prints a warning if you open it to your network without a key,+ so set one yourself in that case.+- **When you use an outside model**, the conversation (and the instructions of skills you switched on) go to that service.+ The app says so in its privacy notes. The service's own rules then apply.+- **Programs you connect** (Claude Code, Codex, and so on) are separate programs with their own network behaviour. Strata+ does not control what they send.++The server also has browser protections (a host check, an origin check, no CORS by default). They are in+[SECURITY.md](../SECURITY.md#what-the-server-exposes).++## How downloads are checked++**Updates for the engine, the Terminal and Control.**++1. The release publishes `strata-feed.json` and `strata-feed.json.sig`, signed with an Ed25519 key. The matching public key is+ inside every installed Strata (`strata_control/update_keys.json`). The private key is kept offline by the owner.+2. Before it uses the feed, your PC checks the signature, that the feed has not expired and that it is not older than the+ last feed it accepted (so an old feed cannot be replayed).+3. Each engine package is checked against its SHA-256 and its signed manifest, then every file in it against its own hash,+ then it is checked to fit your PC.+4. The new engine is test-started before Strata switches to it. If anything fails, you keep the engine you had.++Updates never replace your models or saved tuning. The full description is in [packaging/UPDATES.md](../packaging/UPDATES.md).++**The app.** Its updates are signed with a separate key (Tauri's minisign), and the public half is in the app+(`apps/desktop/src-tauri/tauri.conf.json`). The updater refuses an installer whose signature does not match. The Terminal+checks the same signature when you run `strata update --app`.++**Model files.** There are two levels, and they are not the same.++- *A fixed SHA-256 and size per file*: the Unsloth sizes, the Gyro files, Qwen3.6, the NVFP4 packs, the image model files+ and the speed-up layer (MTP, tensor by tensor). A file that does not match is deleted and the install stops+ (`setup.py`, `verify_sha256`; `tools/mtp_fetch.py`; `apps/host/server/image-models.mjs`).+- *A fixed repository version, with no SHA-256*: the main Qwen3.8-Flash-Next files (Q2_0, IQ2_XS, IQ3_XXS, IQ3_S), Swift 1.5 and+ the Coder, and the picture reader. Strata downloads them from a fixed commit of the repository and checks that each file is+ complete, but it does not compare a hash. If that commit has disappeared from Hugging Face, setup says so and takes the+ repository's current file instead (`setup.py`, `HF_REVISIONS` and `download`).+- Files from ModelScope are checked against the SHA-256 that ModelScope itself publishes. Setup warns when it publishes none.+- The app also has a short model list of its own (`apps/host/server/real-model-catalog.mjs`). The app downloads those files+ from the repository's current `main` branch and checks that they have about the expected size.++**Engine in the source route.** `setup.py` checks the engine zip against the SHA-256 that GitHub's API publishes for that+release file. If GitHub cannot say (offline, rate limit), setup warns and installs anyway. `STRATA_SKIP_SHA256=1` switches the+check off, and it is never on by default.++**The one-line install** (`curl ... | sh`, `irm ... | iex`) checks the Terminal archive's SHA-256 and the signed feed with the+Terminal it just unpacked. The checksum and the key come from the same release as the archive, so the first install trusts+HTTPS and the `Niko1221/Strata` release itself. What that means, and how to read the script first, is in+[SECURITY.md](../SECURITY.md#how-far-to-trust-curl--sh-and-irm--iex). Later updates are checked against the key already on+your PC.++**Code signing.** The Windows installer is not code-signed yet, so Windows shows "Windows protected your PC". The signing and+Apple notarisation of the Mac builds is set up in `packaging/mac/` and is run by the owner on his Mac. A Mac build that has not+been notarised shows macOS's "damaged" warning ([MAC.md](MAC.md)).++**What the checks do not cover.** They catch a damaged or swapped download and a feed nobody signed with the release key. They+cannot protect you if someone who can publish a release (or who holds the signing key) publishes something harmful.++## What the coding agent can do on your PC++The app's chats run through an agent that can read files, run commands, edit files, search the web and use tools you+connect. What it may do without asking depends on the **Mode** menu (`apps/host/server/agent/README.md`).++| Mode | What happens |+| --- | --- |+| **Manual** (the default) | Anything that changes something asks first, with one **Approve** or **Deny** card, before it runs. |+| **Plan** | Nothing can change. A request to change something is refused, and no card appears. Tools you connect are refused too. |+| **Bypass** | Full access, no questions. |++In **Manual**:++- **These ask:** writing or editing a file, any command that is not on a short list of look-only commands, and every tool+ you connect. In the browser tool, opening a page, clicking and typing ask.+- **These do not ask:** reading files, listing and searching folders, and look-only commands such as `ls`, `cat` and+ `git status`. A command with a redirect, a chain (`;`, `&&`), a variable or anything else the check does not recognise asks.+- **Web search and opening web pages do not ask.** They are on by default and can be switched off in Settings, Tools. The+ model picks the search words and the address, so words from your conversation can end up in a search or a web address+ (`strata-gate.mjs` lists both as read-only).+- **The chat folder is only where the agent starts.** Manual mode does not confine it there. What you+ approve can touch anything your user account can touch, so read the card before you press Approve.+- **Your keys stay out of its commands.** The agent's shell does not get environment variables whose names contain KEY, TOKEN,+ SECRET, PASSWORD, CREDENTIAL or AUTH.+- **Scheduled tasks** run in Plan mode by default. With nobody at the screen, a request for approval is answered "no".+- **Stop** ends a chat's run. Closing a tab does not.++The agent runs on a loopback address with a random token, so other programs on the network cannot reach it.++## Open source and reporting a problem++Strata is MIT-licensed and the whole code is at [github.com/Niko1221/Strata](https://github.com/Niko1221/Strata). Read it, build+it and compare. Strata has not had an outside security audit yet.++To report a security problem, use GitHub's private reporting (the repository's **Security** tab), as described in+[SECURITY.md](../SECURITY.md). Ordinary questions and ideas can go to an+[issue](https://github.com/Niko1221/Strata/issues).++## Where to check this in the code++| Topic | Files |+| --- | --- |+| Model downloads and pins | `setup.py`, `tools/mtp_fetch.py`, `tools/image/qimage.py`, `apps/host/server/models.mjs`, `image-models.mjs` |+| Update feed, signatures | `strata_control/feed.py`, `signing.py`, `transfer.py`, `update_keys.json`, `strata_cli/update_cmd.py` |+| App updater | `apps/desktop/src-tauri/src/updater.rs`, `apps/desktop/src-tauri/tauri.conf.json` |+| Downloads refused while running | `strata_control/acquisition.py`, `apps/host/server/acquisition.mjs` |+| One-line installers | `packaging/install.sh`, `packaging/install.ps1` |+| Web tools and the agent's approvals | `apps/host/server/agent/plugins/strata-gate.mjs`, `agent/profile.mjs`, `web-search-ddg.mjs`, `web-search-bing.mjs`, `web-search-keyed.mjs` |+| Outside model services | `apps/host/server/model-providers.mjs` |+| Sharing, tunnel | `apps/host/server/local-share.mjs`, `cloudflare.mjs`, `strata_cli/launch/access.py` |