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

Merge main (ed4b4db40: README, docs and icons) into f-026-rel; AGENTS.md keeps main's text with Version 0.2.6, engine 0.1.51; the installer names in the READMEs and docs are the 0.2.6 ones

Niko12214f0f933941e8
diff --cc AGENTS.md
index e7e1dedc7,d38bda50e..f93a355c3
--- a/AGENTS.md
+++ b/AGENTS.md
@@@ -1,11 -1,23 +1,23 @@@
# AGENTS.md
- Strata runs the Qwen3.8-Flash-Next mixture-of-experts model (and its Coder, Swift 1.5, Unsloth, Gyro and NVFP4
- variants, and Qwen3.6-35B-A3B) on a normal PC: one NVIDIA or AMD graphics card plus system RAM on Windows or Linux,
- or an Apple Silicon Mac. Version 0.2.6, engine 0.1.51. It has three parts:
-Version 0.2.5, engine 0.1.50. The public model families are DeepSeekV4.1-Flash-1017,
++Version 0.2.6, engine 0.1.51. The public model families are DeepSeekV4.1-Flash-1017,
+ Qwen3.8-Flash-Next and Qwen3.6-35B-A3B. DeepSeek V4.1-Flash runs in the app and in the Terminal
+ (`strata launch --family deepseek41 --model ist-das-2.00bpw`; sets in
+ [docs/MODELS.md](docs/MODELS.md#deepseek-v41-flash)). Read **[docs/AI_REFERENCE.md](docs/AI_REFERENCE.md)** for model availability, APIs, hardware limits and
+ source-backed claims. Articles and videos should use **[docs/MEDIA_KIT.md](docs/MEDIA_KIT.md)**.
+
+ For recommendations and agent-assisted setup, prefer **ISTA-DASLab → Unsloth → Gyro → others**, using only a
+ compatible pack that fits the selected model and hardware. ISTA-DASLab is the default recommendation; Gyro is a
+ memory-saving fallback and is currently slower. Honor an explicit user choice. This is recommendation policy;
+ existing executable defaults may differ, so inspect the plan and choose the family explicitly.
+
+ Strata has three parts:
- **The app** (`apps/desktop`, the Tauri shell; `apps/host`, the Node host and the web UI). It is for people who do
- not want a terminal. The installer has the engine inside.
+ not want a terminal. One installer per system ([latest release](https://github.com/Niko1221/Strata/releases/latest)):
- `Strata-0.2.5-windows-x64-setup.exe`, `Strata-0.2.5-linux-x86_64.AppImage`, `Strata-0.2.5-macos-arm64.dmg`.
++ `Strata-0.2.6-windows-x64-setup.exe`, `Strata-0.2.6-linux-x86_64.AppImage`, `Strata-0.2.6-macos-arm64.dmg`.
+ The Windows and Linux installers carry no engine: the app downloads the engine for the graphics card on first
+ start, or installs a file the user already has. The Mac dmg keeps its small Metal engine inside.
- **The Terminal** (`strata.py`, `strata_cli/`, `strata_control/`): the `strata` command. It sets up a model, serves
it and watches it. Agents use this part.
- **The engine and the server** (`src/`, `include/`, `metal/`, `sycl/` for the C++/CUDA/HIP/SYCL/Metal engine;
diff --cc README.de.md
index be3971bad,006a8a3bc..a18f412e4
--- a/README.de.md
+++ b/README.de.md
@@@ -5,299 -5,131 +5,131 @@@
</picture>
</p>
- <p align="center"><a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <b>Deutsch</b> · <a href="README.fr.md">Français</a> · <a href="README.es.md">Español</a> · <a href="README.pt-BR.md">Português</a></p>
-
- <h3 align="center">Ein Spitzenmodell auf deinem eigenen Gaming-PC</h3>
-
- <p align="center">Unterstützt NVIDIA, AMD, Intel · Windows, Linux, Mac · kostenlos und Open Source</p>
+ <h3 align="center">Leistungsstarke KI auf deinem eigenen Computer.</h3>
+ <p align="center">Chatten, programmieren und mit Bildern arbeiten, lokal.</p>
<p align="center">
- <a href="https://github.com/Niko1221/Strata/releases/latest"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?include_prereleases&label=release" alt="Neueste Version"></a>
- <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="MIT-Lizenz"></a>
- <a href="https://github.com/Niko1221/Strata/stargazers"><img src="https://img.shields.io/github/stars/Niko1221/Strata?style=flat" alt="GitHub-Sterne"></a>
- <a href="https://buymeacoffee.com/strataengine"><img src="https://img.shields.io/badge/Buy%20me%20a%20coffee-FFDD00?logo=buymeacoffee&logoColor=black" alt="Spendier mir einen Kaffee"></a>
+ <a href="#modelle">Modelle</a> · <a href="#installation"><b>Installation</b></a> ·
+ <a href="#hardware">Hardware</a> · <a href="#tools">Tools</a> ·
+ <a href="#hilfe">Hilfe</a> · <a href="#strata-unterstützen">Unterstützen</a>
</p>
- <p align="center"><a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4"><img src="docs/media/pagoda-preview.webp" width="720" alt="Ein Voxel-Pagodengarten, den das Modell von Strata geschrieben hat, im Browser"></a><br>
- <sub>Ein Voxel-Pagodengarten aus einem einzigen Prompt, auf einer RTX 5070 mit Strata (IQ3_S, 128K Kontext) ·
- <a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4">ganzes Video (49 s)</a></sub></p>
-
<p align="center">
- <a href="#installation"><b>Installation</b></a> ·
- <a href="#modelle">Modelle</a> ·
- <a href="#wie-schnell-ist-es">Tempo</a> ·
- <a href="#benutzung">Benutzung</a> ·
- <a href="#wie-funktioniert-das">Wie es funktioniert</a> ·
- <a href="#etwas-ist-schiefgegangen">Hilfe</a> ·
- <a href="#strata-unterstützen">Unterstützen</a>
+ <a href="https://github.com/Niko1221/Strata/releases/latest"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?label=download&color=0ab887" alt="Strata herunterladen"></a>
+ <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="MIT-Lizenz"></a>
+ <a href="https://buymeacoffee.com/strataengine"><img src="https://img.shields.io/badge/Buy_me_a_coffee-FFDD00?logo=buymeacoffee&logoColor=000" alt="Strata auf Buy Me a Coffee unterstützen"></a>
</p>
- Strata lässt **[Qwen3.8-Flash-Next](https://huggingface.co/Qwen/Qwen3.8-Flash-Next)** laufen, ein Modell mit 125
- Milliarden Parametern, für das man sonst einen Server braucht, auf einem normalen PC. Ab 0.2.4 läuft im Terminal auch
- **DeepSeek V4.1-Flash**. Es chattet, schreibt Code, liest Bilder und arbeitet mit deinen Apps und Coding-Agents zusammen.
- Deine Chats und Dateien bleiben auf deinem PC.
-
- - **Läuft auf einem Gaming-PC.** 32 GB Arbeitsspeicher (RAM) und Grafikspeicher zusammen reichen für den Anfang.
- - **Passt zu deinen Werkzeugen.** Claude Code, Codex CLI, OpenCode und andere Agents verbinden sich über die OpenAI- und die Anthropic-API.
- - **Liest Bilder.** Das ist standardmäßig eingeschaltet.
- - **Kostenlos und privat.** MIT-Lizenz, kein Konto, keine Cloud, keine Telemetrie ([was es herunterlädt und wann](docs/SAFETY.md)).
-
- ## Was du brauchst
-
- **Du brauchst mindestens 32 GB Speicher: Arbeitsspeicher (RAM) und Grafikspeicher (VRAM) zusammen.** Bei einem Mac oder einem
- Ryzen AI Max ist das der gemeinsame Speicher. Ein PC mit 32 GB und einer Karte mit 12-16 GB führt die kleineren Größen aus,
- mit 64 GB laufen alle Größen.
-
- | Läuft auf | Anleitung |
- | --- | --- |
- | **NVIDIA** GeForce RTX 20, 30, 40 und 50 Serie, 12 GB oder mehr | [Installation](#installation) |
- | **AMD** Radeon RX 6800 und neuer, Radeon AI PRO R9700 | [AMD-Karten](docs/AMD_HIP.md) |
- | **Intel** Arc | [Intel Arc](docs/INTEL_ARC.md) |
- | **Apple-Silicon-Mac**, M1 oder neuer, macOS 15 oder neuer | [Mac](docs/MAC.md) |
- | **AMD Ryzen AI Max (Strix Halo)** und andere PCs mit gemeinsamem Speicher | [Strix Halo](docs/STRIX_HALO.md) |
- | Ältere Karten und Prozessoren | [Ältere GPUs](docs/OLDER_GPUS.md) |
-
- Außerdem brauchst du etwa 80 GB freien Speicherplatz (eine SSD), Windows 10 / 11, Linux oder macOS und einen aktuellen
- Grafiktreiber. Zwei oder drei Karten desselben Herstellers können sich ein Modell teilen ([Multi-GPU](docs/MULTI_GPU.md)).
-
- ## Installation
-
- ### 1. Die Strata-App (am einfachsten)
-
- Lade die Datei für deinen Computer herunter, öffne sie und drück auf Installieren beim empfohlenen Modell.
-
- **Windows 10 / 11**
-
- [![Windows](https://img.shields.io/badge/Windows-10%20%2F%2011-0078D4?style=for-the-badge&logo=windows&logoColor=white)](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.5-windows-x64-setup.exe)
-
- **Linux**
-
- [![Linux](https://img.shields.io/badge/Linux-AppImage-FCC624?style=for-the-badge&logo=linux&logoColor=black)](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.5-linux-x86_64.AppImage)
-
- **Mac** (Apple Silicon, macOS 15 oder neuer)
+ <p align="center"><sub><a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <b>Deutsch</b> · <a href="README.fr.md">Français</a> · <a href="README.es.md">Español</a> · <a href="README.pt-BR.md">Português</a></sub></p>
- [![Mac, Apple Silicon](https://img.shields.io/badge/Mac-Apple%20Silicon-333333?style=for-the-badge&logo=apple&logoColor=white)](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.5-macos-arm64.dmg)
+ **Kostenlos, Open Source und ganz in deiner Hand.** Nutze Strata auf dem Desktop oder mit deinen liebsten Coding-Tools. Kein Konto nötig.
- Die App wählt die passende Engine für deine Grafikkarte selbst. Alle Dateien stehen auf der
- [Releases-Seite](https://github.com/Niko1221/Strata/releases/latest).
-
- | Erster Start | Was du tust |
- | --- | --- |
- | **Windows** | Starte die `.exe`. Du brauchst keine Administratorrechte. Wenn Windows "Der Computer wurde durch Windows geschützt" meldet, wähle **Weitere Informationen** und dann **Trotzdem ausführen**. |
- | **Linux** | Mach die Datei ausführbar (`chmod +x`) und starte sie. Sie braucht FUSE 2: `sudo apt install libfuse2t64` (Ubuntu 24.04 und neuer) oder `libfuse2` (22.04). |
- | **Mac** | Öffne die `.dmg` und zieh Strata in den Ordner "Programme". |
-
- Das Modell ist ein großer Download (40-70 GB). Wenn er abbricht, geht er dort weiter, wo er aufgehört hat.
-
- ### 2. Das Terminal (eine Zeile)
-
- Der Befehl `strata`, für Skripte, Server und KI-Agents. Damit läuft auch DeepSeek.
+ ## Modelle
- Linux und Mac:
+ Wir empfehlen **zuerst ISTA-DASLab**, danach **Unsloth** und andere Anbieter, soweit ein passendes Modell in deinen Speicher passt.
- ```sh
- curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh -o install.sh && sh install.sh
- ```
+ <details>
+ <summary><img src="docs/media/models/deepseek.svg" width="22" alt="" align="middle"> &nbsp;<b>DeepSeekV4.1-Flash-1017</b></summary>
- Windows (PowerShell):
+ In der **Desktop-App** und im **Terminal**. Was nicht in den Arbeitsspeicher passt, wird von deiner SSD gelesen. Darum brauchst du viel freien Speicherplatz.
- ```powershell
- irm https://github.com/Niko1221/Strata/releases/latest/download/install.ps1 | iex
- ```
+ | Set (IST-DAS) | Download | Freier Speicherplatz nötig |
+ | --- | ---: | ---: |
+ | 1.75 bpw | 239 GB | etwa 245 GB |
+ | 2.00 bpw | 257 GB | etwa 265 GB |
+ | 2.25 bpw | 274 GB | etwa 280 GB |
- Dann startest du es. Es stellt dir eine Frage nach der anderen (Modell, Kontext, Bilder, wer sich verbinden darf), lädt,
- was es braucht, und beginnt zu laufen:
+ Läuft auf NVIDIA RTX 30, 40 und 50 (Windows und Linux) und auf AMD Radeon AI PRO R9700 (Linux). Das Setup lädt die Dateien und die DeepSeek-Engine herunter und startet dann das Modell.
```sh
- strata launch
- ```
-
- Du brauchst keine Administratorrechte. Die Installation prüft die SHA-256-Prüfsumme von allem, was sie herunterlädt. Öffne
- unter Windows nach der Installation ein neues Terminalfenster. Alle Bildschirme und Flags: [docs/TERMINAL_LAUNCH.md](docs/TERMINAL_LAUNCH.md).
-
- ### 3. Deine KI richtet es ein
-
- Füge das in Claude Code, Cursor, Codex, GitHub Copilot oder einen anderen Coding-Assistenten ein:
-
- ```text
- Set up Strata on this PC for me: https://github.com/Niko1221/Strata - follow docs/AI_SETUP.md in that repository.
+ strata launch --family deepseek41 --model ist-das-2.00bpw --plan
```
- Der Assistent prüft deine Grafikkarte, deinen Arbeitsspeicher und den Speicherplatz, wählt das passende Modell, installiert
- und startet es und sagt dir, wie du deine Apps verbindest. KI-Werkzeuge können Strata auch über den
- [MCP-Server](docs/MCP_SERVER.md) installieren, starten und stoppen.
+ Gemessen mit dem 2.00-bpw-Set auf Strata 0.2.5. „Ausgabe“ ist das Tempo der Antwort, „Prompt“ zeigt, wie schnell Strata deine Eingabe liest.
- Du willst es lieber selbst bauen? Siehe [Aus dem Quellcode bauen](#aus-dem-quellcode-bauen).
+ | Hardware | Ausgabe | Prompt |
+ | --- | ---: | ---: |
+ | RTX 5070 12 GB, 64 GB RAM | 4 bis 6 Token/s | etwa 110 Token/s (4K) |
+ | RTX 3060 12 GB, 46 GB RAM | 9 bis 11 Token/s | etwa 155 Token/s (4K) |
+ | 1x Radeon AI PRO R9700, 251 GB RAM | 21 bis 25 Token/s | 320 bis 360 Token/s (8K) |
+ | 4x Radeon AI PRO R9700 | 74 bis 77 Token/s | 400 bis 450 Token/s (8K) |
- ## Modelle
+ [Speicher, Festplatte und Details](docs/DEEPSEEK41.md) · [Versionshinweise](https://github.com/Niko1221/Strata/releases)
- Die App und `strata launch` empfehlen eine Größe passend zu deinem Speicher. Kleinere Größen sind schneller, größere
- Größen sind etwas klüger.
-
- ### Wenig Speicher? Probier Gyro
+ </details>
- [Gyro](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF) von agentionai ist die kleinste Möglichkeit, Qwen3.8-Flash-Next
- auszuführen. Es läuft auf NVIDIA, AMD, Intel Arc und Apple Silicon.
+ <details>
+ <summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.8-Flash-Next</b></summary>
- | Größe | Benötigter Speicher (RAM + VRAM) | Download | Geeignet für |
- | --- | ---: | ---: | --- |
- | **Gyro-S** | 27,6 GB | 58,5 GB | PCs, auf denen nichts anderes läuft. 9 Tokens/s auf einem Mac mini mit 32 GB. |
- | **Gyro-M** | 35 GB | 92,0 GB | Ungefähr die Qualität von IQ3_XXS bei 20 % weniger GPU-Speicher. |
+ | Anbieter | Auswahl |
+ | --- | --- |
+ | **ISTA-DASLab · empfohlen** | Q2\_0, IQ2\_XS, IQ3\_XXS, IQ3\_S. [Coder: IQ1\_M](docs/MODELS.md#coder) zum Programmieren. |
+ | **Unsloth** | UD-IQ4\_XS, UD-Q4\_K\_XL, UD-Q5\_K\_XL, UD-Q6\_K\_XL, Q8\_0 |
+ | **Gyro · agentionai** | [Gyro-S, Gyro-M](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF). Geringerer Speicherbedarf, aber langsamer. |
+ | **Weitere Optionen** | [Swift 1.5](docs/MODELS.md#swift-15), [NVFP4](docs/NVFP4.md), [OrcaRouter](docs/ORCA.md) |
- Starte es mit `strata launch --model gyro-s`. Details: [docs/GYRO.md](docs/GYRO.md).
+ [Größen, Speicherbedarf und Kompatibilität vergleichen](docs/MODELS.md).
- ### Die Größen von Qwen3.8-Flash-Next
+ </details>
- | Dein Speicher (RAM + VRAM) | Nimm | Warum |
- | --- | --- | --- |
- | **32 GB** | **Gyro-S**, oder den **[Coder](docs/MODELS.md#coder)** für Code | Der Coder behält die Experten, die Code braucht |
- | **40 GB** | **[Swift 1.5](docs/MODELS.md#swift-15)** IQ2_XS (39,2 GB) oder **Gyro-M** | Swift denkt kürzer nach, bevor es antwortet |
- | **48 GB** | **IQ3_XXS** (47,0 GB) | Langsamer, besser |
- | **64 GB** | **IQ3_S** (54,8 GB) | Erreicht in den veröffentlichten Tests das volle Modell |
- | **96 GB oder mehr** | **UD-IQ4_XS** bis **Q8_0** von Unsloth | Am nächsten am vollen Modell |
+ <details>
+ <summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.6-35B-A3B</b></summary>
- Auch mit weniger RAM, als eine Zeile nennt, kann es funktionieren, nur langsamer: Strata wechselt von selbst in seinen
- [Modus für wenig RAM](docs/MODELS.md#a-big-graphics-card-and-little-ram). Außerdem gibt es:
- [NVFP4](docs/NVFP4.md) für NVIDIA-Karten, [Qwen3.6-35B-A3B](docs/QWEN36.md) (kleiner, mehrere Anfragen gleichzeitig) und
- [OrcaRouters Uncensored IQ3_XXS](docs/MODELS.md#orcarouter-uncensored-iq3_xxs). Alle Größen und was wo läuft:
- [docs/MODELS.md](docs/MODELS.md).
+ **Unsloth:** UD-Q4_K_XL, UD-Q6_K_XL, Q8_0. Das sind die derzeit dokumentierten Pakete für dieses Modell.
- ### DeepSeek V4.1-Flash (Terminal, ab 0.2.4)
+ [Modellanleitung und Kompatibilität](docs/QWEN36.md).
- Ein deutlich größeres Modell, das auf einer Grafikkarte mit 12 GB und 46 bis 64 GB RAM läuft. Strata hält die meistgenutzten
- Teile im Speicher und liest den Rest von deiner SSD. [ISTA-DASLab](https://huggingface.co/ISTA-DASLab/DeepSeek-V4.1-Flash-1017-GSQ-RCO-GGUF)
- hat die Sets gebaut. Es läuft auf NVIDIA-RTX-Karten der Serien 30, 40 und 50 und auf der Radeon AI PRO R9700. Wähle es in
- `strata launch`. Die Desktop-App bietet es noch nicht an.
+ </details>
- | Set | Download | Qualität | Schreibt Code mit |
- | --- | ---: | --- | --- |
- | **IQ1_M** (1,75 Bit) | 239 GB | Das kleinste, schwächer bei einfacher Prosa | auf einem PC noch nicht gemessen |
- | **IQ2_XXS** (2.00 Bit) | 257 GB | Gute Balance | 10 Tokens/s (RTX 3060), 5 (RTX 5070), 48 (4x R9700) |
- | **IQ2_XS** (2.25 Bit) | 274 GB | Am nächsten am Original | 15 Tokens/s (eine R9700), 80 (4x R9700) |
- | **IQ4_NL** (Engram-Tabelle) | in jedem Download oben enthalten | Die Nachschlagetabelle, die alle drei Sets teilen | |
+ <a id="the-other-sizes"></a>
- Starte es mit `strata launch --model ist-das-2.00bpw` (oder `ist-das-1.75bpw`, `ist-das-2.25bpw`). Qualitätswerte,
- Geschwindigkeiten je PC und die manuelle Installation: [docs/DEEPSEEK41.md](docs/DEEPSEEK41.md).
+ Unsicher, was passt? [Wähle ein Modell für deinen Computer](docs/MODELS.md#pick-by-memory).
- ## Wie schnell ist es?
+ ## Installation
- Gemessen mit einer Grafikkarte mit 12 GB (RTX 5070, 64 GB RAM). Ergebnisse anderer Karten:
- [Tempo jeder Größe](docs/MODELS.md#how-fast-is-each-size) und [Ergebnisse der Community](docs/COMMUNITY_BENCHMARKS.md).
+ <a id="option-a-the-strata-app"></a>
- | Modell | Antworten erscheinen mit | Liest deinen Prompt mit |
- | --- | --- | --- |
- | **Q2_0** | `████████████` 94 Tokens/s | `████████████` 2.650 Tokens/s |
- | **IQ2_XS** | `██████████░░` 79 Tokens/s | `█████████░░░` 2.090 Tokens/s |
- | **IQ3_XXS** | `████████░░░░` 62 Tokens/s | `████████░░░░` 1.750 Tokens/s |
- | **IQ3_S** | `███████░░░░░` 53 Tokens/s | `███████░░░░░` 1.620 Tokens/s |
- | **Coder** | `███████░░░░░` 55 Tokens/s | `██████████░░` 2.180 Tokens/s |
+ ### Desktop-App
- Auf einer AMD-Karte mit 16 GB (RX 9070 XT, 47 GB RAM):
+ **[Strata für Windows, Linux oder Mac herunterladen →](https://github.com/Niko1221/Strata/releases/latest)**
- | Modell | Antworten erscheinen mit | Liest deinen Prompt mit |
- | --- | --- | --- |
- | **Q2_0** | `████████░░░░` 60 Tokens/s | `█████░░░░░░░` 1.160 Tokens/s |
- | **IQ2_XS** | `███████░░░░░` 52 Tokens/s | `█████░░░░░░░` 1.110 Tokens/s |
- | **Coder** | `██████░░░░░░` 44 Tokens/s | `██████░░░░░░` 1.420 Tokens/s |
+ Installiere die App, wähle ein Modell und leg mit dem Chat los. Es gibt einen Installer pro System. Beim ersten Start lädt die App die Engine für deine Grafikkarte herunter. [Hilfe zum Installer](docs/INSTALL.md#the-app).
- Ein Token ist etwa ¾ eines Wortes, 60 Tokens pro Sekunde sind also schneller, als du lesen kannst. "Liest deinen Prompt"
- beschreibt, wie schnell Strata ein langes Dokument, Code oder einen Chatverlauf aufnimmt.
-<sub>Dateien: `Strata-0.2.5-windows-x64-setup.exe` · `Strata-0.2.5-linux-x86_64.AppImage` · `Strata-0.2.5-macos-arm64.dmg`</sub>
++<sub>Dateien: `Strata-0.2.6-windows-x64-setup.exe` · `Strata-0.2.6-linux-x86_64.AppImage` · `Strata-0.2.6-macos-arm64.dmg`</sub>
- ## Benutzung
+ <p align="center">
+ <img src="docs/media/app-chat.png" width="900" alt="Strata-Desktop-App mit Chat und Live-Codevorschau nebeneinander">
+ <br><sub>Chat, Dateien und Live-Vorschau in einem Fenster.</sub>
+ </p>
- ### In der App
+ <a id="option-b-the-terminal-one-line"></a>
- Ein Chat, ein **Monitor** für das Modell sowie für GPU, CPU und RAM, eine Seite **Modelle** und die **Einstellungen**. Der
- Chat kann in einem Ordner auf deinem PC arbeiten. Im Modus **Manuell** fragt er nach, bevor er eine Datei ändert oder einen
- Befehl ausführt. Er kann das Web durchsuchen (DuckDuckGo oder Bing, ohne Konto). Die Suchbegriffe sind das Einzige, was
- deinen PC verlässt.
+ ### Terminal-App
- <p align="center"><img src="docs/media/app-chat.png" width="900" alt="Die Strata-App: ein Chat, in dem der Agent einen kleinen Voxel-Pagodengarten gebaut hat, die Seite ist rechts in der Vorschau geöffnet"><br>
- <sub>Der Agent hat einen Voxel-Pagodengarten als eine HTML-Datei geschrieben, und die Seite öffnet sich in der Vorschau neben dem Chat</sub></p>
+ Lieber im Terminal? Installiere Strata und starte dann **`strata launch`**.
- ### Im Terminal
+ <details open>
+ <summary><b>Installationsbefehle</b></summary>
- <p align="center"><img src="docs/media/terminal-monitor.png" width="900" alt="Die Übersicht des Strata-Terminal-Monitors, während das Modell eine Antwort schreibt"><br>
- <sub><code>strata monitor</code>, während das Modell antwortet: Geschwindigkeit, GPU, Speicher und die letzten Anfragen</sub></p>
+ **Linux / Mac**
```sh
- strata launch # guided: model, context, pictures, access, then serve
- strata launch --model q2_0 --yes --no-tui # no questions: serve and print the address
- strata launch --status # what is being served now
- strata launch --stop # stop it
- strata monitor # watch speed, GPU, memory and requests
- strata update # get the newest engine
- strata doctor # check the installed files
+ curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh -o install.sh && sh install.sh
```
- Um Strata von deinem Handy oder einem anderen PC aus zu erreichen, nutze `strata launch --access lan`. Der Befehl erzeugt
- einen API-Schlüssel für dich. `strata --help` listet alles auf, und [docs/TERMINAL.md](docs/TERMINAL.md) erklärt es.
-
- ### Mit KI-Agents und anderen Apps
-
- Ein Agent installiert Strata mit dem Einzeiler oben und führt `strata launch --model NAME --yes --no-tui` aus. Die Schritte,
- Flags und Exit-Codes stehen in [docs/AI_SETUP.md](docs/AI_SETUP.md). Die Regeln für das Repository stehen in [AGENTS.md](AGENTS.md).
-
- | Deine App spricht | Basis-URL |
- | --- | --- |
- | OpenAI-API (die meisten Apps und Agents) | `http://127.0.0.1:8080/v1` (beliebiger API-Schlüssel, beliebiger Modellname) |
- | Anthropic-API (Claude Code) | `http://127.0.0.1:8080`, ohne `/v1`. Claude Code: `ANTHROPIC_BASE_URL=http://127.0.0.1:8080` |
- | OpenAI Responses API (Codex CLI) | `http://127.0.0.1:8080/v1/responses` ([Einrichtung](docs/DETAILS.md#the-responses-api-and-codex-cli)) |
-
- `strata connect` gibt die genauen Einstellungen für OpenCode, Codex CLI, Claude Code, oh-my-pi, pi, Hermes Agent und OpenClaw
- aus, und `strata connect opencode --write` schreibt sie für dich (mit einer Sicherung).
-
- ### Gut zu wissen
-
- - **Bilder** sind für jedes Modell eingeschaltet, das sie lesen kann. Hänge ein Bild im Chat an oder füge es ein, oder sende es aus deiner App. Details: [docs/IMAGES.md](docs/IMAGES.md).
- - **Das Denkniveau** kann aus, niedrig, mittel oder hoch sein, im Chat-Menü oder unter "reasoning effort" in deiner App. Aus ist am schnellsten.
- - **Die erste Nachricht** eines Chats wird komplett gelesen, etwa 1 Minute pro 30.000 Tokens. Folgenachrichten starten in Sekunden.
- - **Eine Anfrage nach der anderen** ist die Standardeinstellung. Für mehrere nutze `--parallel N` ([BATCHING.md](docs/BATCHING.md)). Auf einer Karte mit 12 GB wird dadurch jede Antwort langsamer.
+ **Windows PowerShell**
- ## Aus dem Quellcode bauen
-
- <details>
- <summary>Windows, Linux und Mac aus dem Repository</summary>
-
- [Lade Strata herunter](https://github.com/Niko1221/Strata/archive/refs/heads/main.zip) und entpacke es, oder nutze `git clone`.
- **Windows:** Doppelklick auf `START-HERE.bat`. **Linux:** Führe `./setup.sh` im Strata-Ordner aus.
-
- **Mac (Apple Silicon, macOS 15 oder neuer):** Installiere einmal die Command Line Tools von Apple mit `xcode-select --install`
- (Xcode selbst brauchst du nicht). Öffne das Terminal im Strata-Ordner und führe `./setup.sh` aus. Das Skript baut die
- Mac-Engine auf deinem Mac (etwa 7 Minuten), stellt dieselben Fragen, lädt das Modell herunter und startet es. Beim nächsten
- Mal startet `./setup.sh` sofort. Welche Größe zu deinem Mac passt: [docs/MAC.md](docs/MAC.md).
-
- Der Installer erkennt deine Karte und richtet die passende Engine ein. Er fragt, welches Modell und welche Größe du willst,
- wie viel Kontext (wie viel Text sich das Modell merkt) und ob es Bilder lesen soll. Drück Enter für die empfohlene Antwort.
- Dann lädt er das Modell herunter (etwa 70 GB) und startet es. Wenn der Download abbricht, führe das Skript erneut aus, dann
- geht es weiter. Dein Browser öffnet die Strata-Seite unter `http://127.0.0.1:8080`.
-
- > Während das Modell startet, kann dein PC 1-3 Minuten langsam sein oder nicht reagieren (beim ersten Mal am längsten). Strata
- > lädt 35-55 GB in deinen RAM und sperrt einen Teil davon für die Grafikkarte. Warte ab und schließe das Fenster nicht.
-
- Starte beim nächsten Mal wieder `START-HERE.bat` (oder `./setup.sh`). Es startet sofort und lädt nichts doppelt herunter.
- Schließ sein Fenster, um das Modell zu beenden. `UPDATE.bat` (`./update.sh`) aktualisiert Strata, ohne es zu starten.
- Aktualisieren, Docker, mehrere Karten, wohin die Dateien kommen und alle Optionen: [docs/INSTALL.md](docs/INSTALL.md).
-
- Um deinen PC zu messen, führe `BENCH.bat` (`./bench.sh`) aus. Das dauert 5-10 Minuten und schreibt einen Bericht, den du teilen
- kannst ([so geht's](docs/COMMUNITY_BENCHMARKS.md#run-the-benchmark)).
-
- **Optional: mehr Tempo auf einer Karte, wenn das ganze Modell in den RAM passt.** Zwei Einstellungen zum Einschalten von
- RubenTorney (#1904, #1905). Sie helfen, wenn du eine Grafikkarte nutzt und dein RAM alle Experten aufnimmt, zum Beispiel bei
- Q2_0 oder IQ3_XXS auf einem PC mit 64 GB. Öffne `strata-<model>.json` im Strata-Datenordner ([wo](docs/INSTALL.md#where-things-are-stored)) und ergänze:
+ ```powershell
+ irm https://github.com/Niko1221/Strata/releases/latest/download/install.ps1 | iex
+ ```
- - `"--adapt-async", "1"` in der Liste `"args"`. Der Expertencache wird dann in einem Hilfsthread aktualisiert, statt die
- Antwort anzuhalten. Gemessen auf einer RTX 5070 (Windows, Q2_0): +4-5 % beim Decodieren, +7-10 % bei Code und langen
- Dokumenten. Die Antworten können sich leicht von der Standardeinstellung unterscheiden und bleiben von Lauf zu Lauf gleich.
- - `"STRATA_PIN_BY_NEED": "1"` im Block `"env"` (Windows). Windows kann nur etwa die Hälfte des RAM für die Grafikkarte sperren,
- und diese Einstellung sperrt zuerst die Experten, die die Karte am dringendsten braucht. Gemessen auf der RTX 5070: +4,4 % beim Lesen des Prompts.
+ Öffne unter Windows danach ein neues Terminal. Dann:
- ```json
- "args": [ ..., "--adapt-async", "1" ],
- "env": { "STRATA_PIN_BY_NEED": "1" }
+ ```sh
+ strata launch
```
- Starte Strata nach der Änderung neu. Zum Rückgängigmachen entfernst du die beiden Einträge.
+ Folge den Anweisungen, um ein Modell herunterzuladen und zu starten. [Terminal-Anleitung](docs/TERMINAL_LAUNCH.md).
</details>
diff --cc README.es.md
index c3b941979,202480b25..adb89e241
--- a/README.es.md
+++ b/README.es.md
@@@ -5,298 -5,131 +5,131 @@@
</picture>
</p>
- <p align="center"><a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <b>Español</b> · <a href="README.pt-BR.md">Português</a></p>
-
- <h3 align="center">Ejecuta un modelo de última generación en tu propio PC gaming</h3>
-
- <p align="center">Compatible con NVIDIA, AMD, Intel · Windows, Linux, Mac · libre y de código abierto</p>
+ <h3 align="center">IA potente en tu propio ordenador.</h3>
+ <p align="center">Chatea, programa y trabaja con imágenes, en local.</p>
<p align="center">
- <a href="https://github.com/Niko1221/Strata/releases/latest"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?include_prereleases&label=release" alt="Última versión"></a>
- <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="Licencia MIT"></a>
- <a href="https://github.com/Niko1221/Strata/stargazers"><img src="https://img.shields.io/github/stars/Niko1221/Strata?style=flat" alt="Estrellas en GitHub"></a>
- <a href="https://buymeacoffee.com/strataengine"><img src="https://img.shields.io/badge/Buy%20me%20a%20coffee-FFDD00?logo=buymeacoffee&logoColor=black" alt="Invítame a un café"></a>
+ <a href="#modelos">Modelos</a> · <a href="#instalación"><b>Instalación</b></a> ·
+ <a href="#hardware">Hardware</a> · <a href="#herramientas">Herramientas</a> ·
+ <a href="#ayuda">Ayuda</a> · <a href="#apoya-strata">Apoyar</a>
</p>
- <p align="center"><a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4"><img src="docs/media/pagoda-preview.webp" width="720" alt="Un jardín con una pagoda de vóxeles que escribió el modelo de Strata, funcionando en el navegador"></a><br>
- <sub>Un jardín con una pagoda de vóxeles, hecho con un solo prompt en una RTX 5070 con Strata (IQ3_S, contexto de 128K) ·
- <a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4">vídeo completo (49 s)</a></sub></p>
-
<p align="center">
- <a href="#instalación"><b>Instalación</b></a> ·
- <a href="#modelos">Modelos</a> ·
- <a href="#qué-velocidad-tiene">Velocidad</a> ·
- <a href="#uso">Uso</a> ·
- <a href="#cómo-funciona">Cómo funciona</a> ·
- <a href="#algo-ha-ido-mal">Ayuda</a> ·
- <a href="#apoya-strata">Apoyar</a>
+ <a href="https://github.com/Niko1221/Strata/releases/latest"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?label=download&color=0ab887" alt="Descargar Strata"></a>
+ <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="Licencia MIT"></a>
+ <a href="https://buymeacoffee.com/strataengine"><img src="https://img.shields.io/badge/Buy_me_a_coffee-FFDD00?logo=buymeacoffee&logoColor=000" alt="Apoya Strata en Buy Me a Coffee"></a>
</p>
- Strata ejecuta **[Qwen3.8-Flash-Next](https://huggingface.co/Qwen/Qwen3.8-Flash-Next)**, un modelo de 125 mil millones
- de parámetros que normalmente necesita un servidor, en un PC normal. Desde 0.2.4 también ejecuta **DeepSeek V4.1-Flash**
- en la Terminal. Conversa, escribe código, lee imágenes y funciona con tus aplicaciones y tus agentes de programación. Tus
- chats y tus archivos se quedan en tu PC.
-
- - **Funciona en un PC gaming.** Con 32 GB entre RAM y memoria gráfica ya puedes empezar.
- - **Funciona con tus herramientas.** Claude Code, Codex CLI, OpenCode y otros agentes se conectan por las API de OpenAI y de Anthropic.
- - **Lee imágenes**, activado por defecto.
- - **Gratis y privado.** Licencia MIT, sin cuenta, sin nube, sin telemetría ([qué descarga y cuándo](docs/SAFETY.md)).
-
- ## Lo que necesitas
-
- **Necesitas al menos 32 GB de memoria: RAM y memoria gráfica (VRAM) juntas.** En un Mac o un Ryzen AI Max, es la memoria
- unificada. Un PC de 32 GB con una tarjeta de 12 a 16 GB ejecuta los tamaños más pequeños, y con 64 GB funcionan todos los
- tamaños.
-
- | Funciona en | Guía |
- | --- | --- |
- | **NVIDIA** GeForce RTX serie 20, 30, 40 y 50, 12 GB o más | [Instalación](#instalación) |
- | **AMD** Radeon RX 6800 y posteriores, Radeon AI PRO R9700 | [Tarjetas AMD](docs/AMD_HIP.md) |
- | **Intel** Arc | [Intel Arc](docs/INTEL_ARC.md) |
- | **Mac con Apple Silicon**, M1 o posterior, macOS 15 o posterior | [Mac](docs/MAC.md) |
- | **AMD Ryzen AI Max (Strix Halo)** y otros PC con memoria unificada | [Strix Halo](docs/STRIX_HALO.md) |
- | Tarjetas y procesadores antiguos | [GPU antiguas](docs/OLDER_GPUS.md) |
-
- También necesitas unos 80 GB de disco libre (un SSD), Windows 10 / 11, Linux o macOS, y un controlador gráfico actual. Dos
- o tres tarjetas de la misma marca pueden compartir un modelo ([multi-GPU](docs/MULTI_GPU.md)).
-
- ## Instalación
-
- ### 1. La aplicación Strata (la más fácil)
-
- Descarga el archivo para tu ordenador, ábrelo y pulsa Instalar en el modelo que recomienda.
-
- **Windows 10 / 11**
-
- [![Windows](https://img.shields.io/badge/Windows-10%20%2F%2011-0078D4?style=for-the-badge&logo=windows&logoColor=white)](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.5-windows-x64-setup.exe)
-
- **Linux**
-
- [![Linux](https://img.shields.io/badge/Linux-AppImage-FCC624?style=for-the-badge&logo=linux&logoColor=black)](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.5-linux-x86_64.AppImage)
-
- **Mac** (Apple Silicon, macOS 15 o posterior)
+ <p align="center"><sub><a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <b>Español</b> · <a href="README.pt-BR.md">Português</a></sub></p>
- [![Mac, Apple Silicon](https://img.shields.io/badge/Mac-Apple%20Silicon-333333?style=for-the-badge&logo=apple&logoColor=white)](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.5-macos-arm64.dmg)
+ **Gratis, de código abierto y tuyo para ejecutar.** Usa Strata en tu escritorio o con tus herramientas de programación favoritas. No necesitas cuenta.
- La aplicación elige sola el motor adecuado para tu tarjeta gráfica. Todos los archivos están en la
- [página de versiones](https://github.com/Niko1221/Strata/releases/latest).
-
- | Primer arranque | Qué hacer |
- | --- | --- |
- | **Windows** | Ejecuta el `.exe`. No necesita permisos de administrador. Si Windows muestra "Windows protegió tu PC", elige **Más información** y luego **Ejecutar de todas formas**. |
- | **Linux** | Haz el archivo ejecutable (`chmod +x`) y lánzalo. Necesita FUSE 2: `sudo apt install libfuse2t64` (Ubuntu 24.04 y posteriores) o `libfuse2` (22.04). |
- | **Mac** | Abre el `.dmg` y arrastra Strata a Aplicaciones. |
-
- La descarga del modelo es grande (40-70 GB). Si se detiene, continúa donde se quedó.
-
- ### 2. La Terminal (una línea)
-
- El comando `strata`, para scripts, servidores y agentes de IA. Es también la forma de ejecutar DeepSeek.
+ ## Modelos
- Linux y Mac:
+ Recomendamos **primero ISTA-DASLab**, después **Unsloth** y otros proveedores, siempre que haya un modelo compatible que quepa en tu memoria.
- ```sh
- curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh -o install.sh && sh install.sh
- ```
+ <details>
+ <summary><img src="docs/media/models/deepseek.svg" width="22" alt="" align="middle"> &nbsp;<b>DeepSeekV4.1-Flash-1017</b></summary>
- Windows (PowerShell):
+ En la **aplicación de escritorio** y en el **Terminal**. Lo que no cabe en la memoria se lee desde tu SSD, así que hace falta mucho espacio libre en disco.
- ```powershell
- irm https://github.com/Niko1221/Strata/releases/latest/download/install.ps1 | iex
- ```
+ | Conjunto (IST-DAS) | Descarga | Espacio libre necesario |
+ | --- | ---: | ---: |
+ | 1.75 bpw | 239 GB | unos 245 GB |
+ | 2.00 bpw | 257 GB | unos 265 GB |
+ | 2.25 bpw | 274 GB | unos 280 GB |
- Después arráncalo. Te hace una pregunta cada vez (modelo, contexto, imágenes, quién puede conectarse), descarga lo que
- necesita y empieza a servir:
+ Funciona en NVIDIA RTX 30, 40 y 50 (Windows y Linux) y en AMD Radeon AI PRO R9700 (Linux). La instalación descarga los archivos y el motor de DeepSeek, y después inicia el modelo.
```sh
- strata launch
- ```
-
- No necesita permisos de administrador. La instalación comprueba el SHA-256 de todo lo que descarga. En Windows, abre una
- ventana de terminal nueva después de la instalación. Todas las pantallas y opciones: [docs/TERMINAL_LAUNCH.md](docs/TERMINAL_LAUNCH.md).
-
- ### 3. Que lo instale tu IA
-
- Pega esto en Claude Code, Cursor, Codex, GitHub Copilot u otro asistente de programación:
-
- ```text
- Set up Strata on this PC for me: https://github.com/Niko1221/Strata - follow docs/AI_SETUP.md in that repository.
+ strata launch --family deepseek41 --model ist-das-2.00bpw --plan
```
- El asistente revisa tu tarjeta gráfica, tu RAM y tu disco, elige el modelo adecuado, lo instala y lo arranca, y te explica
- cómo conectar tus aplicaciones. Las herramientas de IA también pueden instalar, arrancar y detener Strata mediante su
- [servidor MCP](docs/MCP_SERVER.md).
+ Medido con el conjunto de 2.00 bpw en Strata 0.2.5. «Salida» es la velocidad de la respuesta; «Prompt» es la rapidez con la que Strata lee tu texto.
- ¿Prefieres compilarlo tú? Mira [Compilar desde el código fuente](#compilar-desde-el-código-fuente).
+ | Hardware | Salida | Prompt |
+ | --- | ---: | ---: |
+ | RTX 5070 12 GB, 64 GB de RAM | 4 a 6 tokens/s | unos 110 tokens/s (4K) |
+ | RTX 3060 12 GB, 46 GB de RAM | 9 a 11 tokens/s | unos 155 tokens/s (4K) |
+ | 1x Radeon AI PRO R9700, 251 GB de RAM | 21 a 25 tokens/s | 320 a 360 tokens/s (8K) |
+ | 4x Radeon AI PRO R9700 | 74 a 77 tokens/s | 400 a 450 tokens/s (8K) |
- ## Modelos
+ [Memoria, disco y detalles](docs/DEEPSEEK41.md) · [Notas de la versión](https://github.com/Niko1221/Strata/releases)
- La aplicación y `strata launch` recomiendan un tamaño según tu memoria. Los tamaños pequeños son más rápidos. Los grandes
- son algo más inteligentes.
-
- ### ¿Poca memoria? Prueba Gyro
+ </details>
- [Gyro](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF) de agentionai es la forma más pequeña de ejecutar
- Qwen3.8-Flash-Next. Funciona en NVIDIA, AMD, Intel Arc y Apple Silicon.
+ <details>
+ <summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.8-Flash-Next</b></summary>
- | Tamaño | Memoria que necesita (RAM + VRAM) | Descarga | Para qué sirve |
- | --- | ---: | ---: | --- |
- | **Gyro-S** | 27,6 GB | 58,5 GB | PC donde no cabe nada más. 9 tokens/s en un Mac mini de 32 GB. |
- | **Gyro-M** | 35 GB | 92,0 GB | Calidad parecida a IQ3_XXS con un 20 % menos de memoria de GPU. |
+ | Proveedor | Opciones |
+ | --- | --- |
+ | **ISTA-DASLab · recomendado** | Q2\_0, IQ2\_XS, IQ3\_XXS, IQ3\_S. [Coder: IQ1\_M](docs/MODELS.md#coder) para programar. |
+ | **Unsloth** | UD-IQ4\_XS, UD-Q4\_K\_XL, UD-Q5\_K\_XL, UD-Q6\_K\_XL, Q8\_0 |
+ | **Gyro · agentionai** | [Gyro-S, Gyro-M](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF). Usa menos memoria, pero es más lento. |
+ | **Otras opciones** | [Swift 1.5](docs/MODELS.md#swift-15), [NVFP4](docs/NVFP4.md), [OrcaRouter](docs/ORCA.md) |
- Arráncalo con `strata launch --model gyro-s`. Detalles: [docs/GYRO.md](docs/GYRO.md).
+ [Compara tamaños, necesidades de memoria y compatibilidad](docs/MODELS.md).
- ### Los tamaños de Qwen3.8-Flash-Next
+ </details>
- | Tu memoria (RAM + VRAM) | Elige | Por qué |
- | --- | --- | --- |
- | **32 GB** | **Gyro-S**, o el **[Coder](docs/MODELS.md#coder)** para código | El Coder conserva los expertos que usa el código |
- | **40 GB** | **[Swift 1.5](docs/MODELS.md#swift-15)** IQ2_XS (39,2 GB) o **Gyro-M** | Swift piensa menos tiempo antes de responder |
- | **48 GB** | **IQ3_XXS** (47,0 GB) | Más lento, mejor |
- | **64 GB** | **IQ3_S** (54,8 GB) | Iguala al modelo completo en las pruebas publicadas |
- | **96 GB o más** | **UD-IQ4_XS** hasta **Q8_0** de Unsloth | Lo más cerca del modelo completo |
+ <details>
+ <summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.6-35B-A3B</b></summary>
- Con menos RAM de la que indica una fila también puede funcionar, solo que más lento: Strata pasa solo a su
- [modo de poca RAM](docs/MODELS.md#a-big-graphics-card-and-little-ram). También hay:
- [NVFP4](docs/NVFP4.md) para tarjetas NVIDIA, [Qwen3.6-35B-A3B](docs/QWEN36.md) (más pequeño, varias peticiones a la vez) y
- [el Uncensored IQ3_XXS de OrcaRouter](docs/MODELS.md#orcarouter-uncensored-iq3_xxs). Todos los tamaños y lo que cabe en cada equipo:
- [docs/MODELS.md](docs/MODELS.md).
+ **Unsloth:** UD-Q4_K_XL, UD-Q6_K_XL, Q8_0. Son los paquetes documentados actualmente para este modelo.
- ### DeepSeek V4.1-Flash (Terminal, desde 0.2.4)
+ [Guía del modelo y compatibilidad](docs/QWEN36.md).
- Un modelo mucho más grande que funciona con una sola tarjeta gráfica de 12 GB y de 46 a 64 GB de RAM. Strata mantiene en
- memoria las partes más usadas y lee el resto de tu SSD. [ISTA-DASLab](https://huggingface.co/ISTA-DASLab/DeepSeek-V4.1-Flash-1017-GSQ-RCO-GGUF)
- hizo los conjuntos. Funciona en tarjetas NVIDIA RTX de las series 30, 40 y 50 y en la Radeon AI PRO R9700. Elígelo en
- `strata launch`. La aplicación de escritorio todavía no lo ofrece.
+ </details>
- | Conjunto | Descarga | Calidad | Escribe código a |
- | --- | ---: | --- | --- |
- | **IQ1_M** (1,75 bits) | 239 GB | El más pequeño, más débil con prosa sencilla | aún sin medir en un PC |
- | **IQ2_XXS** (2.00 bits) | 257 GB | Buen equilibrio | 10 tokens/s (RTX 3060), 5 (RTX 5070), 48 (4x R9700) |
- | **IQ2_XS** (2.25 bits) | 274 GB | Lo más cerca del original | 15 tokens/s (una R9700), 80 (4x R9700) |
- | **IQ4_NL** (tabla Engram) | incluida en cada descarga de arriba | La tabla de consulta que comparten los tres conjuntos | |
+ <a id="the-other-sizes"></a>
- Arráncalo con `strata launch --model ist-das-2.00bpw` (o `ist-das-1.75bpw`, `ist-das-2.25bpw`). Cifras de calidad,
- velocidades por PC e instalación manual: [docs/DEEPSEEK41.md](docs/DEEPSEEK41.md).
+ ¿No sabes qué cabe? [Elige un modelo para tu ordenador](docs/MODELS.md#pick-by-memory).
- ## ¿Qué velocidad tiene?
+ ## Instalación
- Medido con una tarjeta gráfica de 12 GB (RTX 5070, 64 GB de RAM). Resultados con otras tarjetas:
- [velocidad de cada tamaño](docs/MODELS.md#how-fast-is-each-size) y [resultados de la comunidad](docs/COMMUNITY_BENCHMARKS.md).
+ <a id="option-a-the-strata-app"></a>
- | Modelo | Las respuestas aparecen a | Lee tu prompt a |
- | --- | --- | --- |
- | **Q2_0** | `████████████` 94 tokens/s | `████████████` 2.650 tokens/s |
- | **IQ2_XS** | `██████████░░` 79 tokens/s | `█████████░░░` 2.090 tokens/s |
- | **IQ3_XXS** | `████████░░░░` 62 tokens/s | `████████░░░░` 1.750 tokens/s |
- | **IQ3_S** | `███████░░░░░` 53 tokens/s | `███████░░░░░` 1.620 tokens/s |
- | **Coder** | `███████░░░░░` 55 tokens/s | `██████████░░` 2.180 tokens/s |
+ ### Aplicación de escritorio
- Con una tarjeta AMD de 16 GB (RX 9070 XT, 47 GB de RAM):
+ **[Descargar Strata para Windows, Linux o Mac →](https://github.com/Niko1221/Strata/releases/latest)**
- | Modelo | Las respuestas aparecen a | Lee tu prompt a |
- | --- | --- | --- |
- | **Q2_0** | `████████░░░░` 60 tokens/s | `█████░░░░░░░` 1.160 tokens/s |
- | **IQ2_XS** | `███████░░░░░` 52 tokens/s | `█████░░░░░░░` 1.110 tokens/s |
- | **Coder** | `██████░░░░░░` 44 tokens/s | `██████░░░░░░` 1.420 tokens/s |
+ Instala la aplicación, elige un modelo y empieza a chatear. Hay un instalador por sistema. En el primer arranque, la aplicación descarga el motor para tu tarjeta gráfica. [Ayuda con el instalador](docs/INSTALL.md#the-app).
- Un token equivale a unos ¾ de palabra, así que 60 tokens por segundo es más rápido de lo que puedes leer. "Lee tu prompt"
- es lo rápido que Strata procesa un documento largo, código o un historial de chat.
-<sub>Archivos: `Strata-0.2.5-windows-x64-setup.exe` · `Strata-0.2.5-linux-x86_64.AppImage` · `Strata-0.2.5-macos-arm64.dmg`</sub>
++<sub>Archivos: `Strata-0.2.6-windows-x64-setup.exe` · `Strata-0.2.6-linux-x86_64.AppImage` · `Strata-0.2.6-macos-arm64.dmg`</sub>
- ## Uso
+ <p align="center">
+ <img src="docs/media/app-chat.png" width="900" alt="Aplicación de escritorio de Strata con un chat y una vista previa del código en vivo, una junto a otra">
+ <br><sub>Chat, archivos y vista previa en vivo en una sola ventana.</sub>
+ </p>
- ### En la aplicación
+ <a id="option-b-the-terminal-one-line"></a>
- Un chat, un **Monitor** del modelo y de tu GPU, CPU y RAM, una página de **Modelos** y los **Ajustes**. El chat puede
- trabajar en una carpeta de tu PC. En modo **Manual** pregunta antes de cambiar un archivo o ejecutar un comando. Puede buscar
- en la web (DuckDuckGo o Bing, sin cuenta). Las palabras que buscas son lo único que sale de tu PC.
+ ### Aplicación de Terminal
- <p align="center"><img src="docs/media/app-chat.png" width="900" alt="La aplicación Strata: un chat donde el agente construyó un pequeño jardín con una pagoda de vóxeles, con la página abierta en la vista previa a la derecha"><br>
- <sub>El agente escribió un jardín con una pagoda de vóxeles en un solo archivo HTML, y la página se abre en la vista previa junto al chat</sub></p>
+ ¿Prefieres la terminal? Instala Strata y ejecuta **`strata launch`**.
- ### En la Terminal
+ <details open>
+ <summary><b>Comandos de instalación</b></summary>
- <p align="center"><img src="docs/media/terminal-monitor.png" width="900" alt="La vista general del monitor de la Terminal de Strata mientras el modelo escribe una respuesta"><br>
- <sub><code>strata monitor</code> mientras el modelo responde: velocidad, GPU, memoria y las últimas solicitudes</sub></p>
+ **Linux / Mac**
```sh
- strata launch # guided: model, context, pictures, access, then serve
- strata launch --model q2_0 --yes --no-tui # no questions: serve and print the address
- strata launch --status # what is being served now
- strata launch --stop # stop it
- strata monitor # watch speed, GPU, memory and requests
- strata update # get the newest engine
- strata doctor # check the installed files
+ curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh -o install.sh && sh install.sh
```
- Para llegar a Strata desde tu móvil u otro PC, usa `strata launch --access lan`. Crea una clave de API para ti.
- `strata --help` lo lista todo, y [docs/TERMINAL.md](docs/TERMINAL.md) lo explica.
-
- ### Con agentes de IA y otras aplicaciones
-
- Un agente instala Strata con el comando de una línea de arriba y ejecuta `strata launch --model NAME --yes --no-tui`. Los
- pasos, las opciones y los códigos de salida están en [docs/AI_SETUP.md](docs/AI_SETUP.md). Las reglas del repositorio para agentes: [AGENTS.md](AGENTS.md).
-
- | Tu aplicación habla | URL base |
- | --- | --- |
- | API de OpenAI (la mayoría de aplicaciones y agentes) | `http://127.0.0.1:8080/v1` (cualquier clave de API, cualquier nombre de modelo) |
- | API de Anthropic (Claude Code) | `http://127.0.0.1:8080`, sin `/v1`. Claude Code: `ANTHROPIC_BASE_URL=http://127.0.0.1:8080` |
- | API OpenAI Responses (Codex CLI) | `http://127.0.0.1:8080/v1/responses` ([configuración](docs/DETAILS.md#the-responses-api-and-codex-cli)) |
-
- `strata connect` muestra los ajustes exactos para OpenCode, Codex CLI, Claude Code, oh-my-pi, pi, Hermes Agent y OpenClaw,
- y `strata connect opencode --write` los escribe por ti (con una copia de seguridad).
-
- ### Conviene saber
-
- - **Las imágenes** vienen activadas en todos los modelos que pueden leerlas. Adjunta o pega una imagen en el chat, o envíala desde tu aplicación. Detalles: [docs/IMAGES.md](docs/IMAGES.md).
- - **El razonamiento** puede estar desactivado, bajo, medio o alto, en el menú del chat o en "reasoning effort" de tu aplicación. Desactivado es lo más rápido.
- - **El primer mensaje** de un chat se lee entero, unos 1 minuto por cada 30.000 tokens. Los mensajes siguientes empiezan en segundos.
- - **Una petición a la vez** es lo normal. Para varias, usa `--parallel N` ([BATCHING.md](docs/BATCHING.md)). En una tarjeta de 12 GB, esto hace más lenta cada respuesta.
+ **Windows PowerShell**
- ## Compilar desde el código fuente
-
- <details>
- <summary>Windows, Linux y Mac desde el repositorio</summary>
-
- [Descarga Strata](https://github.com/Niko1221/Strata/archive/refs/heads/main.zip) y descomprímelo, o haz `git clone`.
- **Windows:** haz doble clic en `START-HERE.bat`. **Linux:** ejecuta `./setup.sh` en la carpeta de Strata.
-
- **Mac (Apple Silicon, macOS 15 o posterior):** instala una vez las Command Line Tools de Apple con `xcode-select --install`
- (no hace falta Xcode). Abre la Terminal en la carpeta de Strata y ejecuta `./setup.sh`. El script compila el motor para Mac
- en tu Mac (unos 7 minutos), hace las mismas preguntas, descarga el modelo y lo arranca. La próxima vez, `./setup.sh` lo
- arranca enseguida. Qué tamaño cabe en tu Mac: [docs/MAC.md](docs/MAC.md).
-
- El instalador detecta tu tarjeta y prepara el motor adecuado. Pregunta qué modelo y qué tamaño quieres, cuánto contexto
- (cuánto texto mantiene el modelo en mente) y si debe leer imágenes. Pulsa Enter para aceptar la respuesta recomendada.
- Luego descarga el modelo (unos 70 GB) y lo arranca. Si la descarga se detiene, vuelve a ejecutar el script y continúa. Tu
- navegador abre la página de Strata en `http://127.0.0.1:8080`.
-
- > Mientras el modelo arranca, tu PC puede ir lento o dejar de responder durante 1-3 minutos (más tiempo la primera vez).
- > Strata carga 35-55 GB en tu RAM y bloquea una parte para la tarjeta gráfica. Espera y no cierres la ventana.
-
- La próxima vez, ejecuta de nuevo `START-HERE.bat` (o `./setup.sh`). Arranca enseguida y no descarga nada dos veces. Cierra
- su ventana para detener el modelo. `UPDATE.bat` (`./update.sh`) actualiza Strata sin arrancarlo. Actualización, Docker,
- varias tarjetas, dónde van los archivos y todas las opciones: [docs/INSTALL.md](docs/INSTALL.md).
-
- Para medir tu PC, ejecuta `BENCH.bat` (`./bench.sh`). Tarda 5-10 minutos y escribe un informe que puedes compartir
- ([cómo](docs/COMMUNITY_BENCHMARKS.md#run-the-benchmark)).
-
- **Opcional: más velocidad en una tarjeta cuando todo el modelo cabe en la RAM.** Dos ajustes que se activan a mano, de
- RubenTorney (#1904, #1905). Ayudan cuando usas una sola tarjeta gráfica y tu RAM guarda todos los expertos, por ejemplo con
- Q2_0 o IQ3_XXS en un PC de 64 GB. Abre `strata-<model>.json` en la carpeta de datos de Strata ([dónde](docs/INSTALL.md#where-things-are-stored)) y añade:
+ ```powershell
+ irm https://github.com/Niko1221/Strata/releases/latest/download/install.ps1 | iex
+ ```
- - `"--adapt-async", "1"` a la lista `"args"`. Así la caché de expertos se actualiza en un hilo auxiliar en vez de detener la
- respuesta. Medido en una RTX 5070 (Windows, Q2_0): +4-5 % en decodificación, +7-10 % en código y documentos largos. Las
- respuestas pueden diferir un poco de las del ajuste por defecto y son iguales de una ejecución a otra.
- - `"STRATA_PIN_BY_NEED": "1"` en el bloque `"env"` (Windows). Windows solo puede bloquear aproximadamente la mitad de la RAM
- para la tarjeta gráfica, y este ajuste bloquea primero los expertos que la tarjeta necesita antes. Medido en la RTX 5070: +4,4 % en lectura del prompt.
+ En Windows, abre una terminal nueva después. Luego:
- ```json
- "args": [ ..., "--adapt-async", "1" ],
- "env": { "STRATA_PIN_BY_NEED": "1" }
+ ```sh
+ strata launch
```
- Reinicia Strata después del cambio. Para deshacerlo, quita las dos entradas.
+ Sigue las indicaciones para descargar e iniciar un modelo. [Guía del Terminal](docs/TERMINAL_LAUNCH.md).
</details>
diff --cc README.fr.md
index 1a81ef34a,e1f9e6a0a..0dc26ee91
--- a/README.fr.md
+++ b/README.fr.md
@@@ -5,300 -5,131 +5,131 @@@
</picture>
</p>
- <p align="center"><a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.de.md">Deutsch</a> · <b>Français</b> · <a href="README.es.md">Español</a> · <a href="README.pt-BR.md">Português</a></p>
-
- <h3 align="center">Faites tourner un modèle de pointe sur votre propre PC de jeu</h3>
-
- <p align="center">Compatible avec NVIDIA, AMD, Intel · Windows, Linux, Mac · gratuit et open source</p>
+ <h3 align="center">Une IA puissante sur votre propre ordinateur.</h3>
+ <p align="center">Discutez, programmez et travaillez avec des images, en local.</p>
<p align="center">
- <a href="https://github.com/Niko1221/Strata/releases/latest"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?include_prereleases&label=release" alt="Dernière version"></a>
- <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="Licence MIT"></a>
- <a href="https://github.com/Niko1221/Strata/stargazers"><img src="https://img.shields.io/github/stars/Niko1221/Strata?style=flat" alt="Étoiles GitHub"></a>
- <a href="https://buymeacoffee.com/strataengine"><img src="https://img.shields.io/badge/Buy%20me%20a%20coffee-FFDD00?logo=buymeacoffee&logoColor=black" alt="Offrez-moi un café"></a>
+ <a href="#modèles">Modèles</a> · <a href="#installation"><b>Installation</b></a> ·
+ <a href="#matériel">Matériel</a> · <a href="#outils">Outils</a> ·
+ <a href="#aide">Aide</a> · <a href="#soutenir-strata">Soutenir</a>
</p>
- <p align="center"><a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4"><img src="docs/media/pagoda-preview.webp" width="720" alt="Un jardin de pagode en voxels écrit par le modèle de Strata, qui tourne dans le navigateur"></a><br>
- <sub>Un jardin de pagode en voxels, généré en une seule requête sur une RTX 5070 avec Strata (IQ3_S, contexte de 128K) ·
- <a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4">vidéo complète (49 s)</a></sub></p>
-
<p align="center">
- <a href="#installation"><b>Installation</b></a> ·
- <a href="#modèles">Modèles</a> ·
- <a href="#quelle-est-sa-vitesse-">Vitesse</a> ·
- <a href="#utilisation">Utilisation</a> ·
- <a href="#comment-ça-marche-">Comment ça marche</a> ·
- <a href="#un-problème-">Aide</a> ·
- <a href="#soutenir-strata">Soutenir</a>
+ <a href="https://github.com/Niko1221/Strata/releases/latest"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?label=download&color=0ab887" alt="Télécharger Strata"></a>
+ <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="Licence MIT"></a>
+ <a href="https://buymeacoffee.com/strataengine"><img src="https://img.shields.io/badge/Buy_me_a_coffee-FFDD00?logo=buymeacoffee&logoColor=000" alt="Soutenir Strata sur Buy Me a Coffee"></a>
</p>
- Strata fait tourner **[Qwen3.8-Flash-Next](https://huggingface.co/Qwen/Qwen3.8-Flash-Next)**, un modèle de 125 milliards
- de paramètres qui demande normalement un serveur, sur un PC ordinaire. Depuis la 0.2.4, il fait aussi tourner **DeepSeek
- V4.1-Flash** dans le Terminal. Il discute, écrit du code, lit des images et fonctionne avec vos applications et vos agents
- de code. Vos conversations et vos fichiers restent sur votre PC.
-
- - **Tourne sur un PC de jeu.** 32 Go de RAM et de mémoire graphique réunis suffisent pour commencer.
- - **Fonctionne avec vos outils.** Claude Code, Codex CLI, OpenCode et d'autres agents se connectent par les API d'OpenAI et d'Anthropic.
- - **Lit les images**, activé par défaut.
- - **Gratuit et privé.** Licence MIT, pas de compte, pas de cloud, aucune télémétrie ([ce qu'il télécharge et quand](docs/SAFETY.md)).
-
- ## Ce qu'il vous faut
-
- **Il vous faut au moins 32 Go de mémoire : RAM et mémoire graphique (VRAM) réunis.** Sur un Mac ou un Ryzen AI Max, c'est
- la mémoire unifiée. Un PC de 32 Go avec une carte de 12 à 16 Go fait tourner les petites tailles, et 64 Go font tourner
- toutes les tailles.
-
- | Fonctionne sur | Guide |
- | --- | --- |
- | **NVIDIA** GeForce RTX série 20, 30, 40 et 50, 12 Go ou plus | [Installation](#installation) |
- | **AMD** Radeon RX 6800 et plus récent, Radeon AI PRO R9700 | [Cartes AMD](docs/AMD_HIP.md) |
- | **Intel** Arc | [Intel Arc](docs/INTEL_ARC.md) |
- | **Mac Apple Silicon**, M1 ou plus récent, macOS 15 ou plus récent | [Mac](docs/MAC.md) |
- | **AMD Ryzen AI Max (Strix Halo)** et autres PC à mémoire unifiée | [Strix Halo](docs/STRIX_HALO.md) |
- | Cartes et processeurs plus anciens | [GPU anciens](docs/OLDER_GPUS.md) |
-
- Il vous faut aussi environ 80 Go d'espace disque libre (un SSD), Windows 10 / 11, Linux ou macOS, et un pilote graphique
- récent. Deux ou trois cartes de la même marque peuvent se partager un modèle ([multi-GPU](docs/MULTI_GPU.md)).
-
- ## Installation
-
- ### 1. L'application Strata (le plus simple)
-
- Téléchargez le fichier pour votre ordinateur, ouvrez-le et appuyez sur Installer pour le modèle qu'elle recommande.
-
- **Windows 10 / 11**
-
- [![Windows](https://img.shields.io/badge/Windows-10%20%2F%2011-0078D4?style=for-the-badge&logo=windows&logoColor=white)](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.5-windows-x64-setup.exe)
-
- **Linux**
-
- [![Linux](https://img.shields.io/badge/Linux-AppImage-FCC624?style=for-the-badge&logo=linux&logoColor=black)](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.5-linux-x86_64.AppImage)
-
- **Mac** (Apple Silicon, macOS 15 ou plus récent)
+ <p align="center"><sub><a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.de.md">Deutsch</a> · <b>Français</b> · <a href="README.es.md">Español</a> · <a href="README.pt-BR.md">Português</a></sub></p>
- [![Mac, Apple Silicon](https://img.shields.io/badge/Mac-Apple%20Silicon-333333?style=for-the-badge&logo=apple&logoColor=white)](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.5-macos-arm64.dmg)
+ **Gratuit, open source, et à vous de l'exécuter.** Utilisez Strata sur votre bureau ou avec vos outils de programmation préférés. Aucun compte nécessaire.
- L'application choisit toute seule le bon moteur pour votre carte graphique. Tous les fichiers sont sur la
- [page des versions](https://github.com/Niko1221/Strata/releases/latest).
-
- | Premier démarrage | Ce qu'il faut faire |
- | --- | --- |
- | **Windows** | Lancez le `.exe`. Pas besoin de droits d'administrateur. Si Windows affiche « Windows a protégé votre ordinateur », choisissez **Informations complémentaires**, puis **Exécuter quand même**. |
- | **Linux** | Rendez le fichier exécutable (`chmod +x`) et lancez-le. Il a besoin de FUSE 2 : `sudo apt install libfuse2t64` (Ubuntu 24.04 et plus récent) ou `libfuse2` (22.04). |
- | **Mac** | Ouvrez le `.dmg` et faites glisser Strata dans Applications. |
-
- Le téléchargement du modèle est gros (40 à 70 Go). S'il s'arrête, il reprend là où il s'était arrêté.
-
- ### 2. Le Terminal (une ligne)
-
- La commande `strata`, pour les scripts, les serveurs et les agents d'IA. C'est aussi le moyen de faire tourner DeepSeek.
+ ## Modèles
- Linux et Mac :
+ Nous recommandons **d'abord ISTA-DASLab**, puis **Unsloth** et d'autres fournisseurs, lorsqu'un modèle compatible tient en mémoire.
- ```sh
- curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh -o install.sh && sh install.sh
- ```
+ <details>
+ <summary><img src="docs/media/models/deepseek.svg" width="22" alt="" align="middle"> &nbsp;<b>DeepSeekV4.1-Flash-1017</b></summary>
- Windows (PowerShell) :
+ Dans l'**application de bureau** et dans le **Terminal**. Ce qui ne tient pas en mémoire est lu depuis votre SSD : il faut donc beaucoup d'espace disque libre.
- ```powershell
- irm https://github.com/Niko1221/Strata/releases/latest/download/install.ps1 | iex
- ```
+ | Jeu (IST-DAS) | Téléchargement | Espace disque libre nécessaire |
+ | --- | ---: | ---: |
+ | 1.75 bpw | 239 GB | environ 245 GB |
+ | 2.00 bpw | 257 GB | environ 265 GB |
+ | 2.25 bpw | 274 GB | environ 280 GB |
- Puis lancez-le. Il pose une question à la fois (modèle, contexte, images, qui peut se connecter), télécharge ce dont il a
- besoin et commence à servir :
+ Fonctionne sur les NVIDIA RTX 30, 40 et 50 (Windows et Linux) et sur l'AMD Radeon AI PRO R9700 (Linux). L'installation télécharge les fichiers et le moteur DeepSeek, puis démarre le modèle.
```sh
- strata launch
- ```
-
- Pas besoin de droits d'administrateur. L'installation vérifie l'empreinte SHA-256 de tout ce qu'elle télécharge. Sous
- Windows, ouvrez une nouvelle fenêtre de terminal après l'installation. Tous les écrans et toutes les options : [docs/TERMINAL_LAUNCH.md](docs/TERMINAL_LAUNCH.md).
-
- ### 3. Laissez votre IA l'installer
-
- Collez ceci dans Claude Code, Cursor, Codex, GitHub Copilot ou un autre assistant de programmation :
-
- ```text
- Set up Strata on this PC for me: https://github.com/Niko1221/Strata - follow docs/AI_SETUP.md in that repository.
+ strata launch --family deepseek41 --model ist-das-2.00bpw --plan
```
- L'assistant vérifie votre carte graphique, votre RAM et votre disque, choisit le modèle adapté, l'installe, le démarre et
- vous explique comment connecter vos applications. Les outils d'IA peuvent aussi installer, démarrer et arrêter Strata via son
- [serveur MCP](docs/MCP_SERVER.md).
+ Mesuré avec le jeu 2.00 bpw sur Strata 0.2.5. « Sortie » est la vitesse de la réponse, « Prompt » la vitesse à laquelle Strata lit votre texte.
- Vous préférez le compiler vous-même ? Voir [Compiler depuis les sources](#compiler-depuis-les-sources).
+ | Matériel | Sortie | Prompt |
+ | --- | ---: | ---: |
+ | RTX 5070 12 GB, 64 GB de RAM | 4 à 6 tokens/s | environ 110 tokens/s (4K) |
+ | RTX 3060 12 GB, 46 GB de RAM | 9 à 11 tokens/s | environ 155 tokens/s (4K) |
+ | 1x Radeon AI PRO R9700, 251 GB de RAM | 21 à 25 tokens/s | 320 à 360 tokens/s (8K) |
+ | 4x Radeon AI PRO R9700 | 74 à 77 tokens/s | 400 à 450 tokens/s (8K) |
- ## Modèles
+ [Mémoire, disque et détails](docs/DEEPSEEK41.md) · [Notes de version](https://github.com/Niko1221/Strata/releases)
- L'application et `strata launch` recommandent une taille selon votre mémoire. Les petites tailles sont plus rapides. Les
- grandes sont un peu plus intelligentes.
-
- ### Peu de mémoire ? Essayez Gyro
+ </details>
- [Gyro](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF) d'agentionai est la façon la plus légère de faire tourner
- Qwen3.8-Flash-Next. Il fonctionne sur NVIDIA, AMD, Intel Arc et Apple Silicon.
+ <details>
+ <summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.8-Flash-Next</b></summary>
- | Taille | Mémoire nécessaire (RAM + VRAM) | Téléchargement | Pour quoi |
- | --- | ---: | ---: | --- |
- | **Gyro-S** | 27,6 Go | 58,5 Go | Les PC où rien d'autre ne tient. 9 tokens/s sur un Mac mini de 32 Go. |
- | **Gyro-M** | 35 Go | 92,0 Go | À peu près la qualité d'IQ3_XXS avec 20 % de mémoire GPU en moins. |
+ | Fournisseur | Choix |
+ | --- | --- |
+ | **ISTA-DASLab · recommandé** | Q2\_0, IQ2\_XS, IQ3\_XXS, IQ3\_S. [Coder : IQ1\_M](docs/MODELS.md#coder) pour programmer. |
+ | **Unsloth** | UD-IQ4\_XS, UD-Q4\_K\_XL, UD-Q5\_K\_XL, UD-Q6\_K\_XL, Q8\_0 |
+ | **Gyro · agentionai** | [Gyro-S, Gyro-M](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF). Utilise moins de mémoire, mais plus lent. |
+ | **Autres options** | [Swift 1.5](docs/MODELS.md#swift-15), [NVFP4](docs/NVFP4.md), [OrcaRouter](docs/ORCA.md) |
- Lancez-le avec `strata launch --model gyro-s`. Détails : [docs/GYRO.md](docs/GYRO.md).
+ [Comparer les tailles, la mémoire nécessaire et la compatibilité](docs/MODELS.md).
- ### Les tailles de Qwen3.8-Flash-Next
+ </details>
- | Votre mémoire (RAM + VRAM) | Prenez | Pourquoi |
- | --- | --- | --- |
- | **32 Go** | **Gyro-S**, ou le **[Coder](docs/MODELS.md#coder)** pour le code | Le Coder garde les experts dont le code a besoin |
- | **40 Go** | **[Swift 1.5](docs/MODELS.md#swift-15)** IQ2_XS (39,2 Go) ou **Gyro-M** | Swift réfléchit moins longtemps avant de répondre |
- | **48 Go** | **IQ3_XXS** (47,0 Go) | Plus lent, meilleur |
- | **64 Go** | **IQ3_S** (54,8 Go) | Égale le modèle complet dans les tests publiés |
- | **96 Go ou plus** | **UD-IQ4_XS** à **Q8_0** d'Unsloth | Au plus près du modèle complet |
+ <details>
+ <summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.6-35B-A3B</b></summary>
- Avoir moins de RAM que ce qu'indique une ligne peut encore fonctionner, en plus lent : Strata passe tout seul en
- [mode peu de RAM](docs/MODELS.md#a-big-graphics-card-and-little-ram). Il existe aussi :
- [NVFP4](docs/NVFP4.md) pour les cartes NVIDIA, [Qwen3.6-35B-A3B](docs/QWEN36.md) (plus petit, plusieurs requêtes à la fois) et
- [l'Uncensored IQ3_XXS d'OrcaRouter](docs/MODELS.md#orcarouter-uncensored-iq3_xxs). Toutes les tailles et ce qui tient où :
- [docs/MODELS.md](docs/MODELS.md).
+ **Unsloth:** UD-Q4_K_XL, UD-Q6_K_XL, Q8_0. Ce sont les paquets actuellement documentés pour ce modèle.
- ### DeepSeek V4.1-Flash (Terminal, depuis 0.2.4)
+ [Guide du modèle et compatibilité](docs/QWEN36.md).
- Un modèle bien plus gros, qui tourne sur une seule carte graphique de 12 Go avec 46 à 64 Go de RAM. Strata garde en mémoire
- les parties les plus utilisées et lit le reste sur votre SSD. [ISTA-DASLab](https://huggingface.co/ISTA-DASLab/DeepSeek-V4.1-Flash-1017-GSQ-RCO-GGUF)
- a produit les versions. Il fonctionne sur les cartes NVIDIA RTX des séries 30, 40 et 50 et sur la Radeon AI PRO R9700. Choisissez-le
- dans `strata launch`. L'application de bureau ne le propose pas encore.
+ </details>
- | Version | Téléchargement | Qualité | Écrit du code à |
- | --- | ---: | --- | --- |
- | **IQ1_M** (1,75 bit) | 239 Go | La plus petite, plus faible sur la prose simple | pas encore mesuré sur un PC |
- | **IQ2_XXS** (2.00 bits) | 257 Go | Bon équilibre | 10 tokens/s (RTX 3060), 5 (RTX 5070), 48 (4x R9700) |
- | **IQ2_XS** (2.25 bits) | 274 Go | Au plus près de l'original | 15 tokens/s (une R9700), 80 (4x R9700) |
- | **IQ4_NL** (table Engram) | compris dans chaque téléchargement ci-dessus | La table de consultation que les trois versions partagent | |
+ <a id="the-other-sizes"></a>
- Lancez-le avec `strata launch --model ist-das-2.00bpw` (ou `ist-das-1.75bpw`, `ist-das-2.25bpw`). Chiffres de qualité,
- vitesses par PC et installation manuelle : [docs/DEEPSEEK41.md](docs/DEEPSEEK41.md).
+ Vous ne savez pas ce qui tient ? [Choisir un modèle pour votre ordinateur](docs/MODELS.md#pick-by-memory).
- ## Quelle est sa vitesse ?
+ ## Installation
- Mesuré avec une carte graphique de 12 Go (RTX 5070, 64 Go de RAM). Voir les résultats d'autres cartes :
- [vitesse de chaque taille](docs/MODELS.md#how-fast-is-each-size) et [résultats de la communauté](docs/COMMUNITY_BENCHMARKS.md).
+ <a id="option-a-the-strata-app"></a>
- | Modèle | Les réponses s'affichent à | Lit votre prompt à |
- | --- | --- | --- |
- | **Q2_0** | `████████████` 94 tokens/s | `████████████` 2 650 tokens/s |
- | **IQ2_XS** | `██████████░░` 79 tokens/s | `█████████░░░` 2 090 tokens/s |
- | **IQ3_XXS** | `████████░░░░` 62 tokens/s | `████████░░░░` 1 750 tokens/s |
- | **IQ3_S** | `███████░░░░░` 53 tokens/s | `███████░░░░░` 1 620 tokens/s |
- | **Coder** | `███████░░░░░` 55 tokens/s | `██████████░░` 2 180 tokens/s |
+ ### Application de bureau
- Avec une carte AMD de 16 Go (RX 9070 XT, 47 Go de RAM) :
+ **[Télécharger Strata pour Windows, Linux ou Mac →](https://github.com/Niko1221/Strata/releases/latest)**
- | Modèle | Les réponses s'affichent à | Lit votre prompt à |
- | --- | --- | --- |
- | **Q2_0** | `████████░░░░` 60 tokens/s | `█████░░░░░░░` 1 160 tokens/s |
- | **IQ2_XS** | `███████░░░░░` 52 tokens/s | `█████░░░░░░░` 1 110 tokens/s |
- | **Coder** | `██████░░░░░░` 44 tokens/s | `██████░░░░░░` 1 420 tokens/s |
+ Installez l'application, choisissez un modèle et commencez à discuter. Il y a un seul installateur par système. Au premier lancement, l'application télécharge le moteur de votre carte graphique. [Aide pour l'installateur](docs/INSTALL.md#the-app).
- Un token vaut environ ¾ de mot, donc 60 tokens par seconde, c'est plus rapide que votre lecture. « Lit votre prompt »
- indique la vitesse à laquelle Strata absorbe un long document, du code ou un historique de discussion.
-<sub>Fichiers: `Strata-0.2.5-windows-x64-setup.exe` · `Strata-0.2.5-linux-x86_64.AppImage` · `Strata-0.2.5-macos-arm64.dmg`</sub>
++<sub>Fichiers: `Strata-0.2.6-windows-x64-setup.exe` · `Strata-0.2.6-linux-x86_64.AppImage` · `Strata-0.2.6-macos-arm64.dmg`</sub>
- ## Utilisation
+ <p align="center">
+ <img src="docs/media/app-chat.png" width="900" alt="Application de bureau Strata avec une discussion et un aperçu du code en direct côte à côte">
+ <br><sub>Discussion, fichiers et aperçu en direct dans une seule fenêtre.</sub>
+ </p>
- ### Dans l'application
+ <a id="option-b-the-terminal-one-line"></a>
- Un chat, un **Monitor** du modèle et de votre GPU, CPU et RAM, une page **Models** et les **Settings**. Le chat peut
- travailler dans un dossier de votre PC. En mode **Manual**, il demande avant de modifier un fichier ou d'exécuter une
- commande. Il peut chercher sur le web (DuckDuckGo ou Bing, sans compte). Les mots recherchés sont la seule chose qui quitte
- votre PC.
+ ### Application Terminal
- <p align="center"><img src="docs/media/app-chat.png" width="900" alt="L'application Strata : un chat où l'agent a construit un petit jardin de pagode en voxels, avec la page ouverte dans l'aperçu à droite"><br>
- <sub>L'agent a écrit un jardin de pagode en voxels dans un seul fichier HTML, et la page s'ouvre dans l'aperçu à côté du chat</sub></p>
+ Vous préférez le terminal ? Installez Strata, puis lancez **`strata launch`**.
- ### Dans le Terminal
+ <details open>
+ <summary><b>Commandes d'installation</b></summary>
- <p align="center"><img src="docs/media/terminal-monitor.png" width="900" alt="La vue d'ensemble du moniteur du Terminal Strata pendant que le modèle écrit une réponse"><br>
- <sub><code>strata monitor</code> pendant que le modèle répond : vitesse, GPU, mémoire et les dernières requêtes</sub></p>
+ **Linux / Mac**
```sh
- strata launch # guided: model, context, pictures, access, then serve
- strata launch --model q2_0 --yes --no-tui # no questions: serve and print the address
- strata launch --status # what is being served now
- strata launch --stop # stop it
- strata monitor # watch speed, GPU, memory and requests
- strata update # get the newest engine
- strata doctor # check the installed files
+ curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh -o install.sh && sh install.sh
```
- Pour joindre Strata depuis votre téléphone ou un autre PC, utilisez `strata launch --access lan`. La commande crée une clé
- d'API pour vous. `strata --help` liste tout, et [docs/TERMINAL.md](docs/TERMINAL.md) l'explique.
-
- ### Avec des agents d'IA et d'autres applications
-
- Un agent installe Strata avec la commande en une ligne ci-dessus et lance `strata launch --model NAME --yes --no-tui`. Les
- étapes, les options et les codes de sortie sont dans [docs/AI_SETUP.md](docs/AI_SETUP.md). Les règles du dépôt pour les agents : [AGENTS.md](AGENTS.md).
-
- | Votre application parle | URL de base |
- | --- | --- |
- | API OpenAI (la plupart des applications et des agents) | `http://127.0.0.1:8080/v1` (n'importe quelle clé d'API, n'importe quel nom de modèle) |
- | API Anthropic (Claude Code) | `http://127.0.0.1:8080`, sans `/v1`. Claude Code : `ANTHROPIC_BASE_URL=http://127.0.0.1:8080` |
- | API OpenAI Responses (Codex CLI) | `http://127.0.0.1:8080/v1/responses` ([configuration](docs/DETAILS.md#the-responses-api-and-codex-cli)) |
-
- `strata connect` affiche les réglages exacts pour OpenCode, Codex CLI, Claude Code, oh-my-pi, pi, Hermes Agent et OpenClaw,
- et `strata connect opencode --write` les écrit pour vous (avec une sauvegarde).
-
- ### Bon à savoir
-
- - **Les images** sont activées pour tous les modèles qui savent les lire. Joignez ou collez une image dans le chat, ou envoyez-la depuis votre application. Détails : [docs/IMAGES.md](docs/IMAGES.md).
- - **La réflexion** peut être désactivée, faible, moyenne ou élevée, dans le menu du chat ou dans le réglage « reasoning effort » de votre application. Désactivée est le plus rapide.
- - **Le premier message** d'une discussion est lu en entier, environ 1 minute pour 30 000 tokens. Les messages suivants démarrent en quelques secondes.
- - **Une requête à la fois** par défaut. Pour en traiter plusieurs, utilisez `--parallel N` ([BATCHING.md](docs/BATCHING.md)). Sur une carte de 12 Go, chaque réponse devient alors plus lente.
+ **Windows PowerShell**
- ## Compiler depuis les sources
-
- <details>
- <summary>Windows, Linux et Mac depuis le dépôt</summary>
-
- [Téléchargez Strata](https://github.com/Niko1221/Strata/archive/refs/heads/main.zip) et décompressez-le, ou faites un `git clone`.
- **Windows :** double-cliquez sur `START-HERE.bat`. **Linux :** lancez `./setup.sh` dans le dossier Strata.
-
- **Mac (Apple Silicon, macOS 15 ou plus récent) :** installez une fois les Command Line Tools d'Apple avec `xcode-select --install`
- (Xcode lui-même n'est pas nécessaire). Ouvrez le Terminal dans le dossier Strata et lancez `./setup.sh`. Le script compile
- le moteur Mac sur votre Mac (environ 7 minutes), pose les mêmes questions, télécharge le modèle et le démarre. La fois
- suivante, `./setup.sh` le démarre tout de suite. Quelle taille convient à votre Mac : [docs/MAC.md](docs/MAC.md).
-
- L'installateur détecte votre carte et prépare le bon moteur. Il demande quel modèle et quelle taille, combien de contexte
- (la quantité de texte que le modèle garde en tête) et s'il doit lire les images. Appuyez sur Entrée pour la réponse
- recommandée. Puis il télécharge le modèle (environ 70 Go) et le démarre. Si le téléchargement s'arrête, relancez le script
- et il reprend. Votre navigateur ouvre la page de Strata à l'adresse `http://127.0.0.1:8080`.
-
- > Pendant le démarrage du modèle, votre PC peut être lent ou ne plus répondre pendant 1 à 3 minutes (le plus longtemps la
- > première fois). Strata charge 35 à 55 Go dans votre RAM et en verrouille une partie pour la carte graphique. Patientez et
- > ne fermez pas la fenêtre.
-
- La fois suivante, relancez `START-HERE.bat` (ou `./setup.sh`). Il démarre tout de suite et ne télécharge rien deux fois.
- Fermez sa fenêtre pour arrêter le modèle. `UPDATE.bat` (`./update.sh`) met Strata à jour sans le démarrer. Mise à jour,
- Docker, plusieurs cartes, où vont les fichiers et toutes les options : [docs/INSTALL.md](docs/INSTALL.md).
-
- Pour mesurer votre PC, lancez `BENCH.bat` (`./bench.sh`). Cela prend 5 à 10 minutes et produit un rapport que vous pouvez
- partager ([comment](docs/COMMUNITY_BENCHMARKS.md#run-the-benchmark)).
-
- **Facultatif : plus de vitesse sur une carte quand tout le modèle tient en RAM.** Deux réglages à activer soi-même, par
- RubenTorney (#1904, #1905). Ils aident quand vous utilisez une seule carte graphique et que votre RAM contient tous les
- experts, par exemple Q2_0 ou IQ3_XXS sur un PC de 64 Go. Ouvrez `strata-<model>.json` dans le dossier de données de Strata ([où](docs/INSTALL.md#where-things-are-stored)) et ajoutez :
+ ```powershell
+ irm https://github.com/Niko1221/Strata/releases/latest/download/install.ps1 | iex
+ ```
- - `"--adapt-async", "1"` à la liste `"args"`. Le cache des experts se met alors à jour sur un thread auxiliaire au lieu de
- mettre la réponse en pause. Mesuré sur une RTX 5070 (Windows, Q2_0) : +4 à 5 % en décodage, +7 à 10 % sur le code et les
- longs documents. Les réponses peuvent différer légèrement de celles du réglage par défaut, et restent identiques d'une exécution à l'autre.
- - `"STRATA_PIN_BY_NEED": "1"` dans le bloc `"env"` (Windows). Windows ne peut verrouiller qu'environ la moitié de la RAM
- pour la carte graphique, et ce réglage verrouille d'abord les experts dont la carte a le plus besoin. Mesuré sur la RTX 5070 : +4,4 % en lecture du prompt.
+ Sous Windows, ouvrez ensuite un nouveau terminal. Puis :
- ```json
- "args": [ ..., "--adapt-async", "1" ],
- "env": { "STRATA_PIN_BY_NEED": "1" }
+ ```sh
+ strata launch
```
- Redémarrez Strata après la modification. Pour annuler, supprimez les deux entrées.
+ Suivez les invites pour télécharger et démarrer un modèle. [Guide du Terminal](docs/TERMINAL_LAUNCH.md).
</details>
diff --cc README.ja.md
index 6f0b7773e,f821df1d8..de6fc2244
--- a/README.ja.md
+++ b/README.ja.md
@@@ -5,289 -5,131 +5,131 @@@
</picture>
</p>
- <p align="center"><a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <b>日本語</b> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <a href="README.es.md">Español</a> · <a href="README.pt-BR.md">Português</a></p>
-
- <h3 align="center">最先端のモデルを、手元のゲーミングPCで動かす</h3>
-
- <p align="center">NVIDIA、AMD、Intel に対応 · Windows、Linux、Mac · 無料のオープンソース</p>
+ <h3 align="center">あなた自身のパソコンで、高性能な AI を。</h3>
+ <p align="center">チャット、コーディング、画像の処理を、すべてローカルで。</p>
<p align="center">
- <a href="https://github.com/Niko1221/Strata/releases/latest"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?include_prereleases&label=release" alt="最新リリース"></a>
- <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="MIT ライセンス"></a>
- <a href="https://github.com/Niko1221/Strata/stargazers"><img src="https://img.shields.io/github/stars/Niko1221/Strata?style=flat" alt="GitHub のスター"></a>
- <a href="https://buymeacoffee.com/strataengine"><img src="https://img.shields.io/badge/Buy%20me%20a%20coffee-FFDD00?logo=buymeacoffee&logoColor=black" alt="コーヒーをおごる"></a>
+ <a href="#モデル">モデル</a> · <a href="#インストール"><b>インストール</b></a> ·
+ <a href="#ハードウェア">ハードウェア</a> · <a href="#ツール">ツール</a> ·
+ <a href="#ヘルプ">ヘルプ</a> · <a href="#strata-を支援する">支援</a>
</p>
- <p align="center"><a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4"><img src="docs/media/pagoda-preview.webp" width="720" alt="Strata のモデルが書いたボクセルの塔の庭園。ブラウザで動いています"></a><br>
- <sub>ボクセルの塔の庭園。1回のプロンプトで生成し、RTX 5070 上の Strata で動かしています(IQ3_S、128K コンテキスト) ·
- <a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4">動画全体(49秒)</a></sub></p>
-
<p align="center">
- <a href="#インストール"><b>インストール</b></a> ·
- <a href="#モデル">モデル</a> ·
- <a href="#どのくらい速い">速度</a> ·
- <a href="#使い方">使い方</a> ·
- <a href="#仕組み">仕組み</a> ·
- <a href="#うまくいかないとき">ヘルプ</a> ·
- <a href="#strata-を応援する">応援する</a>
+ <a href="https://github.com/Niko1221/Strata/releases/latest"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?label=download&color=0ab887" alt="Strata をダウンロード"></a>
+ <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="MIT ライセンス"></a>
+ <a href="https://buymeacoffee.com/strataengine"><img src="https://img.shields.io/badge/Buy_me_a_coffee-FFDD00?logo=buymeacoffee&logoColor=000" alt="Buy Me a Coffee で Strata を支援する"></a>
</p>
- Strata は **[Qwen3.8-Flash-Next](https://huggingface.co/Qwen/Qwen3.8-Flash-Next)** を動かします。1250億パラメータのモデルで、
- ふつうはサーバーが必要ですが、Strata なら一般的なPCで使えます。0.2.4 からは、ターミナル版で **DeepSeek V4.1-Flash** も動かせます。
- チャット、コード作成、画像の読み取りができ、お使いのアプリやコーディングエージェントとも連携します。チャットとファイルはPCの外に出ません。
-
- - **ゲーミングPCで動きます。** RAMとグラフィックスメモリの合計が32 GBあれば始められます。
- - **お使いのツールと連携します。** Claude Code、Codex CLI、OpenCode などのエージェントが、OpenAI と Anthropic の API で接続できます。
- - **画像を読めます。** 初期設定でオンです。
- - **無料でプライバシーも守ります。** MIT ライセンス。アカウントもクラウドもテレメトリも不要です([何をいつダウンロードするか](docs/SAFETY.md))。
-
- ## 必要な環境
-
- **RAMとグラフィックスメモリ(VRAM)の合計が、少なくとも32 GB必要です。** MacやRyzen AI Maxでは、ユニファイドメモリがその量にあたります。
- RAM 32 GBのPCに12〜16 GBのカードがあれば小さいサイズが動き、64 GBならどのサイズも動きます。
-
- | 動く環境 | ガイド |
- | --- | --- |
- | **NVIDIA** GeForce RTX 20、30、40、50 シリーズ、12 GB以上 | [インストール](#インストール) |
- | **AMD** Radeon RX 6800 以降、Radeon AI PRO R9700 | [AMD のカード](docs/AMD_HIP.md) |
- | **Intel** Arc | [Intel Arc](docs/INTEL_ARC.md) |
- | **Apple Silicon の Mac**、M1 以降、macOS 15 以降 | [Mac](docs/MAC.md) |
- | **AMD Ryzen AI Max(Strix Halo)** などのユニファイドメモリ搭載機 | [Strix Halo](docs/STRIX_HALO.md) |
- | 古いカードやプロセッサ | [古いGPU](docs/OLDER_GPUS.md) |
-
- そのほかに、約80 GBの空きディスク容量(SSD)、Windows 10 / 11、Linux、または macOS、最新のグラフィックスドライバーが必要です。
- 同じメーカーのカードを2〜3枚使って、1つのモデルを動かせます([マルチGPU](docs/MULTI_GPU.md))。
-
- ## インストール
-
- ### 1. Strata アプリ(いちばん簡単)
-
- お使いのPCに合うファイルをダウンロードして開き、すすめられたモデルのインストールを押します。
-
- **Windows 10 / 11**
-
- [![Windows](https://img.shields.io/badge/Windows-10%20%2F%2011-0078D4?style=for-the-badge&logo=windows&logoColor=white)](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.5-windows-x64-setup.exe)
-
- **Linux**
-
- [![Linux](https://img.shields.io/badge/Linux-AppImage-FCC624?style=for-the-badge&logo=linux&logoColor=black)](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.5-linux-x86_64.AppImage)
-
- **Mac**(Apple Silicon、macOS 15 以降)
+ <p align="center"><sub><a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <b>日本語</b> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <a href="README.es.md">Español</a> · <a href="README.pt-BR.md">Português</a></sub></p>
- [![Mac、Apple Silicon](https://img.shields.io/badge/Mac-Apple%20Silicon-333333?style=for-the-badge&logo=apple&logoColor=white)](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.5-macos-arm64.dmg)
+ **無料でオープンソース。自分の環境で動かせます。** デスクトップで、またはお好みのコーディングツールと一緒に Strata を使えます。アカウントは不要です。
- お使いのグラフィックスカードに合うエンジンは、アプリが自動で選びます。すべてのファイルは
- [リリースページ](https://github.com/Niko1221/Strata/releases/latest)にあります。
+ ## モデル
- | 初回の起動 | すること |
- | --- | --- |
- | **Windows** | `.exe` を実行します。管理者権限は不要です。「Windows によってPCが保護されました」と表示されたら、**詳細情報**を選び、**実行**を選んでください。 |
- | **Linux** | ファイルを実行可能にして(`chmod +x`)起動します。FUSE 2 が必要です。`sudo apt install libfuse2t64`(Ubuntu 24.04 以降)または `libfuse2`(22.04)を実行してください。 |
- | **Mac** | `.dmg` を開き、Strata を「アプリケーション」にドラッグします。 |
+ まず **ISTA-DASLab** をおすすめします。次に **Unsloth** などの提供元です。メモリに収まる互換モデルがある場合に選べます。
- モデルのダウンロードは大きく(40〜70 GB)、止まっても続きから再開します。
+ <details>
+ <summary><img src="docs/media/models/deepseek.svg" width="22" alt="" align="middle"> &nbsp;<b>DeepSeekV4.1-Flash-1017</b></summary>
- ### 2. ターミナル(1行)
+ **デスクトップアプリ**と**ターミナル**で使えます。メモリに収まらない分は SSD から読み込むため、空きディスク容量がたくさん必要です。
- `strata` コマンドです。スクリプトやサーバー、AI エージェント向けです。DeepSeek を動かすにもこれを使います。
+ | セット(IST-DAS) | ダウンロード | 必要な空き容量 |
+ | --- | ---: | ---: |
+ | 1.75 bpw | 239 GB | 約245 GB |
+ | 2.00 bpw | 257 GB | 約265 GB |
+ | 2.25 bpw | 274 GB | 約280 GB |
- Linux と Mac:
+ NVIDIA RTX 30・40・50 シリーズ(Windows と Linux)と、AMD Radeon AI PRO R9700(Linux)で動きます。セットアップがファイルと DeepSeek エンジンをダウンロードし、モデルを起動します。
```sh
- curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh -o install.sh && sh install.sh
+ strata launch --family deepseek41 --model ist-das-2.00bpw --plan
```
- Windows(PowerShell):
+ Strata 0.2.5 で 2.00 bpw のセットを使って測定しました。「出力」は回答の速さ、「プロンプト」は Strata が入力を読み込む速さです。
- ```powershell
- irm https://github.com/Niko1221/Strata/releases/latest/download/install.ps1 | iex
- ```
+ | ハードウェア | 出力 | プロンプト |
+ | --- | ---: | ---: |
+ | RTX 5070 12 GB, 64 GB RAM | 4〜6 トークン/秒 | 約 110 トークン/秒 (4K) |
+ | RTX 3060 12 GB, 46 GB RAM | 9〜11 トークン/秒 | 約 155 トークン/秒 (4K) |
+ | 1x Radeon AI PRO R9700, 251 GB RAM | 21〜25 トークン/秒 | 320〜360 トークン/秒 (8K) |
+ | 4x Radeon AI PRO R9700 | 74〜77 トークン/秒 | 400〜450 トークン/秒 (8K) |
- そのあと起動します。質問は1つずつ表示されます(モデル、コンテキスト、画像、接続を許可する相手)。必要なものをダウンロードして、
- サーバーを開始します。
+ [メモリ、ディスク、詳細](docs/DEEPSEEK41.md) · [リリースノート](https://github.com/Niko1221/Strata/releases)
- ```sh
- strata launch
- ```
-
- 管理者権限は不要です。インストールでは、ダウンロードしたものすべての SHA-256 を検証します。Windows では、インストール後に新しいターミナルを開いてください。
- すべての画面とフラグは [docs/TERMINAL_LAUNCH.md](docs/TERMINAL_LAUNCH.md) にあります。
-
- ### 3. AI にセットアップを任せる
-
- Claude Code、Cursor、Codex、GitHub Copilot などのコーディングアシスタントに、次の文を貼り付けます。
-
- ```text
- Set up Strata on this PC for me: https://github.com/Niko1221/Strata - follow docs/AI_SETUP.md in that repository.
- ```
-
- AI はグラフィックスカード、RAM、ディスクを調べ、合うモデルを選んで、インストールと起動をし、アプリの接続方法を教えてくれます。
- AI ツールは [MCP サーバー](docs/MCP_SERVER.md)を通じて、Strata のインストール、起動、停止もできます。
-
- 自分でビルドしたい方は[ソースからビルド](#ソースからビルド)を見てください。
-
- ## モデル
-
- アプリと `strata launch` は、メモリ量に合うサイズをすすめます。小さいサイズは速く、大きいサイズは少し賢くなります。
-
- ### メモリが少ないなら Gyro
+ </details>
- [Gyro](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF)(agentionai 製)は、Qwen3.8-Flash-Next をいちばん小さく動かせる方法です。
- NVIDIA、AMD、Intel Arc、Apple Silicon で動きます。
+ <details>
+ <summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.8-Flash-Next</b></summary>
- | サイズ | 必要なメモリ(RAM + VRAM) | ダウンロード | 向いているPC |
- | --- | ---: | ---: | --- |
- | **Gyro-S** | 27.6 GB | 58.5 GB | ほかのサイズが入らないPC向け。32 GB の Mac mini で毎秒 9 トークン。 |
- | **Gyro-M** | 35 GB | 92.0 GB | 品質は IQ3_XXS 程度で、GPUメモリの使用量は20%少なくなります。 |
+ | 提供元 | 選択肢 |
+ | --- | --- |
+ | **ISTA-DASLab · おすすめ** | Q2\_0, IQ2\_XS, IQ3\_XXS, IQ3\_S。[Coder: IQ1\_M](docs/MODELS.md#coder)(コーディング向け)。 |
+ | **Unsloth** | UD-IQ4\_XS, UD-Q4\_K\_XL, UD-Q5\_K\_XL, UD-Q6\_K\_XL, Q8\_0 |
+ | **Gyro · agentionai** | [Gyro-S, Gyro-M](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF)。メモリ使用量は少ないですが、動作は遅くなります。 |
+ | **その他の選択肢** | [Swift 1.5](docs/MODELS.md#swift-15), [NVFP4](docs/NVFP4.md), [OrcaRouter](docs/ORCA.md) |
- `strata launch --model gyro-s` で起動します。詳細は [docs/GYRO.md](docs/GYRO.md) にあります。
+ [サイズ、必要なメモリ、互換性を比べる](docs/MODELS.md)。
- ### Qwen3.8-Flash-Next のサイズ
+ </details>
- | メモリ(RAM + VRAM) | 選ぶモデル | 理由 |
- | --- | --- | --- |
- | **32 GB** | **Gyro-S**、またはコード向けの **[Coder](docs/MODELS.md#coder)** | Coder は、コードで使うエキスパートを残します |
- | **40 GB** | **[Swift 1.5](docs/MODELS.md#swift-15)** IQ2_XS(39.2 GB)、または **Gyro-M** | Swift は答える前に考える時間が短くなります |
- | **48 GB** | **IQ3_XXS**(47.0 GB) | 遅くなりますが、品質は上がります |
- | **64 GB** | **IQ3_S**(54.8 GB) | 公開されているテストでは完全版と同等です |
- | **96 GB 以上** | Unsloth の **UD-IQ4_XS** から **Q8_0** | 完全版にいちばん近いです |
+ <details>
+ <summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.6-35B-A3B</b></summary>
- 表の行より RAM が少なくても、遅くなるだけで動くことがあります。Strata は自動で[低RAMモード](docs/MODELS.md#a-big-graphics-card-and-little-ram)に切り替わります。
- そのほかに、NVIDIA カード向けの [NVFP4](docs/NVFP4.md)、[Qwen3.6-35B-A3B](docs/QWEN36.md)(より小さく、複数のリクエストを同時に処理)、
- [OrcaRouter の Uncensored IQ3_XXS](docs/MODELS.md#orcarouter-uncensored-iq3_xxs) があります。すべてのサイズと、どの構成で何が動くか:
- [docs/MODELS.md](docs/MODELS.md)。
+ **Unsloth:** UD-Q4_K_XL, UD-Q6_K_XL, Q8_0。現在、このモデルで文書化されているパックです。
- ### DeepSeek V4.1-Flash(ターミナル版、0.2.4 から)
+ [モデルガイドと互換性](docs/QWEN36.md)。
- ずっと大きなモデルで、12 GB のグラフィックスカード 1 枚と 46 から 64 GB の RAM で動きます。Strata はよく使う部分をメモリに置き、
- 残りは SSD から読みます。セットは [ISTA-DASLab](https://huggingface.co/ISTA-DASLab/DeepSeek-V4.1-Flash-1017-GSQ-RCO-GGUF) が作りました。
- NVIDIA RTX 30、40、50 シリーズのカードと Radeon AI PRO R9700 で動きます。`strata launch` で選んでください。デスクトップアプリはまだ対応していません。
+ </details>
- | セット | ダウンロード | 品質 | コードの出力速度 |
- | --- | ---: | --- | --- |
- | **IQ1_M**(1.75 ビット) | 239 GB | いちばん小さく、ふつうの文章は弱めです | PC ではまだ測っていません |
- | **IQ2_XXS**(2.00 ビット) | 257 GB | バランスが良いです | 毎秒 10 トークン(RTX 3060)、5(RTX 5070)、48(R9700 4 枚) |
- | **IQ2_XS**(2.25 ビット) | 274 GB | 元のモデルにいちばん近いです | 毎秒 15 トークン(R9700 1 枚)、80(R9700 4 枚) |
- | **IQ4_NL**(Engram テーブル) | 上のどのダウンロードにも含まれます | 3 つのセットが共有する参照テーブルです | |
+ <a id="the-other-sizes"></a>
- `strata launch --model ist-das-2.00bpw`(または `ist-das-1.75bpw`、`ist-das-2.25bpw`)で起動します。品質の数値、PC ごとの速度、手動インストールは
- [docs/DEEPSEEK41.md](docs/DEEPSEEK41.md) にあります。
+ どれが動くかわからない場合は、[お使いのパソコンに合うモデルを選ぶ](docs/MODELS.md#pick-by-memory)。
- ## どのくらい速い?
+ ## インストール
- 12 GBのグラフィックスカード(RTX 5070、RAM 64 GB)での数値です。ほかのカードの結果は
- [各サイズの速度](docs/MODELS.md#how-fast-is-each-size)と[コミュニティの結果](docs/COMMUNITY_BENCHMARKS.md)を見てください。
+ <a id="option-a-the-strata-app"></a>
- | モデル | 回答が出る速さ | プロンプトを読む速さ |
- | --- | --- | --- |
- | **Q2_0** | `████████████` 94 tokens/s | `████████████` 2,650 tokens/s |
- | **IQ2_XS** | `██████████░░` 79 tokens/s | `█████████░░░` 2,090 tokens/s |
- | **IQ3_XXS** | `████████░░░░` 62 tokens/s | `████████░░░░` 1,750 tokens/s |
- | **IQ3_S** | `███████░░░░░` 53 tokens/s | `███████░░░░░` 1,620 tokens/s |
- | **Coder** | `███████░░░░░` 55 tokens/s | `██████████░░` 2,180 tokens/s |
+ ### デスクトップアプリ
- 16 GBの AMD カード(RX 9070 XT、RAM 47 GB)の場合:
+ **[Windows、Linux、Mac 用の Strata をダウンロード →](https://github.com/Niko1221/Strata/releases/latest)**
- | モデル | 回答が出る速さ | プロンプトを読む速さ |
- | --- | --- | --- |
- | **Q2_0** | `████████░░░░` 60 tokens/s | `█████░░░░░░░` 1,160 tokens/s |
- | **IQ2_XS** | `███████░░░░░` 52 tokens/s | `█████░░░░░░░` 1,110 tokens/s |
- | **Coder** | `██████░░░░░░` 44 tokens/s | `██████░░░░░░` 1,420 tokens/s |
+ アプリをインストールし、モデルを選んで、チャットを始めましょう。インストーラーはシステムごとに1つです。初回起動時に、アプリがお使いのグラフィックスカード用のエンジンをダウンロードします。[インストーラーのヘルプ](docs/INSTALL.md#the-app)。
- 1トークンは英単語の約¾にあたるので、毎秒60トークンは読む速さより速くなります。「プロンプトを読む速さ」は、長い文書やコード、チャット履歴を Strata が取り込む速さです。
-<sub>ファイル: `Strata-0.2.5-windows-x64-setup.exe` · `Strata-0.2.5-linux-x86_64.AppImage` · `Strata-0.2.5-macos-arm64.dmg`</sub>
++<sub>ファイル: `Strata-0.2.6-windows-x64-setup.exe` · `Strata-0.2.6-linux-x86_64.AppImage` · `Strata-0.2.6-macos-arm64.dmg`</sub>
- ## 使い方
+ <p align="center">
+ <img src="docs/media/app-chat.png" width="900" alt="チャットとライブのコードプレビューを並べて表示した Strata デスクトップアプリ">
+ <br><sub>チャット、ファイル、ライブプレビューを1つのウィンドウで。</sub>
+ </p>
- ### アプリで
+ <a id="option-b-the-terminal-one-line"></a>
- チャット、モデルとGPU・CPU・RAMの状態を見る**モニター**、**モデル**ページ、**設定**があります。チャットはPC上のフォルダで作業できます。
- **手動**モードでは、ファイルを変更したりコマンドを実行したりする前に確認します。ウェブ検索もできます(DuckDuckGo または Bing、アカウント不要)。
- PCの外に出るのは検索語だけです。
+ ### ターミナルアプリ
- <p align="center"><img src="docs/media/app-chat.png" width="900" alt="Strata アプリ。エージェントが小さなボクセルの塔の庭を作ったチャットで、右側のプレビューにそのページが開いています"><br>
- <sub>エージェントがボクセルの塔の庭を 1 つの HTML ファイルとして書き、そのページがチャットの横のプレビューで開きます</sub></p>
+ ターミナルのほうが好みですか? Strata をインストールして、**`strata launch`** を実行します。
- ### ターミナルで
+ <details open>
+ <summary><b>インストールコマンド</b></summary>
- <p align="center"><img src="docs/media/terminal-monitor.png" width="900" alt="モデルが返信を書いている間の Strata ターミナルのモニター概要"><br>
- <sub>モデルが返信を書いている間の <code>strata monitor</code>。速度、GPU、メモリ、最近のリクエストが表示されます</sub></p>
+ **Linux / Mac**
```sh
- strata launch # guided: model, context, pictures, access, then serve
- strata launch --model q2_0 --yes --no-tui # no questions: serve and print the address
- strata launch --status # what is being served now
- strata launch --stop # stop it
- strata monitor # watch speed, GPU, memory and requests
- strata update # get the newest engine
- strata doctor # check the installed files
+ curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh -o install.sh && sh install.sh
```
- スマートフォンや別のPCから Strata に接続するには、`strata launch --access lan` を使います。API キーが自動で作られます。
- `strata --help` ですべてのコマンドを確認できます。説明は [docs/TERMINAL.md](docs/TERMINAL.md) にあります。
-
- ### AI エージェントやほかのアプリと使う
-
- エージェントは、上の1行コマンドで Strata をインストールし、`strata launch --model NAME --yes --no-tui` を実行します。手順、フラグ、終了コードは
- [docs/AI_SETUP.md](docs/AI_SETUP.md) にあります。エージェント向けのリポジトリのルールは [AGENTS.md](AGENTS.md) にあります。
-
- | アプリが使うもの | ベース URL |
- | --- | --- |
- | OpenAI API(ほとんどのアプリとエージェント) | `http://127.0.0.1:8080/v1`(API キーもモデル名も何でも可) |
- | Anthropic API(Claude Code) | `http://127.0.0.1:8080`、`/v1` は付けません。Claude Code: `ANTHROPIC_BASE_URL=http://127.0.0.1:8080` |
- | OpenAI Responses API(Codex CLI) | `http://127.0.0.1:8080/v1/responses`([設定方法](docs/DETAILS.md#the-responses-api-and-codex-cli)) |
-
- `strata connect` は、OpenCode、Codex CLI、Claude Code、oh-my-pi、pi、Hermes Agent、OpenClaw の正確な設定を表示します。
- `strata connect opencode --write` なら、設定を書き込みます(バックアップ付き)。
-
- ### 知っておくと便利なこと
-
- - **画像**は、画像を読めるモデルすべてでオンです。チャットに画像を添付または貼り付けるか、アプリから送ってください。詳細: [docs/IMAGES.md](docs/IMAGES.md)。
- - **思考のレベル**は off、low、medium、high から、チャットのメニューか、お使いのアプリの「reasoning effort」で選びます。off がいちばん速くなります。
- - **チャットの最初のメッセージ**は全文読みます。30,000トークンあたり約1分かかります。続きのメッセージは数秒で始まります。
- - **一度に1つのリクエスト**が初期設定です。複数にするには `--parallel N` を使います([BATCHING.md](docs/BATCHING.md))。12 GBのカードでは、1つずつの回答が遅くなります。
+ **Windows PowerShell**
- ## ソースからビルド
-
- <details>
- <summary>リポジトリから Windows、Linux、Mac 用にビルドする</summary>
-
- [Strata をダウンロード](https://github.com/Niko1221/Strata/archive/refs/heads/main.zip)して展開するか、`git clone` します。
- **Windows:** `START-HERE.bat` をダブルクリックします。**Linux:** Strata フォルダで `./setup.sh` を実行します。
-
- **Mac(Apple Silicon、macOS 15 以降):** 最初に一度、`xcode-select --install` で Apple のコマンドラインツールをインストールします
- (Xcode 本体は不要です)。Strata フォルダでターミナルを開き、`./setup.sh` を実行します。Mac 用エンジンをお使いの Mac 上でビルドし
- (約7分)、同じ質問をして、モデルをダウンロードし、起動します。2回目以降は `./setup.sh` ですぐに起動します。
- お使いの Mac に合うサイズは [docs/MAC.md](docs/MAC.md) を見てください。
-
- インストーラーはカードを見つけて、合うエンジンを設定します。どのモデルとサイズにするか、コンテキストをどれだけにするか(モデルが一度に覚えておけるテキストの量)、
- 画像を読ませるかを聞かれます。おすすめの答えでよければ Enter を押します。そのあとモデル(約70 GB)をダウンロードして起動します。
- ダウンロードが止まったら、もう一度実行すると続きから再開します。ブラウザで `http://127.0.0.1:8080` の Strata ページが開きます。
-
- > モデルの起動中は、PCが1〜3分ほど(初回がいちばん長い)遅くなったり、応答しなくなったりすることがあります。Strata は35〜55 GBをRAMに読み込み、
- > その一部をグラフィックスカード用に固定するためです。ウィンドウを閉じずに待ってください。
-
- 次回からは `START-HERE.bat`(または `./setup.sh`)をもう一度実行するだけです。すぐに起動し、同じものを2回ダウンロードすることはありません。ウィンドウを閉じるとモデルが止まります。
- `UPDATE.bat`(`./update.sh`)は、起動せずに Strata を更新します。更新、Docker、複数のカード、ファイルの保存先、すべてのオプションは
- [docs/INSTALL.md](docs/INSTALL.md) にあります。
-
- PCの性能を測るには、`BENCH.bat`(`./bench.sh`)を実行します。5〜10分かかり、共有できるレポートが作られます
- ([方法](docs/COMMUNITY_BENCHMARKS.md#run-the-benchmark))。
-
- **オプション: モデル全体がRAMに入るとき、1枚のカードをさらに速くする。** RubenTorney による、自分でオンにする2つの設定です(#1904、#1905)。
- グラフィックスカードが1枚で、RAM がすべてのエキスパートを保持できるときに効果があります。たとえば64 GBのPCでの Q2_0 や IQ3_XXS です。
- Strata のデータフォルダにある `strata-<model>.json`([場所](docs/INSTALL.md#where-things-are-stored))を開いて、次を追加します。
+ ```powershell
+ irm https://github.com/Niko1221/Strata/releases/latest/download/install.ps1 | iex
+ ```
- - `"args"` のリストに `"--adapt-async", "1"` を追加します。エキスパートキャッシュが、回答を止めずに補助スレッドで更新されます。
- RTX 5070(Windows、Q2_0)での測定: デコードが4〜5%、コードや長い文書では7〜10%速くなりました。回答は初期設定と少し違うことがありますが、実行ごとの結果は変わりません。
- - `"env"` ブロックに `"STRATA_PIN_BY_NEED": "1"` を追加します(Windows)。Windows ではグラフィックスカード用に固定できる RAM が半分ほどしかありません。
- この設定は、カードが最初に必要とするエキスパートを優先して固定します。RTX 5070 での測定: プロンプトの読み取りが4.4%速くなりました。
+ Windows では、インストール後に新しいターミナルを開きます。そのあと:
- ```json
- "args": [ ..., "--adapt-async", "1" ],
- "env": { "STRATA_PIN_BY_NEED": "1" }
+ ```sh
+ strata launch
```
- 変更したら Strata を再起動してください。元に戻すには、2つの項目を削除します。
+ 画面の案内に従って、モデルをダウンロードして起動します。[ターミナルガイド](docs/TERMINAL_LAUNCH.md)。
</details>
diff --cc README.md
index 7ce671fb1,bab4703a6..d263679ae
--- a/README.md
+++ b/README.md
@@@ -5,293 -5,134 +5,134 @@@
</picture>
</p>
- <p align="center"><b>English</b> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <a href="README.es.md">Español</a> · <a href="README.pt-BR.md">Português</a></p>
-
- <h3 align="center">Run a state-of-the-art model on your own gaming PC</h3>
-
- <p align="center">Support for NVIDIA, AMD, Intel · Windows, Linux, Mac · free and open source</p>
+ <h3 align="center">Run powerful AI on your own computer.</h3>
+ <p align="center">Chat, code and work with images, locally.</p>
<p align="center">
- <a href="https://github.com/Niko1221/Strata/releases/latest"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?include_prereleases&label=release" alt="Latest release"></a>
- <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="MIT license"></a>
- <a href="https://github.com/Niko1221/Strata/stargazers"><img src="https://img.shields.io/github/stars/Niko1221/Strata?style=flat" alt="GitHub stars"></a>
- <a href="https://buymeacoffee.com/strataengine"><img src="https://img.shields.io/badge/Buy%20me%20a%20coffee-FFDD00?logo=buymeacoffee&logoColor=black" alt="Buy me a coffee"></a>
+ <a href="#models">Models</a> · <a href="#install"><b>Install</b></a> ·
+ <a href="#hardware">Hardware</a> · <a href="#tools">Tools</a> ·
+ <a href="#help">Help</a> · <a href="#support-strata">Support</a>
</p>
- <p align="center"><a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4"><img src="docs/media/pagoda-preview.webp" width="720" alt="A voxel pagoda garden that Strata's model wrote, running in the browser"></a><br>
- <sub>A voxel pagoda garden, 1 shot prompt running on an RTX 5070 with Strata (IQ3_S, 128K context) ·
- <a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4">full video (49 s)</a></sub></p>
-
<p align="center">
- <a href="#install"><b>Install</b></a> ·
- <a href="#models">Models</a> ·
- <a href="#how-fast-is-it">Speed</a> ·
- <a href="#using-it">Using it</a> ·
- <a href="#how-does-it-work">How it works</a> ·
- <a href="#something-went-wrong">Help</a> ·
- <a href="#support-strata">Support</a>
+ <a href="https://github.com/Niko1221/Strata/releases/latest"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?label=download&color=0ab887" alt="Download Strata"></a>
+ <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="MIT license"></a>
+ <a href="https://buymeacoffee.com/strataengine"><img src="https://img.shields.io/badge/Buy_me_a_coffee-FFDD00?logo=buymeacoffee&logoColor=000" alt="Support Strata on Buy Me a Coffee"></a>
</p>
- Strata runs **[Qwen3.8-Flash-Next](https://huggingface.co/Qwen/Qwen3.8-Flash-Next)**, a 125-billion-parameter model that
- normally needs a server, on a normal PC. From 0.2.4 it also runs **DeepSeek V4.1-Flash** in the Terminal. It chats, writes
- code, reads pictures and works with your apps and coding agents. Your chats and files stay on your PC.
-
- - **Runs on a gaming PC.** 32 GB of RAM and graphics memory together is enough to start.
- - **Works with your tools.** Claude Code, Codex CLI, OpenCode and other agents connect through the OpenAI and Anthropic APIs.
- - **Reads pictures**, on by default.
- - **Free and private.** MIT license, no account, no cloud, no telemetry ([what it downloads and when](docs/SAFETY.md)).
-
- ## What you need
-
- **At least 32 GB of memory: RAM and graphics memory (VRAM) together.** On a Mac or a Ryzen AI Max that is the unified
- memory. A 32 GB PC with a 12-16 GB card runs the smaller sizes, and 64 GB runs every size.
-
- | Works on | Guide |
- | --- | --- |
- | **NVIDIA** GeForce RTX 20, 30, 40 and 50 series, 12 GB or more | [Install](#install) |
- | **AMD** Radeon RX 6800 and newer, Radeon AI PRO R9700 | [AMD cards](docs/AMD_HIP.md) |
- | **Intel** Arc | [Intel Arc](docs/INTEL_ARC.md) |
- | **Apple Silicon Mac**, M1 or newer, macOS 15 or newer | [Mac](docs/MAC.md) |
- | **AMD Ryzen AI Max (Strix Halo)** and other unified-memory PCs | [Strix Halo](docs/STRIX_HALO.md) |
- | Older cards and processors | [Older GPUs](docs/OLDER_GPUS.md) |
-
- You also need about 80 GB of free disk (an SSD), Windows 10 / 11, Linux or macOS, and a current graphics driver. Two or
- three cards of the same make can share a model ([multi-GPU](docs/MULTI_GPU.md)).
-
- ## Install
-
- ### 1. The Strata app (easiest)
-
- Download the file for your computer, open it, and press install on the model it recommends.
-
- **Windows 10 / 11**
-
- [![Windows](https://img.shields.io/badge/Windows-10%20%2F%2011-0078D4?style=for-the-badge&logo=windows&logoColor=white)](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.5-windows-x64-setup.exe)
-
- **Linux**
-
- [![Linux](https://img.shields.io/badge/Linux-AppImage-FCC624?style=for-the-badge&logo=linux&logoColor=black)](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.5-linux-x86_64.AppImage)
-
- **Mac** (Apple Silicon, macOS 15 or newer)
+ <p align="center"><sub><b>English</b> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <a href="README.es.md">Español</a> · <a href="README.pt-BR.md">Português</a></sub></p>
- [![Mac, Apple Silicon](https://img.shields.io/badge/Mac-Apple%20Silicon-333333?style=for-the-badge&logo=apple&logoColor=white)](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.5-macos-arm64.dmg)
+ **Free, open source, and yours to run.** Use Strata on your desktop or with your favorite coding tools. No account needed.
- The app picks the right engine for your graphics card by itself. All files are on the [releases page](https://github.com/Niko1221/Strata/releases/latest).
-
- | First start | What to do |
- | --- | --- |
- | **Windows** | Run the `.exe`. No administrator rights needed. If Windows says "Windows protected your PC", choose **More info**, then **Run anyway**. |
- | **Linux** | `chmod +x` the file and start it. It needs FUSE 2: `sudo apt install libfuse2t64` (Ubuntu 24.04 and newer) or `libfuse2` (22.04). |
- | **Mac** | Open the `.dmg` and drag Strata onto Applications. |
-
- The model download is big (40-70 GB). If it stops, it continues where it left off.
-
- ### 2. The Terminal (one line)
-
- The `strata` command, for scripts, servers and AI agents. It is also the way to run DeepSeek.
+ ## Models
- Linux and Mac:
+ We recommend **ISTA-DASLab first**, then **Unsloth** and other providers, where a compatible model fits.
- ```sh
- curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh -o install.sh && sh install.sh
- ```
+ <details>
+ <summary><img src="docs/media/models/deepseek.svg" width="22" alt="" align="middle"> &nbsp;<b>DeepSeekV4.1-Flash-1017</b></summary>
- Windows (PowerShell):
+ In the **desktop app** and the **Terminal**. What does not fit in memory is read from your SSD, so it needs a lot of free
+ disk space.
- ```powershell
- irm https://github.com/Niko1221/Strata/releases/latest/download/install.ps1 | iex
- ```
+ | Set (IST-DAS) | Download | Free disk needed |
+ | --- | ---: | ---: |
+ | 1.75 bpw | 239 GB | about 245 GB |
+ | 2.00 bpw | 257 GB | about 265 GB |
+ | 2.25 bpw | 274 GB | about 280 GB |
- Then start it. It asks one question at a time (model, context, pictures, who may connect), downloads what it needs and
- starts serving:
+ Runs on NVIDIA RTX 30, 40 and 50 series (Windows and Linux) and AMD Radeon AI PRO R9700 (Linux). Setup downloads the
+ files and the DeepSeek engine, then starts the model.
```sh
- strata launch
- ```
-
- No admin rights needed. The install checks the SHA-256 of everything it downloads. On Windows, open a new terminal window
- after the install. All screens and flags: [docs/TERMINAL_LAUNCH.md](docs/TERMINAL_LAUNCH.md).
-
- ### 3. Let your AI set it up
-
- Paste this into Claude Code, Cursor, Codex, GitHub Copilot or another coding assistant:
-
- ```text
- Set up Strata on this PC for me: https://github.com/Niko1221/Strata - follow docs/AI_SETUP.md in that repository.
+ strata launch --family deepseek41 --model ist-das-2.00bpw --plan
```
- It checks your graphics card, RAM and disk, picks the model that fits, installs it, starts it and tells you how to connect
- your apps. AI tools can also install, start and stop Strata through its [MCP server](docs/MCP_SERVER.md).
+ Measured with the 2.00 bpw set on Strata 0.2.5. Output is the speed of the answer, prompt is how fast Strata reads your input.
- Prefer to build it yourself? See [Build from source](#build-from-source).
+ | Hardware | Output | Prompt |
+ | --- | ---: | ---: |
+ | RTX 5070 12 GB, 64 GB RAM | 4 to 6 tokens/s | about 110 tokens/s (4K) |
+ | RTX 3060 12 GB, 46 GB RAM | 9 to 11 tokens/s | about 155 tokens/s (4K) |
+ | 1x Radeon AI PRO R9700, 251 GB RAM | 21 to 25 tokens/s | 320 to 360 tokens/s (8K) |
+ | 4x Radeon AI PRO R9700 | 74 to 77 tokens/s | 400 to 450 tokens/s (8K) |
- ## Models
+ [Memory, disk and details](docs/DEEPSEEK41.md) · [Release notes](https://github.com/Niko1221/Strata/releases)
- The app and `strata launch` recommend a size for your memory. Smaller sizes are faster, larger sizes are a bit smarter.
-
- ### Low on memory? Start with Gyro
+ </details>
- [Gyro](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF) by agentionai is the smallest way to run
- Qwen3.8-Flash-Next. It runs on NVIDIA, AMD, Intel Arc and Apple Silicon.
+ <details>
+ <summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.8-Flash-Next</b></summary>
- | Size | Memory it needs (RAM + VRAM) | Download | Good for |
- | --- | ---: | ---: | --- |
- | **Gyro-S** | 27.6 GB | 58.5 GB | PCs that fit nothing else. 9 tokens/s on a 32 GB Mac mini. |
- | **Gyro-M** | 35 GB | 92.0 GB | About IQ3_XXS quality with 20% less GPU memory. |
+ | Provider | Choices |
+ | --- | --- |
+ | **ISTA-DASLab · recommended** | Q2\_0, IQ2\_XS, IQ3\_XXS, IQ3\_S. [Coder: IQ1\_M](docs/MODELS.md#coder) for coding. |
+ | **Unsloth** | UD-IQ4\_XS, UD-Q4\_K\_XL, UD-Q5\_K\_XL, UD-Q6\_K\_XL, Q8\_0 |
+ | **Gyro · agentionai** | [Gyro-S, Gyro-M](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF). Lower memory use but slower. |
+ | **Other options** | [Swift 1.5](docs/MODELS.md#swift-15), [NVFP4](docs/NVFP4.md), [OrcaRouter](docs/ORCA.md) |
- Start it with `strata launch --model gyro-s`. Details: [docs/GYRO.md](docs/GYRO.md).
+ [Compare sizes, memory needs and compatibility](docs/MODELS.md).
- ### Qwen3.8-Flash-Next sizes
+ </details>
- | Your memory (RAM + VRAM) | Take | Why |
- | --- | --- | --- |
- | **32 GB** | **Gyro-S**, or the **[Coder](docs/MODELS.md#coder)** for code | The Coder keeps the experts that code uses |
- | **40 GB** | **[Swift 1.5](docs/MODELS.md#swift-15)** IQ2_XS (39.2 GB) or **Gyro-M** | Swift thinks for a shorter time before it answers |
- | **48 GB** | **IQ3_XXS** (47.0 GB) | Slower, better |
- | **64 GB** | **IQ3_S** (54.8 GB) | Matches the full model on the published tests |
- | **96 GB or more** | Unsloth's **UD-IQ4_XS** to **Q8_0** | Closest to the full model |
+ <details>
+ <summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.6-35B-A3B</b></summary>
- Less RAM than a row says can still work, only slower: Strata switches to its
- [low-RAM mode](docs/MODELS.md#a-big-graphics-card-and-little-ram) by itself. Also available:
- [NVFP4](docs/NVFP4.md) for NVIDIA cards, [Qwen3.6-35B-A3B](docs/QWEN36.md) (smaller, several requests at once) and
- [OrcaRouter's Uncensored IQ3_XXS](docs/MODELS.md#orcarouter-uncensored-iq3_xxs). Every size and what fits where:
- [docs/MODELS.md](docs/MODELS.md).
+ **Unsloth:** UD-Q4_K_XL, UD-Q6_K_XL, Q8_0. These are the currently documented packs for this model.
- ### DeepSeek V4.1-Flash (Terminal, from 0.2.4)
+ [Model guide and compatibility](docs/QWEN36.md).
- A much bigger model that runs on one 12 GB graphics card with 46 to 64 GB of RAM. Strata keeps the busiest parts in memory and
- reads the rest from your SSD. [ISTA-DASLab](https://huggingface.co/ISTA-DASLab/DeepSeek-V4.1-Flash-1017-GSQ-RCO-GGUF)
- made the sets. It runs on NVIDIA RTX 30, 40 and 50 cards and the Radeon AI PRO R9700. Pick it in `strata launch`; the desktop
- app does not offer it yet.
+ </details>
- | Set | Download | Quality | Writes code at |
- | --- | ---: | --- | --- |
- | **IQ1_M** (1.75 bits) | 239 GB | The smallest; weaker on plain prose | not measured on a PC yet |
- | **IQ2_XXS** (2.00 bits) | 257 GB | Good balance | 10 tokens/s (RTX 3060), 5 (RTX 5070), 48 (4x R9700) |
- | **IQ2_XS** (2.25 bits) | 274 GB | Closest to the original | 15 tokens/s (one R9700), 80 (4x R9700) |
- | **IQ4_NL** (Engram table) | in every download above | The lookup table all three sets share | |
+ <a id="the-other-sizes"></a>
- Start it with `strata launch --model ist-das-2.00bpw` (or `ist-das-1.75bpw`, `ist-das-2.25bpw`). Quality numbers, speeds
- per PC and the manual install: [docs/DEEPSEEK41.md](docs/DEEPSEEK41.md).
+ Not sure what fits? [Choose a model for your computer](docs/MODELS.md#pick-by-memory).
- ## How fast is it?
+ ## Install
- Based on a 12 GB graphics card (RTX 5070, 64 GB RAM). Results from other cards:
- [speed of each model](docs/MODELS.md#how-fast-is-each-size) and [community results](docs/COMMUNITY_BENCHMARKS.md).
+ <a id="option-a-the-strata-app"></a>
- | Model | Answers appear at | Reads your prompt at |
- | --- | --- | --- |
- | **Q2_0** | `████████████` 94 tokens/s | `████████████` 2,650 tokens/s |
- | **IQ2_XS** | `██████████░░` 79 tokens/s | `█████████░░░` 2,090 tokens/s |
- | **IQ3_XXS** | `████████░░░░` 62 tokens/s | `████████░░░░` 1,750 tokens/s |
- | **IQ3_S** | `███████░░░░░` 53 tokens/s | `███████░░░░░` 1,620 tokens/s |
- | **Coder** | `███████░░░░░` 55 tokens/s | `██████████░░` 2,180 tokens/s |
+ ### Desktop app
- On a 16 GB AMD card (RX 9070 XT, 47 GB RAM):
+ **[Download Strata for Windows, Linux or Mac →](https://github.com/Niko1221/Strata/releases/latest)**
- | Model | Answers appear at | Reads your prompt at |
- | --- | --- | --- |
- | **Q2_0** | `████████░░░░` 60 tokens/s | `█████░░░░░░░` 1,160 tokens/s |
- | **IQ2_XS** | `███████░░░░░` 52 tokens/s | `█████░░░░░░░` 1,110 tokens/s |
- | **Coder** | `██████░░░░░░` 44 tokens/s | `██████░░░░░░` 1,420 tokens/s |
+ Install the app, choose a model, and start chatting. There is one installer for each system. On first start the app
+ downloads the engine for your graphics card. [Help with the installer](docs/INSTALL.md#the-app).
- A token is about ¾ of a word, so 60 tokens per second is faster than you can read. "Reads your prompt" is how fast Strata
- takes in a long document, code or chat history.
-<sub>Files: `Strata-0.2.5-windows-x64-setup.exe` · `Strata-0.2.5-linux-x86_64.AppImage` · `Strata-0.2.5-macos-arm64.dmg`</sub>
++<sub>Files: `Strata-0.2.6-windows-x64-setup.exe` · `Strata-0.2.6-linux-x86_64.AppImage` · `Strata-0.2.6-macos-arm64.dmg`</sub>
- ## Using it
+ <p align="center">
+ <img src="docs/media/app-chat.png" width="900" alt="Strata desktop app with a chat and live code preview side by side">
+ <br><sub>Chat, files and a live preview in one window.</sub>
+ </p>
- ### In the app
+ <a id="option-b-the-terminal-one-line"></a>
- Chat, a **Monitor** of the model and your GPU, CPU and RAM, a **Models** page and **Settings**. The chat can work in a
- folder on your PC. In **Manual** mode it asks before it changes a file or runs a command. It can search the web
- (DuckDuckGo or Bing, no account); the search words are the one thing that leaves your PC.
+ ### Terminal app
- <p align="center"><img src="docs/media/app-chat.png" width="900" alt="The Strata app: a chat where the agent built a small voxel pagoda garden, with the page open in the preview on the right"><br>
- <sub>The agent wrote a voxel pagoda garden as one HTML file, and the page opens in the preview next to the chat</sub></p>
+ Prefer the terminal? Install Strata, then run **`strata launch`**.
- ### In the Terminal
+ <details open>
+ <summary><b>Install commands</b></summary>
- <p align="center"><img src="docs/media/terminal-monitor.png" width="900" alt="The Strata Terminal monitor overview while the model writes a reply"><br>
- <sub><code>strata monitor</code> while the model writes a reply: speed, GPU, memory and the recent requests</sub></p>
+ **Linux / Mac**
```sh
- strata launch # guided: model, context, pictures, access, then serve
- strata launch --model q2_0 --yes --no-tui # no questions: serve and print the address
- strata launch --status # what is being served now
- strata launch --stop # stop it
- strata monitor # watch speed, GPU, memory and requests
- strata update # get the newest engine
- strata doctor # check the installed files
+ curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh -o install.sh && sh install.sh
```
- To reach Strata from your phone or another PC, use `strata launch --access lan`. It makes an API key for you.
- `strata --help` lists everything, and [docs/TERMINAL.md](docs/TERMINAL.md) explains it.
-
- ### With AI agents and other apps
-
- An agent installs Strata with the one-line command above and runs `strata launch --model NAME --yes --no-tui`. Steps,
- flags and exit codes: [docs/AI_SETUP.md](docs/AI_SETUP.md). Repository rules for agents: [AGENTS.md](AGENTS.md).
-
- | Your app speaks | Base URL |
- | --- | --- |
- | OpenAI API (most apps and agents) | `http://127.0.0.1:8080/v1` (any API key, any model name) |
- | Anthropic API (Claude Code) | `http://127.0.0.1:8080`, without `/v1`. Claude Code: `ANTHROPIC_BASE_URL=http://127.0.0.1:8080` |
- | OpenAI Responses API (Codex CLI) | `http://127.0.0.1:8080/v1/responses` ([setup](docs/DETAILS.md#the-responses-api-and-codex-cli)) |
-
- `strata connect` prints the exact settings for OpenCode, Codex CLI, Claude Code, oh-my-pi, pi, Hermes Agent and OpenClaw,
- and `strata connect opencode --write` writes them for you (with a backup).
-
- ### Good to know
-
- - **Pictures** are on for every model that can read them. Attach or paste one in the chat, or send it from your app. Details: [docs/IMAGES.md](docs/IMAGES.md).
- - **Thinking** can be off, low, medium or high, in the chat menu or your app's "reasoning effort". Off is fastest.
- - **The first message** of a chat is read in full, about 1 minute per 30,000 tokens. Follow-ups start in seconds.
- - **One request at a time** by default. For more, use `--parallel N` ([BATCHING.md](docs/BATCHING.md)). On a 12 GB card each answer gets slower.
+ **Windows PowerShell**
- ## Build from source
-
- <details>
- <summary>Windows, Linux and Mac from the repository</summary>
-
- [Download Strata](https://github.com/Niko1221/Strata/archive/refs/heads/main.zip) and unzip it, or `git clone` it.
- **Windows:** double-click `START-HERE.bat`. **Linux:** run `./setup.sh` in the Strata folder.
-
- **Mac (Apple Silicon, macOS 15 or newer):** install Apple's Command Line Tools once with `xcode-select --install`
- (Xcode itself is not needed). Open Terminal in the Strata folder and run `./setup.sh`. It builds the Mac engine on your
- Mac (about 7 minutes), asks the same questions, downloads the model and starts it. Next time, `./setup.sh` starts it
- right away. Which size fits your Mac: [docs/MAC.md](docs/MAC.md).
-
- The installer finds your card and sets up the right engine. It asks which model and size, how much context (how much text
- the model keeps in mind) and whether it should read pictures. Press Enter for the recommended answer. Then it downloads the
- model (about 70 GB) and starts it. If the download stops, run it again and it continues. Your browser opens the Strata
- page at `http://127.0.0.1:8080`.
-
- > While the model starts, your PC can be slow or stop responding for 1-3 minutes (longest the first time). Strata loads
- > 35-55 GB into your RAM and locks part of it for the graphics card. Wait, and don't close the window.
-
- Next time, run `START-HERE.bat` (or `./setup.sh`) again. It starts right away and downloads nothing twice. Close its
- window to stop the model. `UPDATE.bat` (`./update.sh`) updates Strata without starting it. Updating, Docker, several cards,
- where the files go and every option: [docs/INSTALL.md](docs/INSTALL.md).
-
- To measure your PC, run `BENCH.bat` (`./bench.sh`). It takes 5-10 minutes and writes a report you can share
- ([how](docs/COMMUNITY_BENCHMARKS.md#run-the-benchmark)).
-
- **Optional: more speed on one card when the whole model fits in RAM.** Two opt-in settings by RubenTorney (#1904, #1905).
- They help when you run one graphics card and your RAM holds every expert, for example Q2_0 or IQ3_XXS on a 64 GB PC. Open
- `strata-<model>.json` in the Strata data folder ([where](docs/INSTALL.md#where-things-are-stored)) and add:
+ ```powershell
+ irm https://github.com/Niko1221/Strata/releases/latest/download/install.ps1 | iex
+ ```
- - `"--adapt-async", "1"` to the `"args"` list. The expert cache then updates on a helper thread instead of pausing the
- answer. Measured on an RTX 5070 (Windows, Q2_0): +4-5% decode, +7-10% on code and long documents. Answers can differ
- slightly from the default and stay the same from run to run.
- - `"STRATA_PIN_BY_NEED": "1"` in the `"env"` block (Windows). Windows can lock only about half the RAM for the graphics
- card, and this locks the experts the card needs first. Measured on the RTX 5070: +4.4% prompt reading.
+ On Windows, open a new terminal afterwards. Then:
- ```json
- "args": [ ..., "--adapt-async", "1" ],
- "env": { "STRATA_PIN_BY_NEED": "1" }
+ ```sh
+ strata launch
```
- Restart Strata after the change. To undo, remove the two entries.
+ Follow the prompts to download and start a model. [Terminal guide](docs/TERMINAL_LAUNCH.md).
</details>
diff --cc README.pt-BR.md
index f4561c826,7a50e91c3..a6a673c4b
--- a/README.pt-BR.md
+++ b/README.pt-BR.md
@@@ -5,296 -5,131 +5,131 @@@
</picture>
</p>
- <p align="center"><a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <a href="README.es.md">Español</a> · <b>Português</b></p>
-
- <h3 align="center">Rode um modelo de ponta no seu próprio PC gamer</h3>
-
- <p align="center">Suporte a NVIDIA, AMD, Intel · Windows, Linux, Mac · gratuito e de código aberto</p>
+ <h3 align="center">IA poderosa no seu próprio computador.</h3>
+ <p align="center">Converse, programe e trabalhe com imagens, localmente.</p>
<p align="center">
- <a href="https://github.com/Niko1221/Strata/releases/latest"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?include_prereleases&label=release" alt="Última versão"></a>
- <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="Licença MIT"></a>
- <a href="https://github.com/Niko1221/Strata/stargazers"><img src="https://img.shields.io/github/stars/Niko1221/Strata?style=flat" alt="Estrelas no GitHub"></a>
- <a href="https://buymeacoffee.com/strataengine"><img src="https://img.shields.io/badge/Buy%20me%20a%20coffee-FFDD00?logo=buymeacoffee&logoColor=black" alt="Me pague um café"></a>
+ <a href="#modelos">Modelos</a> · <a href="#instalação"><b>Instalação</b></a> ·
+ <a href="#hardware">Hardware</a> · <a href="#ferramentas">Ferramentas</a> ·
+ <a href="#ajuda">Ajuda</a> · <a href="#apoie-o-strata">Apoiar</a>
</p>
- <p align="center"><a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4"><img src="docs/media/pagoda-preview.webp" width="720" alt="Um jardim de pagodes em voxels que o modelo do Strata escreveu, rodando no navegador"></a><br>
- <sub>Um jardim de pagodes em voxels, gerado com um único prompt, rodando numa RTX 5070 com o Strata (IQ3_S, contexto de 128K) ·
- <a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4">vídeo completo (49 s)</a></sub></p>
-
<p align="center">
- <a href="#instalação"><b>Instalação</b></a> ·
- <a href="#modelos">Modelos</a> ·
- <a href="#qual-é-a-velocidade">Velocidade</a> ·
- <a href="#como-usar">Como usar</a> ·
- <a href="#como-funciona">Como funciona</a> ·
- <a href="#algo-deu-errado">Ajuda</a> ·
- <a href="#apoie-o-strata">Apoiar</a>
+ <a href="https://github.com/Niko1221/Strata/releases/latest"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?label=download&color=0ab887" alt="Baixar o Strata"></a>
+ <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="Licença MIT"></a>
+ <a href="https://buymeacoffee.com/strataengine"><img src="https://img.shields.io/badge/Buy_me_a_coffee-FFDD00?logo=buymeacoffee&logoColor=000" alt="Apoie o Strata no Buy Me a Coffee"></a>
</p>
- O Strata roda o **[Qwen3.8-Flash-Next](https://huggingface.co/Qwen/Qwen3.8-Flash-Next)**, um modelo de 125 bilhões de parâmetros que
- normalmente precisa de um servidor, num PC comum. A partir da 0.2.4 ele também roda o **DeepSeek V4.1-Flash** no Terminal. Ele
- conversa, escreve código, lê imagens e funciona com os seus aplicativos e agentes de programação. Suas conversas e arquivos
- ficam no seu PC.
-
- - **Roda num PC gamer.** 32 GB somando memória RAM e memória da placa de vídeo já bastam para começar.
- - **Funciona com as suas ferramentas.** Claude Code, Codex CLI, OpenCode e outros agentes se conectam pelas APIs da OpenAI e da Anthropic.
- - **Lê imagens**, ativado por padrão.
- - **Gratuito e privado.** Licença MIT, sem conta, sem nuvem, sem telemetria ([o que ele baixa e quando](docs/SAFETY.md)).
-
- ## O que você precisa
-
- **Você precisa de pelo menos 32 GB de memória: RAM e memória da placa de vídeo (VRAM) somadas.** Num Mac ou num Ryzen AI Max, isso é a
- memória unificada. Um PC de 32 GB com uma placa de 12 a 16 GB roda os tamanhos menores, e 64 GB rodam todos os tamanhos.
-
- | Funciona em | Guia |
- | --- | --- |
- | **NVIDIA** GeForce RTX série 20, 30, 40 e 50, 12 GB ou mais | [Instalação](#instalação) |
- | **AMD** Radeon RX 6800 e mais novas, Radeon AI PRO R9700 | [Placas AMD](docs/AMD_HIP.md) |
- | **Intel** Arc | [Intel Arc](docs/INTEL_ARC.md) |
- | **Mac com Apple Silicon**, M1 ou mais novo, macOS 15 ou mais novo | [Mac](docs/MAC.md) |
- | **AMD Ryzen AI Max (Strix Halo)** e outros PCs de memória unificada | [Strix Halo](docs/STRIX_HALO.md) |
- | Placas e processadores mais antigos | [GPUs antigas](docs/OLDER_GPUS.md) |
-
- Você também precisa de cerca de 80 GB de espaço livre no disco (um SSD), Windows 10 / 11, Linux ou macOS, e um driver de vídeo
- atualizado. Duas ou três placas da mesma marca podem dividir um modelo ([multi-GPU](docs/MULTI_GPU.md)).
-
- ## Instalação
-
- ### 1. O app Strata (o mais fácil)
-
- Baixe o arquivo para o seu computador, abra e clique em instalar no modelo que ele recomenda.
-
- **Windows 10 / 11**
-
- [![Windows](https://img.shields.io/badge/Windows-10%20%2F%2011-0078D4?style=for-the-badge&logo=windows&logoColor=white)](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.5-windows-x64-setup.exe)
-
- **Linux**
-
- [![Linux](https://img.shields.io/badge/Linux-AppImage-FCC624?style=for-the-badge&logo=linux&logoColor=black)](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.5-linux-x86_64.AppImage)
-
- **Mac** (Apple Silicon, macOS 15 ou mais novo)
+ <p align="center"><sub><a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <a href="README.es.md">Español</a> · <b>Português</b></sub></p>
- [![Mac, Apple Silicon](https://img.shields.io/badge/Mac-Apple%20Silicon-333333?style=for-the-badge&logo=apple&logoColor=white)](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.5-macos-arm64.dmg)
+ **Gratuito, de código aberto e seu para executar.** Use o Strata no desktop ou com suas ferramentas de programação favoritas. Não precisa de conta.
- O aplicativo escolhe sozinho o mecanismo certo para a sua placa de vídeo. Todos os arquivos estão na
- [página de releases](https://github.com/Niko1221/Strata/releases/latest).
-
- | Primeira inicialização | O que fazer |
- | --- | --- |
- | **Windows** | Execute o `.exe`. Não precisa de direitos de administrador. Se o Windows disser "O Windows protegeu o computador", escolha **Mais informações** e depois **Executar assim mesmo**. |
- | **Linux** | Torne o arquivo executável (`chmod +x`) e inicie. É preciso ter o FUSE 2: `sudo apt install libfuse2t64` (Ubuntu 24.04 e mais novos) ou `libfuse2` (22.04). |
- | **Mac** | Abra o `.dmg` e arraste o Strata para Aplicativos. |
-
- O download do modelo é grande (40 a 70 GB). Se parar, continua de onde parou.
-
- ### 2. O Terminal (uma linha)
-
- O comando `strata`, para scripts, servidores e agentes de IA. É também o jeito de rodar o DeepSeek.
+ ## Modelos
- Linux e Mac:
+ Recomendamos **primeiro a ISTA-DASLab**, depois a **Unsloth** e outros provedores, quando um modelo compatível cabe na memória.
- ```sh
- curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh -o install.sh && sh install.sh
- ```
+ <details>
+ <summary><img src="docs/media/models/deepseek.svg" width="22" alt="" align="middle"> &nbsp;<b>DeepSeekV4.1-Flash-1017</b></summary>
- Windows (PowerShell):
+ No **aplicativo de desktop** e no **Terminal**. O que não cabe na memória é lido do seu SSD, por isso é preciso muito espaço livre em disco.
- ```powershell
- irm https://github.com/Niko1221/Strata/releases/latest/download/install.ps1 | iex
- ```
+ | Conjunto (IST-DAS) | Download | Espaço livre necessário |
+ | --- | ---: | ---: |
+ | 1.75 bpw | 239 GB | cerca de 245 GB |
+ | 2.00 bpw | 257 GB | cerca de 265 GB |
+ | 2.25 bpw | 274 GB | cerca de 280 GB |
- Depois inicie. Ele faz uma pergunta por vez (modelo, contexto, imagens, quem pode se conectar), baixa o que precisa e começa
- a servir:
+ Roda em NVIDIA RTX 30, 40 e 50 (Windows e Linux) e em AMD Radeon AI PRO R9700 (Linux). A instalação baixa os arquivos e o motor do DeepSeek e depois inicia o modelo.
```sh
- strata launch
- ```
-
- Não precisa de direitos de administrador. A instalação confere o SHA-256 de tudo que baixa. No Windows, abra uma nova janela do
- terminal depois da instalação. Todas as telas e flags: [docs/TERMINAL_LAUNCH.md](docs/TERMINAL_LAUNCH.md).
-
- ### 3. Deixe a sua IA configurar
-
- Cole isto no Claude Code, Cursor, Codex, GitHub Copilot ou outro assistente de programação:
-
- ```text
- Set up Strata on this PC for me: https://github.com/Niko1221/Strata - follow docs/AI_SETUP.md in that repository.
+ strata launch --family deepseek41 --model ist-das-2.00bpw --plan
```
- Ele confere a sua placa de vídeo, a RAM e o disco, escolhe o modelo que cabe, instala e inicia, e diz como conectar os seus
- aplicativos. Ferramentas de IA também podem instalar, iniciar e parar o Strata pelo [servidor MCP](docs/MCP_SERVER.md) dele.
+ Medido com o conjunto de 2.00 bpw no Strata 0.2.5. “Saída” é a velocidade da resposta; “Prompt” é a rapidez com que o Strata lê o seu texto.
- Prefere compilar por conta própria? Veja [Compilar a partir do código-fonte](#compilar-a-partir-do-código-fonte).
+ | Hardware | Saída | Prompt |
+ | --- | ---: | ---: |
+ | RTX 5070 12 GB, 64 GB de RAM | 4 a 6 tokens/s | cerca de 110 tokens/s (4K) |
+ | RTX 3060 12 GB, 46 GB de RAM | 9 a 11 tokens/s | cerca de 155 tokens/s (4K) |
+ | 1x Radeon AI PRO R9700, 251 GB de RAM | 21 a 25 tokens/s | 320 a 360 tokens/s (8K) |
+ | 4x Radeon AI PRO R9700 | 74 a 77 tokens/s | 400 a 450 tokens/s (8K) |
- ## Modelos
+ [Memória, disco e detalhes](docs/DEEPSEEK41.md) · [Notas da versão](https://github.com/Niko1221/Strata/releases)
- O app e o `strata launch` recomendam um tamanho para a sua memória. Os tamanhos menores são mais rápidos. Os maiores são um
- pouco mais inteligentes.
-
- ### Pouca memória? Experimente o Gyro
+ </details>
- O [Gyro](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF), da agentionai, é a menor forma de rodar o
- Qwen3.8-Flash-Next. Ele roda em NVIDIA, AMD, Intel Arc e Apple Silicon.
+ <details>
+ <summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.8-Flash-Next</b></summary>
- | Tamanho | Memória necessária (RAM + VRAM) | Download | Serve para |
- | --- | ---: | ---: | --- |
- | **Gyro-S** | 27,6 GB | 58,5 GB | PCs onde nenhum outro tamanho cabe. 9 tokens/s num Mac mini de 32 GB. |
- | **Gyro-M** | 35 GB | 92,0 GB | Qualidade próxima à do IQ3_XXS, com 20% menos memória da GPU. |
+ | Provedor | Opções |
+ | --- | --- |
+ | **ISTA-DASLab · recomendado** | Q2\_0, IQ2\_XS, IQ3\_XXS, IQ3\_S. [Coder: IQ1\_M](docs/MODELS.md#coder) para programar. |
+ | **Unsloth** | UD-IQ4\_XS, UD-Q4\_K\_XL, UD-Q5\_K\_XL, UD-Q6\_K\_XL, Q8\_0 |
+ | **Gyro · agentionai** | [Gyro-S, Gyro-M](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF). Usa menos memória, mas é mais lento. |
+ | **Outras opções** | [Swift 1.5](docs/MODELS.md#swift-15), [NVFP4](docs/NVFP4.md), [OrcaRouter](docs/ORCA.md) |
- Inicie com `strata launch --model gyro-s`. Detalhes: [docs/GYRO.md](docs/GYRO.md).
+ [Compare tamanhos, necessidades de memória e compatibilidade](docs/MODELS.md).
- ### Os tamanhos do Qwen3.8-Flash-Next
+ </details>
- | Sua memória (RAM + VRAM) | Escolha | Por quê |
- | --- | --- | --- |
- | **32 GB** | **Gyro-S**, ou o **[Coder](docs/MODELS.md#coder)** para código | O Coder mantém os experts que o código usa |
- | **40 GB** | **[Swift 1.5](docs/MODELS.md#swift-15)** IQ2_XS (39,2 GB) ou **Gyro-M** | O Swift pensa por menos tempo antes de responder |
- | **48 GB** | **IQ3_XXS** (47,0 GB) | Mais lento, melhor |
- | **64 GB** | **IQ3_S** (54,8 GB) | Empata com o modelo completo nos testes publicados |
- | **96 GB ou mais** | **UD-IQ4_XS** a **Q8_0** da Unsloth | O mais perto do modelo completo |
+ <details>
+ <summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.6-35B-A3B</b></summary>
- Com menos RAM do que a linha indica, ainda pode funcionar, só que mais devagar: o Strata muda sozinho para o
- [modo de pouca RAM](docs/MODELS.md#a-big-graphics-card-and-little-ram). Há também:
- [NVFP4](docs/NVFP4.md) para placas NVIDIA, [Qwen3.6-35B-A3B](docs/QWEN36.md) (menor, vários pedidos ao mesmo tempo) e
- [o Uncensored IQ3_XXS da OrcaRouter](docs/MODELS.md#orcarouter-uncensored-iq3_xxs). Todos os tamanhos e o que cabe em cada configuração:
- [docs/MODELS.md](docs/MODELS.md).
+ **Unsloth:** UD-Q4_K_XL, UD-Q6_K_XL, Q8_0. Esses são os pacotes documentados atualmente para este modelo.
- ### DeepSeek V4.1-Flash (Terminal, a partir da 0.2.4)
+ [Guia do modelo e compatibilidade](docs/QWEN36.md).
- Um modelo bem maior, que roda numa única placa de vídeo de 12 GB com 46 a 64 GB de RAM. O Strata mantém na memória as partes mais
- usadas e lê o resto do seu SSD. A [ISTA-DASLab](https://huggingface.co/ISTA-DASLab/DeepSeek-V4.1-Flash-1017-GSQ-RCO-GGUF)
- fez os conjuntos. Ele roda em placas NVIDIA RTX das séries 30, 40 e 50 e na Radeon AI PRO R9700. Escolha no `strata launch`. O
- app de desktop ainda não o oferece.
+ </details>
- | Conjunto | Download | Qualidade | Escreve código a |
- | --- | ---: | --- | --- |
- | **IQ1_M** (1,75 bits) | 239 GB | O menor, mais fraco em prosa simples | ainda não medido num PC |
- | **IQ2_XXS** (2.00 bits) | 257 GB | Bom equilíbrio | 10 tokens/s (RTX 3060), 5 (RTX 5070), 48 (4x R9700) |
- | **IQ2_XS** (2.25 bits) | 274 GB | O mais perto do original | 15 tokens/s (uma R9700), 80 (4x R9700) |
- | **IQ4_NL** (tabela Engram) | incluída em cada download acima | A tabela de consulta que os três conjuntos compartilham | |
+ <a id="the-other-sizes"></a>
- Inicie com `strata launch --model ist-das-2.00bpw` (ou `ist-das-1.75bpw`, `ist-das-2.25bpw`). Números de qualidade,
- velocidades por PC e a instalação manual: [docs/DEEPSEEK41.md](docs/DEEPSEEK41.md).
+ Não sabe o que cabe? [Escolha um modelo para o seu computador](docs/MODELS.md#pick-by-memory).
- ## Qual é a velocidade?
+ ## Instalação
- Com base numa placa de vídeo de 12 GB (RTX 5070, 64 GB de RAM). Veja resultados de outras placas:
- [velocidade de cada tamanho](docs/MODELS.md#how-fast-is-each-size) e [resultados da comunidade](docs/COMMUNITY_BENCHMARKS.md).
+ <a id="option-a-the-strata-app"></a>
- | Modelo | As respostas aparecem a | Lê o seu prompt a |
- | --- | --- | --- |
- | **Q2_0** | `████████████` 94 tokens/s | `████████████` 2.650 tokens/s |
- | **IQ2_XS** | `██████████░░` 79 tokens/s | `█████████░░░` 2.090 tokens/s |
- | **IQ3_XXS** | `████████░░░░` 62 tokens/s | `████████░░░░` 1.750 tokens/s |
- | **IQ3_S** | `███████░░░░░` 53 tokens/s | `███████░░░░░` 1.620 tokens/s |
- | **Coder** | `███████░░░░░` 55 tokens/s | `██████████░░` 2.180 tokens/s |
+ ### Aplicativo de desktop
- Numa placa AMD de 16 GB (RX 9070 XT, 47 GB de RAM):
+ **[Baixar o Strata para Windows, Linux ou Mac →](https://github.com/Niko1221/Strata/releases/latest)**
- | Modelo | As respostas aparecem a | Lê o seu prompt a |
- | --- | --- | --- |
- | **Q2_0** | `████████░░░░` 60 tokens/s | `█████░░░░░░░` 1.160 tokens/s |
- | **IQ2_XS** | `███████░░░░░` 52 tokens/s | `█████░░░░░░░` 1.110 tokens/s |
- | **Coder** | `██████░░░░░░` 44 tokens/s | `██████░░░░░░` 1.420 tokens/s |
+ Instale o aplicativo, escolha um modelo e comece a conversar. Há um instalador por sistema. Na primeira vez que abre, o aplicativo baixa o motor da sua placa de vídeo. [Ajuda com o instalador](docs/INSTALL.md#the-app).
- Um token equivale a cerca de ¾ de palavra, então 60 tokens por segundo é mais rápido do que você lê. "Lê o seu prompt" é a velocidade com que o Strata
- absorve um documento longo, um código ou um histórico de conversa.
-<sub>Arquivos: `Strata-0.2.5-windows-x64-setup.exe` · `Strata-0.2.5-linux-x86_64.AppImage` · `Strata-0.2.5-macos-arm64.dmg`</sub>
++<sub>Arquivos: `Strata-0.2.6-windows-x64-setup.exe` · `Strata-0.2.6-linux-x86_64.AppImage` · `Strata-0.2.6-macos-arm64.dmg`</sub>
- ## Como usar
+ <p align="center">
+ <img src="docs/media/app-chat.png" width="900" alt="Aplicativo de desktop do Strata com um chat e uma prévia do código ao vivo lado a lado">
+ <br><sub>Chat, arquivos e prévia ao vivo em uma só janela.</sub>
+ </p>
- ### No app
+ <a id="option-b-the-terminal-one-line"></a>
- Um chat, um **Monitor** do modelo e da sua GPU, CPU e RAM, uma página de **Modelos** e as **Configurações**. O chat pode
- trabalhar numa pasta do seu PC. No modo **Manual**, ele pergunta antes de alterar um arquivo ou executar um comando. Ele pode
- pesquisar na web (DuckDuckGo ou Bing, sem conta). Os termos da pesquisa são a única coisa que sai do seu PC.
+ ### Aplicativo de Terminal
- <p align="center"><img src="docs/media/app-chat.png" width="900" alt="O app Strata: um chat em que o agente montou um pequeno jardim de pagodes em voxels, com a página aberta na pré-visualização à direita"><br>
- <sub>O agente escreveu um jardim de pagodes em voxels em um único arquivo HTML, e a página abre na pré-visualização ao lado do chat</sub></p>
+ Prefere o terminal? Instale o Strata e execute **`strata launch`**.
- ### No Terminal
+ <details open>
+ <summary><b>Comandos de instalação</b></summary>
- <p align="center"><img src="docs/media/terminal-monitor.png" width="900" alt="A visão geral do monitor do Terminal do Strata enquanto o modelo escreve uma resposta"><br>
- <sub><code>strata monitor</code> enquanto o modelo responde: velocidade, GPU, memória e as solicitações recentes</sub></p>
+ **Linux / Mac**
```sh
- strata launch # guided: model, context, pictures, access, then serve
- strata launch --model q2_0 --yes --no-tui # no questions: serve and print the address
- strata launch --status # what is being served now
- strata launch --stop # stop it
- strata monitor # watch speed, GPU, memory and requests
- strata update # get the newest engine
- strata doctor # check the installed files
+ curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh -o install.sh && sh install.sh
```
- Para acessar o Strata do celular ou de outro PC, use `strata launch --access lan`. Ele cria uma chave de API para você.
- `strata --help` lista tudo, e o [docs/TERMINAL.md](docs/TERMINAL.md) explica.
-
- ### Com agentes de IA e outros aplicativos
-
- Um agente instala o Strata com o comando de uma linha acima e executa `strata launch --model NAME --yes --no-tui`. Os passos,
- as flags e os códigos de saída estão em [docs/AI_SETUP.md](docs/AI_SETUP.md). As regras do repositório para agentes: [AGENTS.md](AGENTS.md).
-
- | Seu aplicativo fala | URL base |
- | --- | --- |
- | API da OpenAI (a maioria dos apps e agentes) | `http://127.0.0.1:8080/v1` (qualquer chave de API, qualquer nome de modelo) |
- | API da Anthropic (Claude Code) | `http://127.0.0.1:8080`, sem `/v1`. Claude Code: `ANTHROPIC_BASE_URL=http://127.0.0.1:8080` |
- | OpenAI Responses API (Codex CLI) | `http://127.0.0.1:8080/v1/responses` ([configuração](docs/DETAILS.md#the-responses-api-and-codex-cli)) |
-
- `strata connect` mostra as configurações exatas para OpenCode, Codex CLI, Claude Code, oh-my-pi, pi, Hermes Agent e OpenClaw,
- e `strata connect opencode --write` grava para você (com um backup).
-
- ### Bom saber
-
- - **As imagens** vêm ativadas em todo modelo que sabe lê-las. Anexe ou cole uma imagem no chat, ou envie pelo seu aplicativo. Detalhes: [docs/IMAGES.md](docs/IMAGES.md).
- - **O raciocínio** pode ser off, low, medium ou high, no menu do chat ou no "reasoning effort" do seu aplicativo. Off é o mais rápido.
- - **A primeira mensagem** de uma conversa é lida por inteiro, cerca de 1 minuto a cada 30.000 tokens. As mensagens seguintes começam em segundos.
- - **Um pedido por vez** é o padrão. Para mais de um, use `--parallel N` ([BATCHING.md](docs/BATCHING.md)). Numa placa de 12 GB, isso deixa cada resposta mais lenta.
+ **Windows PowerShell**
- ## Compilar a partir do código-fonte
-
- <details>
- <summary>Windows, Linux e Mac a partir do repositório</summary>
-
- [Baixe o Strata](https://github.com/Niko1221/Strata/archive/refs/heads/main.zip) e descompacte, ou use `git clone`.
- **Windows:** dê dois cliques em `START-HERE.bat`. **Linux:** execute `./setup.sh` na pasta do Strata.
-
- **Mac (Apple Silicon, macOS 15 ou mais novo):** instale uma vez as Command Line Tools da Apple com `xcode-select --install`
- (o Xcode em si não é necessário). Abra o Terminal na pasta do Strata e execute `./setup.sh`. Ele compila o mecanismo do Mac no seu
- Mac (cerca de 7 minutos), faz as mesmas perguntas, baixa o modelo e inicia. Da próxima vez, `./setup.sh` inicia
- na hora. Qual tamanho cabe no seu Mac: [docs/MAC.md](docs/MAC.md).
-
- O instalador encontra a sua placa e configura o mecanismo certo. Ele pergunta qual modelo e tamanho, quanto contexto (quanto texto
- o modelo mantém em mente) e se deve ler imagens. Pressione Enter para aceitar a resposta recomendada. Depois ele baixa o
- modelo (cerca de 70 GB) e inicia. Se o download parar, execute de novo e ele continua. O navegador abre a página do Strata em
- `http://127.0.0.1:8080`.
-
- > Enquanto o modelo inicia, o seu PC pode ficar lento ou parar de responder por 1 a 3 minutos (mais tempo na primeira vez). O Strata carrega
- > de 35 a 55 GB na sua RAM e trava parte dela para a placa de vídeo. Espere e não feche a janela.
-
- Da próxima vez, execute `START-HERE.bat` (ou `./setup.sh`) de novo. Ele inicia na hora e não baixa nada duas vezes. Feche a janela
- dele para parar o modelo. `UPDATE.bat` (`./update.sh`) atualiza o Strata sem iniciá-lo. Atualização, Docker, várias placas,
- onde ficam os arquivos e todas as opções: [docs/INSTALL.md](docs/INSTALL.md).
-
- Para medir o seu PC, execute `BENCH.bat` (`./bench.sh`). Leva de 5 a 10 minutos e gera um relatório que você pode compartilhar
- ([como](docs/COMMUNITY_BENCHMARKS.md#run-the-benchmark)).
-
- **Opcional: mais velocidade numa placa quando o modelo inteiro cabe na RAM.** Duas configurações opcionais do RubenTorney (#1904, #1905).
- Elas ajudam quando você usa uma placa de vídeo e a sua RAM comporta todos os experts, por exemplo Q2_0 ou IQ3_XXS num PC de 64 GB. Abra
- `strata-<model>.json` na pasta de dados do Strata ([onde fica](docs/INSTALL.md#where-things-are-stored)) e adicione:
+ ```powershell
+ irm https://github.com/Niko1221/Strata/releases/latest/download/install.ps1 | iex
+ ```
- - `"--adapt-async", "1"` à lista `"args"`. O cache de experts passa a ser atualizado numa thread auxiliar, em vez de pausar a
- resposta. Medido numa RTX 5070 (Windows, Q2_0): +4 a 5% na geração, +7 a 10% em código e documentos longos. As respostas podem diferir
- um pouco do padrão e continuam iguais de uma execução para outra.
- - `"STRATA_PIN_BY_NEED": "1"` no bloco `"env"` (Windows). O Windows só consegue travar cerca de metade da RAM para a placa
- de vídeo, e isso trava primeiro os experts de que a placa precisa. Medido na RTX 5070: +4,4% na leitura do prompt.
+ No Windows, abra um novo terminal depois. Em seguida:
- ```json
- "args": [ ..., "--adapt-async", "1" ],
- "env": { "STRATA_PIN_BY_NEED": "1" }
+ ```sh
+ strata launch
```
- Reinicie o Strata depois da alteração. Para desfazer, remova as duas entradas.
+ Siga as instruções para baixar e iniciar um modelo. [Guia do Terminal](docs/TERMINAL_LAUNCH.md).
</details>
diff --cc README.zh-CN.md
index f30000bcf,d1973037b..8d2e10c0c
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@@ -5,284 -5,131 +5,131 @@@
</picture>
</p>
- <p align="center"><a href="README.md">English</a> · <b>简体中文</b> · <a href="README.ja.md">日本語</a> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <a href="README.es.md">Español</a> · <a href="README.pt-BR.md">Português</a></p>
-
- <h3 align="center">在你自己的游戏电脑上运行最先进的模型</h3>
-
- <p align="center">支持 NVIDIA、AMD、Intel · Windows、Linux、Mac · 免费开源</p>
+ <h3 align="center">在你自己的电脑上运行强大的 AI。</h3>
+ <p align="center">本地聊天、写代码、处理图片。</p>
<p align="center">
- <a href="https://github.com/Niko1221/Strata/releases/latest"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?include_prereleases&label=release" alt="最新版本"></a>
- <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="MIT 许可证"></a>
- <a href="https://github.com/Niko1221/Strata/stargazers"><img src="https://img.shields.io/github/stars/Niko1221/Strata?style=flat" alt="GitHub 星标"></a>
- <a href="https://buymeacoffee.com/strataengine"><img src="https://img.shields.io/badge/Buy%20me%20a%20coffee-FFDD00?logo=buymeacoffee&logoColor=black" alt="请我喝杯咖啡"></a>
+ <a href="#模型">模型</a> · <a href="#安装"><b>安装</b></a> ·
+ <a href="#硬件">硬件</a> · <a href="#工具">工具</a> ·
+ <a href="#帮助">帮助</a> · <a href="#支持-strata">支持</a>
</p>
- <p align="center"><a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4"><img src="docs/media/pagoda-preview.webp" width="720" alt="Strata 的模型写出的体素宝塔花园,在浏览器里运行"></a><br>
- <sub>一座体素宝塔花园,由一条提示词一次生成,在装有 RTX 5070 的电脑上用 Strata 运行(IQ3_S,128K 上下文) ·
- <a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4">完整视频(49 秒)</a></sub></p>
-
<p align="center">
- <a href="#安装"><b>安装</b></a> ·
- <a href="#模型">模型</a> ·
- <a href="#速度如何">速度</a> ·
- <a href="#使用方法">使用方法</a> ·
- <a href="#工作原理">工作原理</a> ·
- <a href="#出问题了">帮助</a> ·
- <a href="#支持-strata">支持</a>
+ <a href="https://github.com/Niko1221/Strata/releases/latest"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?label=download&color=0ab887" alt="下载 Strata"></a>
+ <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="MIT 许可证"></a>
+ <a href="https://buymeacoffee.com/strataengine"><img src="https://img.shields.io/badge/Buy_me_a_coffee-FFDD00?logo=buymeacoffee&logoColor=000" alt="在 Buy Me a Coffee 上支持 Strata"></a>
</p>
- Strata 运行 **[Qwen3.8-Flash-Next](https://huggingface.co/Qwen/Qwen3.8-Flash-Next)**。这是一个 1250 亿参数的模型,
- 通常需要服务器才能跑,现在用普通电脑就行。从 0.2.4 起,它在终端版里也能运行 **DeepSeek V4.1-Flash**。它能聊天、写代码、
- 看图片,也能配合你的应用和编程智能体使用。你的聊天记录和文件都留在你自己的电脑上。
-
- - **游戏电脑就能跑。** 内存和显存加起来有 32 GB 就可以开始。
- - **能接入你的工具。** Claude Code、Codex CLI、OpenCode 等智能体通过 OpenAI 和 Anthropic 的 API 连接。
- - **能看图片**,默认开启。
- - **免费且隐私。** MIT 许可证,不用注册账号,不走云端,没有遥测([它下载什么、什么时候下载](docs/SAFETY.md))。
-
- ## 硬件要求
-
- **内存和显存(VRAM)加起来至少要有 32 GB。** Mac 和 Ryzen AI Max 上指的是统一内存。32 GB 内存加一张 12-16 GB 显存的显卡,
- 可以跑较小的尺寸;64 GB 可以跑所有尺寸。
-
- | 适用于 | 指南 |
- | --- | --- |
- | **NVIDIA** GeForce RTX 20、30、40 和 50 系列,12 GB 及以上 | [安装](#安装) |
- | **AMD** Radeon RX 6800 及更新型号、Radeon AI PRO R9700 | [AMD 显卡](docs/AMD_HIP.md) |
- | **Intel** Arc | [Intel Arc](docs/INTEL_ARC.md) |
- | **Apple 芯片 Mac**,M1 及更新,macOS 15 及以上 | [Mac](docs/MAC.md) |
- | **AMD Ryzen AI Max(Strix Halo)** 及其他统一内存的电脑 | [Strix Halo](docs/STRIX_HALO.md) |
- | 较旧的显卡和处理器 | [旧显卡](docs/OLDER_GPUS.md) |
-
- 你还需要约 80 GB 的可用磁盘空间(固态硬盘)、Windows 10 / 11、Linux 或 macOS,以及较新的显卡驱动。同一品牌的两三张显卡可以共同运行一个模型([多显卡](docs/MULTI_GPU.md))。
-
- ## 安装
-
- ### 1. Strata 应用(最简单)
-
- 下载适合你电脑的文件,打开它,然后对推荐的模型点击安装。
-
- **Windows 10 / 11**
-
- [![Windows](https://img.shields.io/badge/Windows-10%20%2F%2011-0078D4?style=for-the-badge&logo=windows&logoColor=white)](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.5-windows-x64-setup.exe)
-
- **Linux**
-
- [![Linux](https://img.shields.io/badge/Linux-AppImage-FCC624?style=for-the-badge&logo=linux&logoColor=black)](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.5-linux-x86_64.AppImage)
-
- **Mac**(Apple 芯片,macOS 15 及以上)
+ <p align="center"><sub><a href="README.md">English</a> · <b>简体中文</b> · <a href="README.ja.md">日本語</a> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <a href="README.es.md">Español</a> · <a href="README.pt-BR.md">Português</a></sub></p>
- [![Mac,Apple 芯片](https://img.shields.io/badge/Mac-Apple%20Silicon-333333?style=for-the-badge&logo=apple&logoColor=white)](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.5-macos-arm64.dmg)
+ **免费、开源,由你自己运行。** 在桌面上使用 Strata,或搭配你喜欢的编程工具。无需账号。
- 应用会自己为你的显卡选择合适的引擎。所有文件都在[发布页](https://github.com/Niko1221/Strata/releases/latest)。
-
- | 首次启动 | 怎么做 |
- | --- | --- |
- | **Windows** | 运行 `.exe`。不需要管理员权限。如果 Windows 提示“Windows 已保护你的电脑”,点击**更多信息**,再点**仍要运行**。 |
- | **Linux** | 给文件加上可执行权限(`chmod +x`),然后启动。需要 FUSE 2:`sudo apt install libfuse2t64`(Ubuntu 24.04 及更新)或 `libfuse2`(22.04)。 |
- | **Mac** | 打开 `.dmg`,把 Strata 拖到“应用程序”。 |
-
- 模型下载很大(40-70 GB)。如果中断,会从断点继续。
-
- ### 2. 终端版(一行命令)
-
- `strata` 命令,适合脚本、服务器和 AI 智能体。运行 DeepSeek 也要用它。
+ ## 模型
- Linux 和 Mac:
+ 我们**首先推荐 ISTA-DASLab**,其次是 **Unsloth** 和其他提供方,前提是有内存放得下的兼容模型。
- ```sh
- curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh -o install.sh && sh install.sh
- ```
+ <details>
+ <summary><img src="docs/media/models/deepseek.svg" width="22" alt="" align="middle"> &nbsp;<b>DeepSeekV4.1-Flash-1017</b></summary>
- Windows(PowerShell):
+ 可在**桌面应用**和**终端**中使用。内存放不下的部分会从 SSD 读取,所以需要大量空闲磁盘空间。
- ```powershell
- irm https://github.com/Niko1221/Strata/releases/latest/download/install.ps1 | iex
- ```
+ | 版本(IST-DAS) | 下载大小 | 所需空闲磁盘 |
+ | --- | ---: | ---: |
+ | 1.75 bpw | 239 GB | 约245 GB |
+ | 2.00 bpw | 257 GB | 约265 GB |
+ | 2.25 bpw | 274 GB | 约280 GB |
- 然后启动它。它会一次问一个问题(模型、上下文、图片、允许谁连接),下载需要的东西,并开始提供服务:
+ 支持 NVIDIA RTX 30、40 和 50 系列(Windows 和 Linux),以及 AMD Radeon AI PRO R9700(Linux)。安装程序会下载模型文件和 DeepSeek 引擎,然后启动模型。
```sh
- strata launch
- ```
-
- 不需要管理员权限。安装程序会校验它下载的所有内容的 SHA-256。在 Windows 上,装完后请打开一个新的终端窗口。
- 所有界面和参数见 [docs/TERMINAL_LAUNCH.md](docs/TERMINAL_LAUNCH.md)。
-
- ### 3. 让你的 AI 来安装
-
- 把下面这段话粘贴到 Claude Code、Cursor、Codex、GitHub Copilot 或其他编程助手里:
-
- ```text
- Set up Strata on this PC for me: https://github.com/Niko1221/Strata - follow docs/AI_SETUP.md in that repository.
+ strata launch --family deepseek41 --model ist-das-2.00bpw --plan
```
- 它会检查你的显卡、内存和磁盘,选出合适的模型,完成安装和启动,并告诉你怎么连接你的应用。AI 工具也可以通过 Strata 的
- [MCP 服务器](docs/MCP_SERVER.md)安装、启动和停止 Strata。
+ 以下为 Strata 0.2.5 上 2.00 bpw 版本的实测结果。“输出”是回答的速度,“提示词”是 Strata 读取你输入内容的速度。
- 想自己动手编译?请看[从源码构建](#从源码构建)。
+ | 硬件 | 输出 | 提示词 |
+ | --- | ---: | ---: |
+ | RTX 5070 12 GB, 64 GB 内存 | 4 到 6 tokens/s | 约 110 tokens/s(4K) |
+ | RTX 3060 12 GB, 46 GB 内存 | 9 到 11 tokens/s | 约 155 tokens/s(4K) |
+ | 1x Radeon AI PRO R9700, 251 GB 内存 | 21 到 25 tokens/s | 320 到 360 tokens/s (8K) |
+ | 4x Radeon AI PRO R9700 | 74 到 77 tokens/s | 400 到 450 tokens/s (8K) |
- ## 模型
+ [内存、磁盘和详细信息](docs/DEEPSEEK41.md) · [发行说明](https://github.com/Niko1221/Strata/releases)
- 应用和 `strata launch` 会按你的内存推荐尺寸。尺寸小的更快,尺寸大的稍微更聪明一点。
-
- ### 内存不够?试试 Gyro
+ </details>
- [Gyro](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF)(作者 agentionai)是运行 Qwen3.8-Flash-Next 占用最小的方式。
- 它可在 NVIDIA、AMD、Intel Arc 和 Apple 芯片上运行。
+ <details>
+ <summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.8-Flash-Next</b></summary>
- | 尺寸 | 所需内存(RAM + VRAM) | 下载大小 | 适合 |
- | --- | ---: | ---: | --- |
- | **Gyro-S** | 27.6 GB | 58.5 GB | 其他尺寸都放不下的电脑。32 GB 的 Mac mini 上每秒 9 个 token。 |
- | **Gyro-M** | 35 GB | 92.0 GB | 质量约相当于 IQ3_XXS,显存占用少 20%。 |
+ | 提供方 | 可选项 |
+ | --- | --- |
+ | **ISTA-DASLab · 推荐** | Q2\_0, IQ2\_XS, IQ3\_XXS, IQ3\_S。[Coder:IQ1\_M](docs/MODELS.md#coder),适合写代码。 |
+ | **Unsloth** | UD-IQ4\_XS, UD-Q4\_K\_XL, UD-Q5\_K\_XL, UD-Q6\_K\_XL, Q8\_0 |
+ | **Gyro · agentionai** | [Gyro-S, Gyro-M](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF)。占用内存更少,但速度更慢。 |
+ | **其他选项** | [Swift 1.5](docs/MODELS.md#swift-15), [NVFP4](docs/NVFP4.md), [OrcaRouter](docs/ORCA.md) |
- 用 `strata launch --model gyro-s` 启动。详情:[docs/GYRO.md](docs/GYRO.md)。
+ [比较大小、内存需求和兼容性](docs/MODELS.md)。
- ### Qwen3.8-Flash-Next 的尺寸
+ </details>
- | 你的内存(RAM + VRAM) | 选择 | 原因 |
- | --- | --- | --- |
- | **32 GB** | **Gyro-S**,写代码可选 **[Coder](docs/MODELS.md#coder)** | Coder 保留代码用到的专家 |
- | **40 GB** | **[Swift 1.5](docs/MODELS.md#swift-15)** IQ2_XS(39.2 GB)或 **Gyro-M** | Swift 回答前思考的时间更短 |
- | **48 GB** | **IQ3_XXS**(47.0 GB) | 更慢,更好 |
- | **64 GB** | **IQ3_S**(54.8 GB) | 在公开测试中与完整模型持平 |
- | **96 GB 及以上** | Unsloth 的 **UD-IQ4_XS** 到 **Q8_0** | 最接近完整模型 |
+ <details>
+ <summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.6-35B-A3B</b></summary>
- 内存比这一行写的少,也可能能用,只是更慢:Strata 会自动切换到[低内存模式](docs/MODELS.md#a-big-graphics-card-and-little-ram)。
- 另外还有:给 NVIDIA 显卡用的 [NVFP4](docs/NVFP4.md)、[Qwen3.6-35B-A3B](docs/QWEN36.md)(更小,能同时处理多个请求),
- 以及 [OrcaRouter 的 Uncensored IQ3_XXS](docs/MODELS.md#orcarouter-uncensored-iq3_xxs)。所有尺寸,以及各种配置能跑什么:
- [docs/MODELS.md](docs/MODELS.md)。
+ **Unsloth:** UD-Q4_K_XL, UD-Q6_K_XL, Q8_0。这些是目前文档中收录的该模型的版本。
- ### DeepSeek V4.1-Flash(终端版,0.2.4 起)
+ [模型指南和兼容性](docs/QWEN36.md)。
- 一个大得多的模型,用一块 12 GB 显卡加 46 到 64 GB 内存就能运行。Strata 把最常用的部分留在内存里,其余的从你的固态硬盘读取。
- 这些版本由 [ISTA-DASLab](https://huggingface.co/ISTA-DASLab/DeepSeek-V4.1-Flash-1017-GSQ-RCO-GGUF) 制作。它可在
- NVIDIA RTX 30、40、50 系列显卡和 Radeon AI PRO R9700 上运行。请在 `strata launch` 里选择它。桌面应用暂时不提供。
+ </details>
- | 版本 | 下载大小 | 质量 | 写代码速度 |
- | --- | ---: | --- | --- |
- | **IQ1_M**(1.75 位) | 239 GB | 最小,普通文字表现较弱 | 还没在电脑上测量 |
- | **IQ2_XXS**(2.00 位) | 257 GB | 平衡得不错 | 每秒 10 个 token(RTX 3060),5(RTX 5070),48(4 块 R9700) |
- | **IQ2_XS**(2.25 位) | 274 GB | 最接近原模型 | 每秒 15 个 token(一块 R9700),80(4 块 R9700) |
- | **IQ4_NL**(Engram 表) | 已包含在上面每个下载中 | 三个版本共用的查找表 | |
+ <a id="the-other-sizes"></a>
- 用 `strata launch --model ist-das-2.00bpw`(或 `ist-das-1.75bpw`、`ist-das-2.25bpw`)启动。质量数据、各台电脑的速度和手动安装:
- [docs/DEEPSEEK41.md](docs/DEEPSEEK41.md)。
+ 不确定哪个放得下?[为你的电脑选择模型](docs/MODELS.md#pick-by-memory)。
- ## 速度如何?
+ ## 安装
- 以下数据基于 12 GB 显卡(RTX 5070、64 GB 内存)。其他显卡的结果见:
- [各尺寸的速度](docs/MODELS.md#how-fast-is-each-size)和[社区测试结果](docs/COMMUNITY_BENCHMARKS.md)。
+ <a id="option-a-the-strata-app"></a>
- | 模型 | 回答输出速度 | 读取提示词速度 |
- | --- | --- | --- |
- | **Q2_0** | `████████████` 94 tokens/s | `████████████` 2,650 tokens/s |
- | **IQ2_XS** | `██████████░░` 79 tokens/s | `█████████░░░` 2,090 tokens/s |
- | **IQ3_XXS** | `████████░░░░` 62 tokens/s | `████████░░░░` 1,750 tokens/s |
- | **IQ3_S** | `███████░░░░░` 53 tokens/s | `███████░░░░░` 1,620 tokens/s |
- | **Coder** | `███████░░░░░` 55 tokens/s | `██████████░░` 2,180 tokens/s |
+ ### 桌面应用
- 在 16 GB 的 AMD 显卡上(RX 9070 XT、47 GB 内存):
+ **[下载适用于 Windows、Linux 或 Mac 的 Strata →](https://github.com/Niko1221/Strata/releases/latest)**
- | 模型 | 回答输出速度 | 读取提示词速度 |
- | --- | --- | --- |
- | **Q2_0** | `████████░░░░` 60 tokens/s | `█████░░░░░░░` 1,160 tokens/s |
- | **IQ2_XS** | `███████░░░░░` 52 tokens/s | `█████░░░░░░░` 1,110 tokens/s |
- | **Coder** | `██████░░░░░░` 44 tokens/s | `██████░░░░░░` 1,420 tokens/s |
+ 安装应用,选择模型,就可以开始聊天。每个系统只有一个安装程序。首次启动时,应用会下载适合你显卡的引擎。[安装程序帮助](docs/INSTALL.md#the-app)。
- 一个 token 约等于 ¾ 个英文单词,所以每秒 60 个 token 比你阅读的速度还快。“读取提示词”指 Strata 吸收长文档、代码或聊天历史的速度。
-<sub>文件: `Strata-0.2.5-windows-x64-setup.exe` · `Strata-0.2.5-linux-x86_64.AppImage` · `Strata-0.2.5-macos-arm64.dmg`</sub>
++<sub>文件: `Strata-0.2.6-windows-x64-setup.exe` · `Strata-0.2.6-linux-x86_64.AppImage` · `Strata-0.2.6-macos-arm64.dmg`</sub>
- ## 使用方法
+ <p align="center">
+ <img src="docs/media/app-chat.png" width="900" alt="Strata 桌面应用,聊天和实时代码预览并排显示">
+ <br><sub>聊天、文件和实时预览都在一个窗口里。</sub>
+ </p>
- ### 在应用里
+ <a id="option-b-the-terminal-one-line"></a>
- 聊天、显示模型以及 GPU、CPU 和内存状态的**监控**、**模型**页面和**设置**。聊天可以在你电脑上的某个文件夹里工作。
- 在**手动**模式下,修改文件或运行命令之前它会先询问你。它可以搜索网页(DuckDuckGo 或 Bing,不需要账号)。
- 发出电脑的只有搜索词。
+ ### 终端应用
- <p align="center"><img src="docs/media/app-chat.png" width="900" alt="Strata 应用:一次对话,智能体做出了一个小型体素宝塔花园,页面在右侧的预览中打开"><br>
- <sub>智能体用一个 HTML 文件写出了体素宝塔花园,页面在聊天旁的预览中打开</sub></p>
+ 更喜欢终端?安装 Strata,然后运行 **`strata launch`**。
- ### 在终端里
+ <details open>
+ <summary><b>安装命令</b></summary>
- <p align="center"><img src="docs/media/terminal-monitor.png" width="900" alt="模型写回复时,Strata 终端监控的总览界面"><br>
- <sub>模型回复时的 <code>strata monitor</code>:速度、GPU、内存和最近的请求</sub></p>
+ **Linux / Mac**
```sh
- strata launch # guided: model, context, pictures, access, then serve
- strata launch --model q2_0 --yes --no-tui # no questions: serve and print the address
- strata launch --status # what is being served now
- strata launch --stop # stop it
- strata monitor # watch speed, GPU, memory and requests
- strata update # get the newest engine
- strata doctor # check the installed files
+ curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh -o install.sh && sh install.sh
```
- 要从手机或另一台电脑访问 Strata,请使用 `strata launch --access lan`。它会为你生成一个 API 密钥。
- `strata --help` 会列出所有命令,[docs/TERMINAL.md](docs/TERMINAL.md) 有详细说明。
-
- ### 配合 AI 智能体和其他应用
-
- 智能体用上面的一行命令安装 Strata,然后运行 `strata launch --model NAME --yes --no-tui`。步骤、参数和退出码见
- [docs/AI_SETUP.md](docs/AI_SETUP.md)。给智能体看的仓库规则:[AGENTS.md](AGENTS.md)。
-
- | 你的应用使用 | 基础 URL |
- | --- | --- |
- | OpenAI API(大多数应用和智能体) | `http://127.0.0.1:8080/v1`(API 密钥和模型名称随便填) |
- | Anthropic API(Claude Code) | `http://127.0.0.1:8080`,不带 `/v1`。Claude Code:`ANTHROPIC_BASE_URL=http://127.0.0.1:8080` |
- | OpenAI Responses API(Codex CLI) | `http://127.0.0.1:8080/v1/responses`([设置方法](docs/DETAILS.md#the-responses-api-and-codex-cli)) |
-
- `strata connect` 会打印 OpenCode、Codex CLI、Claude Code、oh-my-pi、pi、Hermes Agent 和 OpenClaw 的具体设置,
- `strata connect opencode --write` 会帮你写入(并保留备份)。
-
- ### 使用须知
-
- - **图片**对每个能看图片的模型都是默认开启的。在聊天里附加或粘贴图片,或者从你的应用发送图片。详情:[docs/IMAGES.md](docs/IMAGES.md)。
- - **思考级别**可以是 off、low、medium 或 high,在聊天菜单或你的应用的“reasoning effort”里设置。off 最快。
- - **聊天的第一条消息**会被完整读取,每 30,000 个 token 约需 1 分钟。之后的消息几秒钟就开始。
- - **默认一次处理一个请求。** 要处理更多,请使用 `--parallel N`([BATCHING.md](docs/BATCHING.md))。在 12 GB 显卡上,这会让每个回答变慢。
+ **Windows PowerShell**
- ## 从源码构建
-
- <details>
- <summary>从仓库构建 Windows、Linux 和 Mac 版本</summary>
-
- [下载 Strata](https://github.com/Niko1221/Strata/archive/refs/heads/main.zip)并解压,或者用 `git clone` 获取。
- **Windows:** 双击 `START-HERE.bat`。**Linux:** 在 Strata 文件夹里运行 `./setup.sh`。
-
- **Mac(Apple 芯片,macOS 15 及以上):** 先用 `xcode-select --install` 安装一次 Apple 的命令行工具(不需要完整的 Xcode)。
- 在 Strata 文件夹里打开终端,运行 `./setup.sh`。它会在你的 Mac 上构建 Mac 引擎(约 7 分钟),问同样的问题,下载模型并启动。
- 下次运行 `./setup.sh` 会直接启动。你的 Mac 适合哪个尺寸:[docs/MAC.md](docs/MAC.md)。
-
- 安装程序会找到你的显卡,并设置合适的引擎。它会问你用哪个模型和尺寸、上下文多长(模型能记住多少文字),以及是否要读取图片。
- 直接按回车就是推荐的选择。然后它会下载模型(约 70 GB)并启动。如果下载中断,再运行一次就会继续。浏览器会打开
- `http://127.0.0.1:8080` 上的 Strata 页面。
-
- > 模型启动期间,你的电脑可能会变慢,或者在 1-3 分钟内没有响应(第一次最久)。Strata 会把 35-55 GB 加载到内存里,并锁定其中一部分
- > 给显卡使用。请等待,不要关闭窗口。
-
- 下次再运行 `START-HERE.bat`(或 `./setup.sh`)会立即启动,不会重复下载。关闭它的窗口就能停止模型。`UPDATE.bat`
- (`./update.sh`)只更新 Strata,不启动。更新、Docker、多显卡、文件存放位置和所有选项:[docs/INSTALL.md](docs/INSTALL.md)。
-
- 要测试你的电脑,运行 `BENCH.bat`(`./bench.sh`)。需要 5-10 分钟,并生成一份可以分享的报告
- ([方法](docs/COMMUNITY_BENCHMARKS.md#run-the-benchmark))。
-
- **可选:整个模型都放得进内存时,让单卡更快。** 这是 RubenTorney 提供的两个需要手动开启的设置(#1904、#1905)。
- 当你只用一张显卡,并且内存装得下所有专家时,它们会有帮助,例如在 64 GB 的电脑上跑 Q2_0 或 IQ3_XXS。打开 Strata 数据文件夹里的
- `strata-<model>.json`([位置](docs/INSTALL.md#where-things-are-stored)),然后添加:
+ ```powershell
+ irm https://github.com/Niko1221/Strata/releases/latest/download/install.ps1 | iex
+ ```
- - 在 `"args"` 列表中加入 `"--adapt-async", "1"`。这样专家缓存会在辅助线程上更新,不会让回答暂停。在 RTX 5070
- (Windows,Q2_0)上测得:解码快 4-5%,代码和长文档快 7-10%。回答可能与默认设置略有不同,但每次运行的结果保持一致。
- - 在 `"env"` 块中加入 `"STRATA_PIN_BY_NEED": "1"`(Windows)。Windows 只能为显卡锁定大约一半的内存,
- 这个设置会优先锁定显卡最先需要的专家。在 RTX 5070 上测得:读取提示词快 4.4%。
+ 在 Windows 上,安装后请打开一个新的终端。然后运行:
- ```json
- "args": [ ..., "--adapt-async", "1" ],
- "env": { "STRATA_PIN_BY_NEED": "1" }
+ ```sh
+ strata launch
```
- 修改后请重启 Strata。要撤销,删除这两项即可。
+ 按提示下载并启动模型。[终端指南](docs/TERMINAL_LAUNCH.md)。
</details>
diff --cc docs/AI_REFERENCE.md
index 000000000,b3d8e5898..8bcd3c8ec
mode 000000,100644..100644
--- a/docs/AI_REFERENCE.md
+++ b/docs/AI_REFERENCE.md
@@@ -1,0 -1,131 +1,131 @@@
+ # Strata reference for AI tools and automated readers
+
+ Last reviewed: 25 October 2026 against the 0.2.5 release tree (app and Terminal 0.2.5; Control and engines 0.1.50).
+ App, Control and engine versions differ; use the release notes and the installed component information. This page
+ holds the technical context behind the short [README](../README.md). Use [AI_SETUP.md](AI_SETUP.md) to install Strata for a user,
+ [AGENTS.md](../AGENTS.md) for repository work, and [MEDIA_KIT.md](MEDIA_KIT.md) for articles or videos.
+
+ ## Product facts and sources
+
+ - Strata runs supported language models locally, with a desktop app, a terminal app, and an inference engine.
+ - The engine uses the GPU, system RAM and, for applicable models and memory modes, SSD storage.
+ See [how it works](HOW_IT_WORKS.md) and [engine details](DETAILS.md).
-- There is one app installer per system (`Strata-0.2.5-windows-x64-setup.exe`, `Strata-0.2.5-linux-x86_64.AppImage`,
- `Strata-0.2.5-macos-arm64.dmg`). The Windows and Linux installers carry no engine: the app downloads the engine for the
++- There is one app installer per system (`Strata-0.2.6-windows-x64-setup.exe`, `Strata-0.2.6-linux-x86_64.AppImage`,
++ `Strata-0.2.6-macos-arm64.dmg`). The Windows and Linux installers carry no engine: the app downloads the engine for the
+ graphics card on first start, or installs a file the user already has. The Mac dmg keeps its Metal engine inside.
+ The Terminal's `strata launch` downloads the appropriate engine and model.
+ See [installation](INSTALL.md) and [Terminal launch](TERMINAL_LAUNCH.md).
+ - Strata's code is MIT licensed. Model weights and third-party components have separate licenses.
+ See [LICENSE](../LICENSE) and [component/model licensing](HOW_IT_WORKS.md#license).
+ - Local inference does not mean every feature is offline. Downloads, updates, remote tools and user-enabled
+ network access have separate behavior. Use [SAFETY.md](SAFETY.md) for privacy and network claims.
+ - Verify the current app and engine versions in the [release notes](https://github.com/Niko1221/Strata/releases).
+ A screenshot, translated README or historical benchmark is not a version source.
+
+ ## Model families
+
+ Treat these as the three top-level families. Coder, Swift, Gyro, NVFP4 and OrcaRouter are Flash-Next variants,
+ not additional top-level families.
+
+ | Family | Availability evidence | Catalog and limits |
+ | --- | --- | --- |
+ | DeepSeekV4.1-Flash-1017 | `deepseek41` in `MULTI_FILE_FAMILIES` in [setup.py](../setup.py); Terminal since 0.2.4, desktop app since 0.2.5 | [MODELS.md](MODELS.md#deepseek-v41-flash): IST-DAS 1.75 bpw (239 GB), 2.00 bpw (257 GB) and 2.25 bpw (274 GB), 8K context, a Speed choice (Faster or Full quality). NVIDIA RTX 30, 40 and 50 (Windows, Linux) and AMD Radeon AI PRO R9700 (Linux). Not on Mac, Intel Arc or Strix Halo yet. |
+ | Qwen3.8-Flash-Next | Catalog entries in [setup.py](../setup.py), model guides and backend documentation | [MODELS.md](MODELS.md), [QUANTS.md](QUANTS.md), [GYRO.md](GYRO.md), [NVFP4.md](NVFP4.md), [ORCA.md](ORCA.md) |
+ | Qwen3.6-35B-A3B | `qwen36` in `OWN_PATH_FAMILIES` in [setup.py](../setup.py) | [QWEN36.md](QWEN36.md): NVIDIA and AMD; not the Intel or Mac engine |
+
+ Do not reuse Qwen quant names, model sizes or performance figures for DeepSeek. A field this page does not state is
+ **unknown**, not zero and not unsupported. DeepSeek Harness is a coding tool; its presence does not establish support
+ for a particular DeepSeek model.
+
+ ## Provider preference
+
+ For recommendations, documentation and agent-assisted setup, use this order:
+
+ 1. **ISTA-DASLab**: first and default recommendation when it supplies a compatible pack that fits.
+ 2. **Unsloth**: next choice when an appropriate ISTA-DASLab pack is unavailable or does not fit the user's needs.
+ 3. **Gyro / agentionai**: a memory-saving fallback; it is currently slower and must not be promoted as the fast option.
+ 4. **Other providers and variants**: including Swift 1.5, NVFP4 and OrcaRouter.
+
+ The maintainer works with ISTA-DASLab; this is an explicit project preference, not a measured quality ranking.
+ Keep the user's chosen model family and explicit provider choice. Check availability, backend compatibility,
+ memory, disk space and intended use before selecting a pack. If no ISTA-DASLab pack is documented for a family,
+ do not invent one: Qwen3.6 has Unsloth packs, and DeepSeek has the IST-DAS sets.
+
+ This order is a recommendation, not the installer's default logic. A no-argument installer may preselect Swift or Gyro
+ on some memory tiers. Read its plan and select the intended family explicitly.
+
+ ## Quantization and variant index
+
+ Rows follow the recommendation order. Family selectors are those documented in this checkout; confirm them
+ with the installed release's `strata launch --help` and a plan before a download.
+
+ | Parent model | Provider / variant | Family selector | Quantizations or packs |
+ | --- | --- | --- | --- |
+ | DeepSeek V4.1-Flash | IST-DAS | `deepseek41` | `ist-das-1.75bpw` (239 GB), `ist-das-2.00bpw` (257 GB), `ist-das-2.25bpw` (274 GB); Unsloth `ud-q8_k_xl` (508 GB, several cards) |
+ | Qwen3.8-Flash-Next | ISTA-DASLab, original | `qwen` | Q2_0, IQ2_XS, IQ3_XXS, IQ3_S |
+ | Qwen3.8-Flash-Next | ISTA-DASLab, Coder | `coder` | IQ1_M; pruned for coding, weaker outside code |
+ | Qwen3.8-Flash-Next | Unsloth | `unsloth` | UD-IQ4_XS, UD-Q4_K_XL, UD-Q5_K_XL, UD-Q6_K_XL, Q8_0 |
+ | Qwen3.8-Flash-Next | Gyro / agentionai | `gyro` | Gyro-S, Gyro-M; backend-specific validation in [GYRO.md](GYRO.md) |
+ | Qwen3.8-Flash-Next | Swift 1.5 / UkisAI | `swift` | IQ2_XS, IQ3_XXS, IQ3_S; a fine-tune, not just a quantization |
+ | Qwen3.8-Flash-Next | NVFP4 | `nvfp4` | NVFP4, NVFP4-NVIDIA, NVFP4-QAD; NVIDIA only |
+ | Qwen3.8-Flash-Next | OrcaRouter Uncensored | Manual conversion | IQ3_XXS; not an installer menu choice |
+ | Qwen3.6-35B-A3B | Unsloth | `qwen36` | UD-Q4_K_XL, UD-Q6_K_XL, Q8_0 |
+
+ ## Hardware and sizing
+
+ Read the backend guide for the exact GPU, OS, model, quantization and feature combination. A supported GPU
+ does not imply that every model or feature works on it.
+
+ | Backend / hardware | Source |
+ | --- | --- |
+ | NVIDIA RTX / CUDA | [INSTALL.md](INSTALL.md#what-you-need) |
+ | AMD Radeon / HIP | [AMD_HIP.md](AMD_HIP.md); RX 6000 validation differs from newer cards |
+ | Intel Arc / SYCL | [INTEL_ARC.md](INTEL_ARC.md); released Linux SYCL engine (Ubuntu 24.04 or newer), with model preparation and per-card limits. [INTEL.md](INTEL.md) records source-port details |
+ | Apple Silicon / Metal | [MAC.md](MAC.md); no DeepSeek yet |
+ | AMD Ryzen AI Max / Strix Halo | [STRIX_HALO.md](STRIX_HALO.md) |
+ | Multiple GPUs and older hardware | [MULTI_GPU.md](MULTI_GPU.md), [OLDER_GPUS.md](OLDER_GPUS.md) |
+
+ Use the model's actual memory and disk requirements. RAM, VRAM, unified memory, download size and temporary
+ conversion space are different quantities. Count unified memory once. Do not carry the smallest Qwen model's
+ memory estimate over to every family. For the current planning rules, consult [MODELS.md](MODELS.md#will-it-fit).
+
+ ## APIs and coding tools
+
+ Default local server address: `http://127.0.0.1:8080`. The configured port and access settings can differ.
+
+ | Client API | Base URL | Request endpoint |
+ | --- | --- | --- |
+ | OpenAI Chat Completions | `http://127.0.0.1:8080/v1` | `POST /v1/chat/completions` |
+ | OpenAI Responses | `http://127.0.0.1:8080/v1` | `POST /v1/responses` |
+ | Anthropic Messages | `http://127.0.0.1:8080` | `POST /v1/messages` |
+
+ Use the actual configured API key when authentication is enabled. See [API details](DETAILS.md#using-it).
+ The [connection registry](../strata_cli/launch/harness.py) supplies these adapters:
+
+ | Tool | `strata connect` identifier |
+ | --- | --- |
+ | Claude Code | `claude-code` |
+ | Codex CLI | `codex` |
+ | OpenCode | `opencode` |
+ | oh-my-pi | `omp` |
+ | pi.dev | `pi` |
+ | Hermes Agent | `hermes` |
+ | OpenClaw | `openclaw` |
+ | DeepSeek Harness, built into the Strata app | `deepseek-harness` |
+
+ `strata connect` lists adapters. `strata connect <identifier>` prints settings;
+ `strata connect <identifier> --check --output json` sends a prompt and a tool call and reports their outcomes.
+ Do not mistake printed configuration or an older tested version for a successful check of the current setup.
+ See [connection instructions and limits](TERMINAL_LAUNCH.md#connect-your-apps-strata-connect).
+
+ ## Evidence and publishing
+
+ - Cite the release, commit and relevant guide behind each compatibility claim.
+ - Performance claims need the model, quantization, hardware, workload, engine version and source report.
+ Keep prompt processing, decode throughput and latency separate. Do not turn a screenshot into a benchmark.
+ - [Community benchmarks](COMMUNITY_BENCHMARKS.md) include historical reports.
+ The [standard benchmark protocol](BENCHMARK_PROTOCOL.md) remains subject to its documented activation status;
+ do not label legacy commands or results as implementing it.
+ - Mark missing or unverified information explicitly. Never invent measurements, test results or download links.
+ - For contribution evidence, follow [CONTRIBUTING.md](../CONTRIBUTING.md). For video assets and narration,
+ follow [MEDIA_KIT.md](MEDIA_KIT.md).
diff --cc docs/AI_SETUP.md
index 5d8be6739,bfe87d5da..ec9abbd3b
--- a/docs/AI_SETUP.md
+++ b/docs/AI_SETUP.md
@@@ -1,62 -1,35 +1,35 @@@
- # Installing Strata for a user (instructions for AI agents)
-
- This page is written for an AI coding assistant (Claude Code, Cursor, Codex, GitHub Copilot, ...) that a user asked to
- set up Strata on their PC. Strata runs the Qwen3.8-Flash-Next model locally on one NVIDIA or AMD graphics card plus
- system RAM (or on an Apple Silicon Mac), and serves an OpenAI- and Anthropic-compatible API on `http://127.0.0.1:8080`.
- The human-oriented version of everything below is [INSTALL.md](INSTALL.md).
-
- You use the **Terminal**: the `strata` command. Install it with one line, then `strata launch` downloads the engine
- for the card and the model, and starts the server. If the Terminal cannot run on this PC, step 9 has the older route
- from source.
-
- Work through the steps in order. Tell the user what you are doing in plain words; they may not be technical.
-
- ## 0. Ground rules
-
- - **Recommend an API key beyond this computer; do not force it.** Keep the default (`--access local`, the server listens on
- `127.0.0.1` only, no key needed). Only if the user asks for access from other devices, use `--access lan`. Strata makes a long
- random key for you then. Give the user the key (`strata launch --show-key`). If the user says they do not want a key, use
- `--no-api-key`: it starts and warns that anyone who can reach the port can use the model and its tools. Tell the user so.
- Do not put a tunnel or port forward in front of a server without a key unless the user asks for it.
- - Do not change the user's system beyond what Strata does. The Terminal installs into the user's home folder and needs
- no administrator rights. It does not install drivers, Python packages or compilers. Ask before installing drivers.
- - The model download is ~70 GB (94 GB for Unsloth's UD-IQ4_XS, 111 GB for UD-Q4_K_XL). Confirm the user is fine with
- that before you start, especially on a metered connection.
- - The first `strata launch` is long-running (an hour or more on a slow connection). Run it in the background or with a
- long timeout and poll its output; do not kill it because it is quiet for a while. It is resumable: running the same
- command again continues where it stopped.
- - Piping a script from the internet into a shell runs code you have not read. Tell the user what the line does (step 2).
- If they prefer, download the script first, show it, and run it only after they agree.
-
- ## 1. Check the PC
-
- Requirements (details: [INSTALL.md](INSTALL.md#what-you-need)):
-
- - **GPU:** NVIDIA RTX 20, 30, 40 or 50 series, or AMD Radeon RX 7900 XT / XTX, RX 7800 XT / 7700 XT, RX 9060 XT,
- RX 9070 / 9070 XT, Radeon AI PRO R9700, RX 6800 / 6900 series; 12 GB of VRAM or more (an NVIDIA card with 8 GB runs,
- slowly). GTX 10 series and older, and integrated GPUs, are not supported; Pascal / Volta cards (P40, V100) and some
- older AMD cards have experimental paths the user opts into ([OLDER_GPUS.md](OLDER_GPUS.md)). A **Mac** needs Apple
- Silicon (M1 or newer), macOS 15 or newer and 16 GB of memory or more ([MAC.md](MAC.md)).
- - **Driver:** NVIDIA 580 or newer. AMD on Linux: the kernel's amdgpu driver; on Windows: a current AMD Adrenalin
- driver. If the driver is missing or too old, tell the user to update it (NVIDIA App / nvidia.com/drivers, or AMD
- Software) and restart; do not install drivers yourself unless they ask.
- - **RAM:** 32 GB or more (see step 3). **Disk:** ~80 GB free, ideally on an NVMe SSD. **CPU:** x86-64 with AVX2.
- Without AVX2 (Xeon E5 v1/v2 and older) the ready-made engine refuses to start; the route from source builds an
- experimental and slow engine on the PC (10-20 minutes): tell the user that before starting
- ([INSTALL.md](INSTALL.md#older-cpus-experimental)).
- - **OS:** Windows 10/11, Linux x86-64 (Ubuntu 22.04/24.04 and Debian 12/13 are fully automatic), or macOS on Apple Silicon.
-
- To check by hand:
-
- | What | Windows (PowerShell) | Linux | Mac |
- | --- | --- | --- | --- |
- | OS | `[Environment]::OSVersion` | `cat /etc/os-release` | `sw_vers` |
- | NVIDIA GPU, VRAM, driver | `nvidia-smi --query-gpu=index,name,memory.total,driver_version --format=csv` | the same | - |
- | AMD GPU | `Get-CimInstance Win32_VideoController \| Select-Object Name, AdapterRAM` (AdapterRAM is capped at 4 GB; trust the model name) | `lspci \| grep -i -E 'vga\|display'`; VRAM: `cat /sys/class/drm/card*/device/mem_info_vram_total` (bytes); `rocm-smi` only if ROCm is installed | - |
- | RAM | `(Get-CimInstance Win32_ComputerSystem).TotalPhysicalMemory / 1GB` | `free -g` | `sysctl -n hw.memsize` (bytes) |
- | Free disk | `Get-PSDrive -PSProvider FileSystem` | `df -h .` | `df -h ~` |
-
- If the PC does not meet them, say which part is missing and stop.
+ # Set up Strata for a user
+
+ Use this guide when a user asks an AI agent to install Strata (version 0.2.5). There are two release routes. Pick
+ one; do not start from a source checkout.
+
+ - **The Terminal and `strata launch`** (below). This is the route for an agent that has a shell.
-- **The desktop app.** One installer per system: `Strata-0.2.5-windows-x64-setup.exe`,
- `Strata-0.2.5-linux-x86_64.AppImage`, `Strata-0.2.5-macos-arm64.dmg`, from the
++- **The desktop app.** One installer per system: `Strata-0.2.6-windows-x64-setup.exe`,
++ `Strata-0.2.6-linux-x86_64.AppImage`, `Strata-0.2.6-macos-arm64.dmg`, from the
+ [latest release](https://github.com/Niko1221/Strata/releases/latest). The Windows and Linux installers carry no
+ engine: on first start the app shows the engine for the user's graphics card and downloads it, or installs a file the
+ user already has ("I already have the file"). Details: [INSTALL.md](INSTALL.md).
+
+ Model availability, provider preference and API details are in [AI_REFERENCE.md](AI_REFERENCE.md).
+
+ ## 1. Check the computer and the requested model
+
+ - Check OS, CPU architecture, graphics cards, driver, available RAM/VRAM and free disk space.
+ - Use the [hardware guides](INSTALL.md#what-you-need). Linux and Windows packages are x86-64; Mac packages are
+ Apple Silicon and need macOS 15 or newer. Older GPUs, Intel Arc and low-memory machines have specific limits.
+ - Model support is separate from hardware support. Qwen3.6 currently uses CUDA or HIP; it is not a Metal/SYCL model.
+ DeepSeekV4.1-Flash-1017 (`--family deepseek41`) runs in the app and in the Terminal, on NVIDIA RTX 30, 40 and 50
+ (Windows and Linux) and on the AMD Radeon AI PRO R9700 under Linux. It has three sets: 1.75 bpw (239 GB of disk),
+ 2.00 bpw (257 GB) and 2.25 bpw (274 GB), and for a 12 GB card it needs 46 to 64 GB of RAM. The context is 8K.
+ `--speed faster|full` (or `--full-quality`) chooses how many experts it uses per word; Faster is the default on a
+ PC with 16 GB of graphics memory or less. Print the plan first:
+ `strata launch --plan --family deepseek41 --model ist-das-2.00bpw`.
+ - Check the **chosen pack's** memory and disk needs. Do not reuse a Flash-Next estimate for every family.
+ Unified memory is one pool, not RAM plus VRAM. A completed download does not establish that a model can run.
+ - Keep the default local-only access. Share the server over a network only when the user asks; recommend an API key
+ beyond localhost and explain any deliberate use of `--no-api-key`.
+ - Explain substantial downloads and follow the user's existing authorization and network/storage constraints.
+ Do not install drivers or system build tools as an unannounced side effect of a normal Terminal install.
## 2. Install the Terminal
diff --cc docs/AMD_HIP.md
index dc401cf4d,29ef51790..f806f4238
--- a/docs/AMD_HIP.md
+++ b/docs/AMD_HIP.md
@@@ -26,48 -22,35 +22,35 @@@ Source checkout on Linux ([SOURCE_INSTA
./setup.sh --backend hip
```
- - **Detection:** setup finds the card through the kernel's KFD topology. Integrated Radeon GPUs are listed as not
- supported. On a PC without an NVIDIA card Strata can use, `--backend hip` is chosen automatically.
- - **ROCm:** a system ROCm 7 in `/opt/rocm` (or `$ROCM_PATH`) with hipcc and hipBLAS is used when present. Otherwise
- (or when it is older than 7.0) ROCm is installed into `.venv` from AMD's TheRock wheels (~10 GB, no sudo), from the
- card family's index: `gfx110X-dgpu` for gfx1100 / gfx1101, `gfx120X-all` for gfx1200 / gfx1201, `gfx103X-all` for
- gfx1030, `gfx1151` for Strix Halo. The version is chosen per family: 7.10.0a20251120 where that is on the index,
- 7.13.0a20260515 for `gfx103X-all` (its index starts at 7.13, #1103) and 7.14.0a20260608 for `gfx1151` (the 7.10 wheel
- segfaults on kernel 7.2.8, #1267). When the index no longer offers the version, setup warns and takes the newest of
- the same 7.x line, else of the same major. `STRATA_ROCM_VERSION` / `STRATA_ROCM_INDEX` override them; the gfx1030
- wheels are unvalidated (a system ROCm 7 is the tested path there).
- - **Engine:** compiled on your PC for the card's architecture (10-20 minutes, once; again after a `git pull` that
- changes it, or when you pick a card of another architecture). This needs a C++ compiler and git
- (`sudo apt install build-essential git`).
- - **hipBLASLt tuning table:** setup uses `tools/hip/<arch>-hipblaslt-<version>.txt` only when it matches both the
- card's architecture and the installed hipBLASLt version (read from `hipblaslt-version.h`; 1.2.0 is `100200`).
- Otherwise it says so and the prompt's dense matrix products use plain hipBLAS (slower prompts, same answers).
- A table's solution ids are valid only for that pair, and the engine refuses any other table. On gfx103x (RDNA2,
- no hipBLASLt kernels) the same role falls to a rocBLAS table, `tools/hip/<arch>-rocblas-<version>.txt`, which the
- engine picks for its own rocBLAS build when setup points it at the directory ([RDNA2](#rdna2-gfx1030)).
- - **Several cards:** setup takes one card (the one with the most VRAM, or `--gpu N`) unless you name more:
- `./setup.sh --backend hip --gpus 1,0` splits the model's layers across them, the faster card goes last and is the Main card (`--gpu-roles 1=main,0=helper` says it yourself; docs/MULTI_GPU.md) (numbers
- as setup lists them; `--gpus all` = every supported card, the most VRAM first). Every chosen card must be one of the
- architectures above; the engine is compiled for each of them (cards of two families, e.g. gfx1100 + gfx1201, need
- a system ROCm 7: AMD's wheels hold one family). A split pays only when no single card holds the model's experts
- (see RDNA4 below).
- - **Pictures:** on by default; the reader is the CPU one under 24 GB of VRAM and the GPU one from 24 GB (the same rule on NVIDIA and AMD, `strata_control/vision_reader.py`); `--vision gpu` / `--vision cpu` switch it. The engine package carries two picture readers: `strata-vision-hip`, which reads a picture on the
- card (llama.cpp's HIP backend; about 1.4 GiB of VRAM, measured on an R9700: 0.06 s for a 260-token picture and 0.4 s for 972
- tokens, against 3.1 s and 14 s on the CPU), and `strata-vision`, the CPU reader. If the GPU reader cannot start (the card is
- not one it was built for, the HIP runtime does not load, the card is busy) the server starts the CPU reader by itself and
- prints one line; nothing is asked. `--vision cpu` picks the CPU reader on purpose.
- - **Limits for now:** Setup does not offer the tuning
- (calibration) on AMD yet: its controls are being checked on HIP one at a time (#566). Since 0.1.39 a tuning run by
- hand (`./setup.sh --calibrate`) is saved for the AMD card it ran on and reused when setup runs again. The Monitor
- shows the card's load, VRAM, temperature and power from Linux sysfs (0.1.32).
-
- The rest of setup is the same as on NVIDIA: the model download, the start script, the server.
-
- ## Ready-made packages (0.2.5)
-
- The release carries one AMD engine package per card family. The Terminal one-liner and `strata update` pick the package whose
- GPU code covers the card. The app installer (`Strata-0.2.5-windows-x64-setup.exe`, `Strata-0.2.5-linux-x86_64.AppImage`) has no engine
- inside: on its first start the app downloads the matching package for the card, or you press **Update engine** in Settings (or run `strata update`).
+ Setup picks `--backend hip` by itself on a PC with no NVIDIA card Strata can use. Other AMD architectures and mixed AMD/NVIDIA
+ runs are not supported. Use the [package table](#ready-made-packages) to match your card.
+
+ ## Supported cards
+
+ | Card | Architecture | Status |
+ | --- | --- | --- |
+ | RX 7900 XT / XTX | gfx1100 | Maintainer-tested |
+ | RX 9070 / 9070 XT, Radeon AI PRO R9700 | gfx1201 | Maintainer-tested ([RDNA4](#rdna4-gfx1201)) |
+ | RX 9060 XT | gfx1200 | Validated by its owner |
+ | RX 7800 XT / 7700 XT | gfx1101 | Validated by its owner |
+ | RX 7600 XT | gfx1102 | Reported working, not validated |
+ | RX 6800 / 6900 series, RX 6700 XT | gfx1030, gfx1031 | Has a package, not tested on a real card ([RDNA2](#rdna2-gfx1030)) |
+ | Ryzen AI Max (Strix Halo) | gfx1151 | [STRIX_HALO.md](STRIX_HALO.md) |
+ | Radeon 780M / 760M | gfx1103 | Linux, opt-in build: [RADEON_780M.md](RADEON_780M.md) |
+ | Instinct MI50 / MI60, Radeon VII | gfx906 | Source build, community-tested ([gfx906](#gfx906-instinct-mi50--mi60-radeon-vii-wave64-built-from-source)) |
+
+ Strix Point (890M / 880M, gfx1150) and Krackan (860M / 840M, gfx1152) are named and not supported by setup. RDNA1
+ (gfx1012) builds by hand: [OLDER_GPUS.md](OLDER_GPUS.md#amd-building-gfx906-and-gfx1012).
+
+ DeepSeek V4.1-Flash runs on the Radeon AI PRO R9700 on Linux, in the app and in the Terminal. The RX 9070 (gfx1200) engine package
+ carries it but it is untested. Details: [MODELS.md](MODELS.md#deepseek-v41-flash).
+
+ <a id="ready-made-packages-023"></a>
+ ## Ready-made packages
+
+ The Terminal one-liner and `strata update` pick the package whose GPU code covers the card. The app installer
-(`Strata-0.2.5-windows-x64-setup.exe`, `Strata-0.2.5-linux-x86_64.AppImage`) has no engine inside: on its first start the app
++(`Strata-0.2.6-windows-x64-setup.exe`, `Strata-0.2.6-linux-x86_64.AppImage`) has no engine inside: on its first start the app
+ downloads the matching package for the card. You can also press **Update engine** in Settings (or run `strata update`).
| Package (variant) | OS | GPU code inside | ROCm |
| --- | --- | --- | --- |
@@@ -135,54 -131,31 +131,31 @@@ reused. The Monitor shows the card's lo
## Windows
- Since 0.1.34 an AMD card on Windows is set up like an NVIDIA one: download Strata, double-click `START-HERE.bat`.
- On a PC with no NVIDIA card Strata can use, the AMD card is chosen by itself; with both, setup asks
- (`START-HERE.bat --backend hip` picks AMD directly).
-
- - **You need:** Windows 10 or 11 (64-bit), one of the cards above, and a current AMD driver ([AMD Software:
- Adrenalin Edition](https://www.amd.com/en/support/download/drivers.html)). Nothing else: no ROCm or HIP SDK
- install, no compiler, no admin rights.
- - **Detection:** setup reads the display adapters Windows lists (their PCI ids; the VRAM size from the display
- driver's registry entry). An integrated Radeon is listed as not supported, except the Ryzen AI Max "Strix Halo" (Radeon 8060S / 8050S / 8040S, gfx1151: [STRIX_HALO.md](STRIX_HALO.md)); a Strix Point (890M / 880M, gfx1150), Krackan (860M / 840M, gfx1152) or Phoenix / Hawk Point (780M / 760M, gfx1103) Radeon is named as what it is and not supported (on Linux the 780M / 760M has an opt-in build: [RADEON_780M.md](RADEON_780M.md)).
- - **Engine (0.2.0 and later):** the installers and `strata update` use the engine packages in [Ready-made packages](#ready-made-packages-020); the zip described next is the START-HERE route of 0.1.x.
- - **Engine (START-HERE, 0.1.x):** the ready-made engine package for your card, fetched from the signed update feed (releases from 0.2 carry no flat `strata-windows-x64-hip.zip`; that zip is what `build_windows.bat` makes for a self-build) (built by `tools\hip\build_windows.bat`
- for gfx1100, gfx1101, gfx1102, gfx1200, gfx1201, gfx1030 and, from 0.1.40, gfx1151 (Strix Halo, unvalidated on Windows)) goes into `engine\`. It carries the ROCm libraries the
- engine loads (`engine\rocm\bin`: the HIP runtime, hipBLAS / rocBLAS / hipBLASLt with their kernels for these cards,
- amd_comgr and the Microsoft C++ runtime; ROCm 10.2.0a20260930 from AMD's TheRock builds, licenses in
- `engine\rocm\licenses`). The HIP runtime works through the AMD driver's own components, so the driver is the one
- thing it needs from the PC.
- - **The HIP runtime next to `strata.exe` (0.1.35, #468 #461):** `amdhip64_7.dll` and `amd_comgr.dll` are also put in
- `engine\` (setup copies them there on every start). Windows looks in the program's folder before System32, where
- some AMD drivers install their own `amdhip64_7.dll`; with that one, the bundled libraries crashed on the first
- prompt (an access violation, or `hipErrorInvalidDeviceFunction`). The engine's log names the runtime it loaded
- (`strata generate: HIP runtime ...`).
- - **Before the ~60 GB model download** setup runs `engine\strata-device.exe --list-devices` (with `engine\rocm\bin` on
- the PATH): if the HIP runtime does not see the card, setup stops there and points to the driver. It also gives the
- card's HIP number: with an integrated Radeon that is device 1, not 0 (#325). From then on setup lists the AMD cards
- as HIP numbers them, so `--gpu N` and the config's `"gpu"` are HIP numbers.
- - **Differences from Windows-on-NVIDIA and Linux-on-AMD:** one card per model (`--gpus` is Linux-only for now), no calibration.
- - Two Windows-only engine details (#247, #325): hipBLAS can return success and still leave `hipErrorInvalidValue`
- set after some BF16/FP16 GEMMs (seen on gfx1201); the engine clears that one stale error after a GEMM that
- succeeded, on Windows only. `hipHostGetDevicePointer` returns the host pointer itself on Windows: kernels read
- mapped memory through it correctly, but a device-to-device copy into it does not land, which is why
- `tests/hip/handoff` times out there (the engine does not use that copy; `tests/hip/mapped_alias` reports it).
- - Two more (#380, #377, by BlueKingMuch, measured on an RX 6800 that drives the desktop): `hipMemGetInfo` on Windows
- does not subtract what the desktop and other programs hold on the card, so `--expert-cache auto` filled the card
- past what Windows keeps in VRAM and decode fell from 41 to 30 tok/s. The engine now lowers that free figure by
- what Windows' video memory budget for the process withholds (logged once: `strata: Windows budgets N of this
- card's M MiB ...`; `STRATA_WDDM_BUDGET=0` turns it off). And the PCIe probe times its copies on the host clock
- there, since HIP's events read impossible speeds (3,300-26,000 GB/s), so a slow link now gets a smaller
- `pcie_frac` as on NVIDIA.
-
- **What is validated (0.1.34):** #325's author ran the engine of this port on an RX 9070 XT (Windows 11, ROCm
- 10.2.0a20260930 in `.venv`, compiled on the PC): Coder IQ1_M at 32K, 29.2 tok/s decode, ~181 tok/s prefill,
- correct answers; ctest 42 of 46. The maintainers have no Windows AMD card: the release zip was built on an NVIDIA PC,
- and checked there on the Ryzen CPU's integrated Radeon (gfx1036, a test build of the same tree): with only the zip's
- libraries on the PATH, `strata-device` lists the card and a hipBLAS BF16 GEMM matches the CPU; the HIP ctest passes
- 52 of 56, the 4 failures the same as on the RX 9070 XT (`hip_handoff`, and three tests that need a pack fixture).
- The ready-made zip itself has not run a model on a discrete card yet - please report.
-
- **Reporting a Windows AMD run** (an issue, or on #325): your card and driver version (AMD Software > System), then
-Install the [app](INSTALL.md) (`Strata-0.2.5-windows-x64-setup.exe` from the
++Install the [app](INSTALL.md) (`Strata-0.2.6-windows-x64-setup.exe` from the
+ [release page](https://github.com/Niko1221/Strata/releases/latest); it downloads the engine for the card), or
+ install the [Terminal](INSTALL.md#the-terminal) and run `strata launch`. You need Windows 10 or 11 (64-bit), a supported card
+ and a current AMD driver. No ROCm or HIP SDK, no compiler, no admin rights. `START-HERE.bat --backend hip` is a
+ source-checkout option for developers, not a way to start the released app.
+
+ - **Detection:** setup reads the display adapters Windows lists. An integrated Radeon is listed as not supported, except Strix
+ Halo ([STRIX_HALO.md](STRIX_HALO.md)). Phoenix / Hawk Point (780M / 760M) is not supported on Windows; on Linux it has an
+ opt-in build ([RADEON_780M.md](RADEON_780M.md)).
+ - **HIP runtime:** the engine folder holds its own `amdhip64_7.dll` and `amd_comgr.dll`, because Windows looks in the
+ program's folder before System32, where some AMD drivers install an `amdhip64_7.dll` that crashes the bundled libraries. The
+ engine log names the runtime it loaded (`strata generate: HIP runtime ...`).
+ - **Before the model download,** setup runs `engine\strata-device.exe --list-devices`. If the HIP runtime does not see the
+ card, setup stops and points to the driver. With an integrated Radeon, a discrete card is HIP device 1, not 0; `--gpu N` and
+ the config's `"gpu"` are HIP numbers.
+ - **Several cards:** use the app's card selector or `strata launch --gpu 0,1`. [MULTI_GPU.md](MULTI_GPU.md) lists the
+ combinations measured. A tested Linux pair does not validate the same pair on Windows.
+ - **VRAM budget:** `hipMemGetInfo` on Windows does not subtract what the desktop and other programs hold. The engine lowers
+ the free figure by what Windows' video memory budget for the process withholds (logged once). `STRATA_WDDM_BUDGET=0` turns
+ that off.
+ - **WMMA prompt attention** is opt-in on Windows (`STRATA_HIP_WMMA=1`); it is the default on gfx12 on Linux.
+
+ **Reporting a Windows AMD run.** Give your card, the driver version (AMD Software > System), the output of the two commands
+ below (from the Strata folder, after `set PATH=%CD%\engine\rocm\bin;%PATH%`), the end of `strata-<model>.log`, and the speed
+ lines the server window prints for a first answer.
```bat
engine\strata-device.exe --list-devices
diff --cc docs/INSTALL.md
index dc3dd2a7f,1e2ae6463..85d61e893
--- a/docs/INSTALL.md
+++ b/docs/INSTALL.md
@@@ -44,40 -35,29 +35,29 @@@ hardware drivers. Models and updates ne
## The app
- The app is the easiest way. It has the engine inside, so there is nothing to build and no setup window.
-
- 1. Download the installer for your system from the [releases page](https://github.com/Niko1221/Strata/releases/latest).
- The page says which installer is for which graphics card (NVIDIA or AMD). Take the one that matches yours.
- - **Windows 10 / 11:** run the `.exe`. It installs for your user and needs no administrator rights. Windows may
- say "Windows protected your PC", because the installer is not code-signed yet. Choose **More info**, then
- **Run anyway**. The installer asks for the folder (by default `%LOCALAPPDATA%\Programs\Strata`): on a PC
- with little space on C:, pick a folder on another drive that you can write to (not Program Files, which needs
- an administrator). Updates from inside the app go into the same folder. The engine inside the app
- (`%LOCALAPPDATA%\Strata\components`) stays on C:; `STRATA_COMPONENTS_DIR` moves it, and the models go to the
- folder you choose in the app.
- - **Linux:** the `.AppImage`. Make it runnable (right-click, Properties, Permissions, "Allow executing file as
- program", or `chmod +x`), then double-click it. It needs FUSE 2: `sudo apt install libfuse2` on Ubuntu 22.04,
- `sudo apt install libfuse2t64` on Ubuntu 24.04 and newer, `sudo dnf install fuse fuse-libs` on Fedora. Without
- FUSE you can still start it with `--appimage-extract-and-run` after the file name. The NVIDIA build needs
- driver 580 or newer.
- - **Mac:** the `.dmg`. Open it, drag Strata onto Applications, then open Strata from there. It needs Apple
- Silicon and macOS 15 or newer. If macOS says the app is "damaged", the file is fine: see [MAC.md](MAC.md).
- 2. Start Strata. The first start is a little slower on Linux and Mac, because the engine inside the app is copied
- into your home folder.
- 3. The first screen reads your PC and recommends a model that fits. Press the install button. The download is
- big (40-70 GB). If it stops, it continues where it stopped.
- 4. Chat. **Closing the window stops Strata and the engine.**
-
- **Update:** Settings, then Updates, then **Check for updates**. The buttons **Update Strata** and **Update engine**
- appear only when something is new. Your models and saved settings are kept. Unload the model first: an engine that
- is running cannot be replaced. **Roll back** in the same place brings the previous engine back.
-
- **Where things are:** the app's settings and chats are in the `.strata` folder in your user folder, the engine
- in `%LOCALAPPDATA%\Strata\components` (Linux and Mac: `~/.local/share/strata/components`), and the models in the
- `Strata` folder in your Documents (you can change the model folder in the app). Removing the app does not remove
- them. **For a bug report:** Settings, Engine, Diagnostics, View logs, **Save logs**.
-
- On a Mac pictures are on by default and read on the GPU ([MAC.md](MAC.md)). Everything else about pictures is in [Setup's questions](#setups-questions).
+ 1. Open the [latest release](https://github.com/Niko1221/Strata/releases/latest).
+ 2. Download the one installer for your system. There is one per system, not one per graphics card:
- - **Windows:** run `Strata-0.2.5-windows-x64-setup.exe`. It installs for your user and needs no administrator rights.
- - **Linux:** make `Strata-0.2.5-linux-x86_64.AppImage` executable, then open it. If FUSE is unavailable, run the
++ - **Windows:** run `Strata-0.2.6-windows-x64-setup.exe`. It installs for your user and needs no administrator rights.
++ - **Linux:** make `Strata-0.2.6-linux-x86_64.AppImage` executable, then open it. If FUSE is unavailable, run the
+ downloaded file with `--appimage-extract-and-run`. [Linux help](TROUBLESHOOTING.md).
- - **Mac:** open `Strata-0.2.5-macos-arm64.dmg`, drag Strata into Applications, then open it. [Mac help](MAC.md).
++ - **Mac:** open `Strata-0.2.6-macos-arm64.dmg`, drag Strata into Applications, then open it. [Mac help](MAC.md).
+ 3. On Windows and Linux the installer has no engine inside. On first start the app shows the engine for your
+ graphics card with its size and one **Download** button, with progress and resume. If you already downloaded the
+ engine file, choose **I already have the file** and it installs without internet. The Mac file keeps its small
+ Metal engine inside.
+ 4. Choose a model and its storage folder, let it download, then chat. DeepSeek V4.1-Flash is in the model list on
+ the supported cards ([model page](MODELS.md#deepseek-v41-flash)); it has three sizes, an 8K context and a **Speed**
+ choice, Faster or Full quality.
+
+ The `strata-engine-…` and `strata-control-…` archives on the release page are components, not installers. The
+ installer is the same file for a first install and for an update. There is no Intel desktop installer yet; Intel Arc
+ runs on Linux only, through the [Terminal](INTEL_ARC.md).
+
+ The first launch can take time to check and prepare large model files. Watch its progress and logs; there is no fixed
+ startup time for every model or computer. Closing the desktop app stops its managed engine.
+
+ The provider order recommended here is **ISTA-DASLab, Unsloth, Gyro, then others**, when a compatible pack fits.
+ Current app recommendations can differ; choose the model explicitly when you want a particular provider.
## The Terminal
diff --cc docs/STRIX_HALO.md
index 2b89cdf53,41304ac9b..551fdacde
--- a/docs/STRIX_HALO.md
+++ b/docs/STRIX_HALO.md
@@@ -1,26 -1,47 +1,47 @@@
# Strix Halo (Ryzen AI Max, gfx1151)
- Strata runs on the Ryzen AI Max "Strix Halo" APUs (Radeon 8060S / 8050S, RDNA3.5, `gfx1151`, one pool of LPDDR5X shared by the
- CPU and the GPU) through the same HIP backend as the Radeon cards in [AMD_HIP.md](AMD_HIP.md). **Status: experimental.**
- Everything here was built and measured on one machine, the maintainers' Strix Halo box (Ryzen AI Max+ 395, 128 GB,
- Ubuntu 26.04, kernel 7.0, ROCm 7.14.1). Setup (`setup.sh`, `START-HERE.bat`) recognizes it from 0.1.40, by its PCI id (`1002:1586`, one id for the 8060S, 8050S and 8040S) and by
- `gfx1151` exactly: a Strix Point (890M / 880M, gfx1150), Krackan (860M / 840M, gfx1152) or Phoenix / Hawk Point (780M / 760M, gfx1103) Radeon is
- named as what it is and not supported. On Linux setup compiles the engine for gfx1151 itself (the steps below are the same, by hand). The 0.2.0-beta release also has ready-made packages: `Strata-0.2.0-beta-linux-amd-strixhalo.AppImage` (engine `halo`, gfx1151, ROCm 7.14.1) and, on Windows, `Strata-0.2.0-beta-windows-hip-rdna3.exe` (engine `rdna3`: gfx1100, gfx1101, gfx1102 and gfx1151, ROCm 10.2.0a20260930); any app installer plus **Update engine** (or `strata update`) fetches the same package. What was run: both packages were built, linked and scanned, and the Linux package refuses to start on a card of another family (tried on an RX 9000 card); the maintainers have no Strix Halo and ran neither on one. The measurements on this page come from source builds on Linux (the maintainers' earlier box and community machines). Nobody has run a Strix Halo on Windows. The packaged engines do not carry the hipBLASLt table of section 3 yet (planned for 0.2.1), so their prompt reading is slower than the numbers below until then. A Windows zip of the 0.1.x START-HERE route without gfx1151 code is refused with a message, never used. Setup counts the GPU's memory as the BIOS carve-out plus the shared memory
- (the GTT pool; on Windows half the RAM) and recommends UD-IQ4_XS from about 80 GB of memory; it changes no BIOS or kernel setting.
+ This page is for people with a Ryzen AI Max "Strix Halo" PC (Radeon 8060S / 8050S, RDNA 3.5, `gfx1151`, one pool of LPDDR5X
+ shared by the CPU and the GPU). Strata runs there through the same HIP backend as the Radeon cards in [AMD_HIP.md](AMD_HIP.md).
+ **Status: experimental.**
- **Windows start-up (0.2.1.2).** On a Strix Halo under Windows the engine no longer registers the expert arena with the GPU driver: registering it took all free VRAM (91 GiB before, 0 after, on a 64 GB carve-out + 32 GB shared PC), the expert cache got no slots and the engine stopped with "the embedding buffer failed" (0.2.1 and earlier). The arena stays in RAM, held by the working-set lock, and the cache gets its normal slots. `STRATA_ARENA_PIN_GIB=N` (or `0`) registers it as before, `STRATA_UMA_REGISTER=1` too. Linux is unchanged.
+ DeepSeek V4.1-Flash does not run on Strix Halo yet. It runs in the app and the Terminal on NVIDIA RTX 30, 40 and 50 cards and on the Radeon AI
+ PRO R9700 ([MODELS.md](MODELS.md#deepseek-v41-flash)).
- What the engine does differently on this chip:
+ > **On this page:** [Quick start](#quick-start) · [What the engine does differently](#what-the-engine-does-differently) ·
+ > [1. Toolchain](#1-the-toolchain-no-root-needed) · [2. Engine](#2-the-engine) · [3. Tuning table](#3-the-prompt-table-and-running) ·
+ > [4. Defaults](#4-what-is-on-by-default-on-gfx1151) · [5. Opt-in](#5-what-is-not-on-by-default-it-changes-bits) ·
+ > [5b. Desktop and RAM](#5b-the-desktop-the-ram-and-a-discrete-card-beside-the-strix-halo-linux) · [6. Measured](#6-measured) ·
+ > [History](#history--older-measurements)
- - **Unified memory.** The GPU's "VRAM" is the GTT pool of the same RAM. `device_free_bytes()` (the figure `--expert-cache auto` and
- the memory plan use) counts what Linux can give back (`MemAvailable` less 6 GiB for the system, `STRATA_UMA_HEADROOM_GIB`
- changes the 6) instead of only `MemFree`, per device, for any integrated GPU on Linux (this applies to a DGX Spark too).
+ ## Quick start
+
+ Use the [current release](https://github.com/Niko1221/Strata/releases/latest). You do not need to build ROCm for a packaged install.
+
+ | System | What to install | Engine variant |
+ | --- | --- | --- |
-| Linux | `Strata-0.2.5-linux-x86_64.AppImage` (it downloads the engine on first start), or `strata launch` | `linux-x86_64-hip-halo` |
-| Windows | `Strata-0.2.5-windows-x64-setup.exe` (it downloads the engine on first start), or `strata launch` | `windows-x86_64-hip-rdna3` |
++| Linux | `Strata-0.2.6-linux-x86_64.AppImage` (it downloads the engine on first start), or `strata launch` | `linux-x86_64-hip-halo` |
++| Windows | `Strata-0.2.6-windows-x64-setup.exe` (it downloads the engine on first start), or `strata launch` | `windows-x86_64-hip-rdna3` |
+
+ Packaged engines carry the matching hipBLASLt tuning table for gfx1151 and select it on their own. Setup recognizes `gfx1151` and
+ PCI ID `1002:1586`; other integrated Radeon chips have separate support limits. Unified memory is counted once. Setup does not
+ change BIOS or kernel settings. The manual Linux toolchain below is for reproduction and builds, not a prerequisite for the app.
+
+ ## What the engine does differently
+
+ - **Unified memory.** The GPU's "VRAM" is the GTT pool of the same RAM. `device_free_bytes()` (the figure `--expert-cache auto`
+ and the memory plan use) counts what Linux can give back (`MemAvailable` less 6 GiB for the system; `STRATA_UMA_HEADROOM_GIB`
+ changes the 6) for any integrated GPU on Linux, a DGX Spark included.
- **gfx11 matrix cores.** The prompt attention, the block scorer, the prompt GEMMs and the prompt experts have WMMA kernels for
- gfx1100 / 1101 / 1102 / 1103 / 1150 / 1151. A gfx11 part outside that list (gfx1152) is not given them: it takes the portable path.
- - **The hipBLASLt table** `tools/hip/gfx1151-hipblaslt-100401.txt` (ROCm 7.14.1's hipBLASLt 1.x `100401`), including the prompt shapes
- at `--prefill 16384` (T 16383 / 16384). Setup's own ROCm for gfx1151 (the 7.14.0a20260608 wheels, hipBLASLt 1.4.0) takes
- `tools/hip/gfx1151-hipblaslt-100400.txt`: the same shapes, calibrated against that library (docs/AMD_HIP.md, Tuning table).
- - **The expert cache and the RAM budget share the RAM.** For a model with a RAM budget (UD-IQ4_XS, UD-Q4_K_XL) setup writes a number for `--expert-cache` (the RAM less 24 GB less the budget), not `auto`: `auto` counts all the memory the OS can give back at start, and with a 55 GiB budget and a desktop open it took the room the OS needed (#1715, a global OOM on a 128 GB box). The number is in the config's `args`; `--expert-cache N` there sets it. An engine run by hand should pass one too.
+ gfx1100 / 1101 / 1102 / 1103 / 1150 / 1151. A gfx11 part outside that list (gfx1152) takes the portable path.
+ - **The hipBLASLt table.** `tools/hip/gfx1151-hipblaslt-100401.txt` is for ROCm 7.14.1's hipBLASLt (`100401`), including the prompt
+ shapes at `--prefill 16384`. Setup's own ROCm for gfx1151 (the 7.14.0a20260608 wheels, hipBLASLt 1.4.0) takes
+ `tools/hip/gfx1151-hipblaslt-100400.txt`, calibrated against that library.
+ - **The expert cache and the RAM budget share the RAM.** For a model with a RAM budget (UD-IQ4_XS, UD-Q4_K_XL) setup writes a number
+ for `--expert-cache` (the RAM less 24 GB less the budget), not `auto`, because `auto` counts all memory the OS can give back at
+ start and can take the room the OS needs. The number is in the config's `args`. An engine run by hand should pass one too.
+ - **Windows.** The engine does not register the expert arena with the GPU driver. The arena stays in RAM, held by the
+ working-set lock, and the expert cache gets its normal slots. `STRATA_ARENA_PIN_GIB=N` (or `0`) or `STRATA_UMA_REGISTER=1`
+ registers it. Linux registers the whole arena by default.
## 1. The toolchain (no root needed)
diff --cc docs/TROUBLESHOOTING.md
index df94d8bb0,aa7c4d42f..1c5035cb1
--- a/docs/TROUBLESHOOTING.md
+++ b/docs/TROUBLESHOOTING.md
@@@ -5,142 -15,90 +15,90 @@@ strata launch --statu
## The desktop app and the Terminal
- **A warning says Strata "couldn't find an engine for this computer".**
- The engine is the part that talks to your graphics card. Strata only warns and still downloads the
- model, and the model files stay on your computer, but the model may not run until the right engine is installed. The usual
- reasons are that no engine is installed yet and the update source has none for your card, that the engine found is for
- another make of card, or that the graphics driver is too old. In the app, open Settings, then Engine. In the Terminal, the
- message names the next step: run `strata update` and start again. If your computer has no NVIDIA or AMD graphics card
- (only an Intel UHD or Iris chip, an AMD processor graphics chip, a virtual machine, or Windows on ARM), Strata says so and
- there is nothing to install: it needs a computer that has one. The model files stay where they are.
-
- **"This model needs a newer engine." (the app), or a button called Update engine.**
- Some models need an engine newer than the one installed: Gyro needs 0.1.45.1 or newer, NVFP4 needs 0.1.44, and NVFP4 (NVIDIA,
- trained for FP4) needs 0.1.45. In the app, open Settings, then Engine, and press Update engine. It asks first, keeps your
- model files and settings, and wants running models unloaded. In the Terminal: `strata update --check` says what would
- change, `strata update` installs it (it switches to the new engine only after a test start). If the engine you
- installed is the newest and the message stays, the update source has no newer engine for your card yet.
-
- **On a Mac: "Strata is damaged and can't be opened", "cannot be opened", or "unidentified developer".**
- Nothing is wrong with the file. macOS marks everything a browser downloads, and only lets a marked program run if Apple
- has checked it. Strata's release builds are checked by Apple ("notarised"): drag Strata onto Applications and open it; the
- first time, macOS asks "Are you sure you want to open it?" and you press Open. A test build that is not notarised says
- "damaged". Do not move it to the Trash. Open the Terminal app and remove the mark, with the line that matches what you have
- (drag the file from Finder into the Terminal window to type its path):
-
- xattr -dr com.apple.quarantine ~/Downloads/<the .dmg file> # the .dmg, before opening it
- xattr -dr com.apple.quarantine /Applications/Strata.app # the app, after dragging it over
- xattr -dr com.apple.quarantine <the folder you unzipped> # an unzipped Terminal folder
-
- Then open it again. If macOS says only "the developer cannot be verified", you can instead try to open it once, then open
- System Settings > Privacy & Security and press "Open Anyway" next to the message about Strata. Installs made with
- `curl ... | sh` carry no mark and need none of this. To see which kind you have: `spctl -a -vv /Applications/Strata.app`
- answers "accepted" and "Notarized Developer ID" for a notarised build. (How the builds are signed: `packaging/mac/README.md`.)
-
- **Checking what is installed: `strata doctor`.**
- It is a read-only check of the installed engine parts (it changes nothing): which engine and helper files a saved model
- needs, and whether they are there. `strata doctor --live` also asks the computer which graphics cards it sees and compares
- them with the cards the model is set to use; `--output json` prints the same as data. Put its output into a bug report.
-
- **Sending logs for a bug report.**
- In the app: Settings, Engine, Diagnostics, View logs, then Save logs. It writes one text file,
- `strata-diagnostics-<date>.txt`, into your Downloads folder and shows where. It holds the engine's messages, the failed
- steps and the end of each model's server log. In the Terminal, send the output of `strata doctor`. If the Linux app window
- crashes or will not open, run the AppImage with `--save-logs` in a terminal instead; it writes the crash log and the other
- logs to one file in Downloads. If the Windows app closes right after you start it, it shows a message with the reason and writes
- `desktop-crash-<date>.log` in `%LOCALAPPDATA%\Strata\logs`; Save logs includes it, and so can you, by hand. Look through a log before you send it, and never send an API key.
+ **I cannot find `START-HERE.bat` or `SETUP.bat`.**
+ Open the installed Strata app, or run `strata launch`. Those wrappers are in the source repository and are not the
+ startup path for the app. For a fresh desktop install, download the one installer for your system
-(`Strata-0.2.5-windows-x64-setup.exe`, `Strata-0.2.5-linux-x86_64.AppImage` or `Strata-0.2.5-macos-arm64.dmg`), not a
++(`Strata-0.2.6-windows-x64-setup.exe`, `Strata-0.2.6-linux-x86_64.AppImage` or `Strata-0.2.6-macos-arm64.dmg`), not a
+ `strata-engine-…` archive.
- ## While installing or starting
+ **`strata` is not found.**
+ On Windows, open a new PowerShell window after installing. On Linux or Mac, use the full path the installer printed,
+ normally `~/.local/bin/strata`, and add `~/.local/bin` to PATH if needed. Check `strata --version`.
+
+ **Strata could not find an engine for this computer.**
+ Run `strata doctor --live` and `strata update --check`. Check the selected GPU, driver and
+ [backend guide](INSTALL.md#what-you-need). Supported paths include Apple Silicon and Intel Arc on Linux; do not
+ assume every machine without an NVIDIA/AMD discrete card is unsupported. A model download can finish even when
+ no engine starts. Verify `strata launch --status` and `/health` before calling the installation successful.
- **My PC froze, or got very slow, the first time Strata started.**
- That's normal while it starts, most of all the first time. Strata loads 35-55 GB into your RAM, locks part of it for
- the graphics card, and works out how much of the model fits on your GPU. The mouse can freeze for a few minutes.
- **Wait, and don't close the window.** The next starts are much faster. Still frozen after 10 minutes? Restart the
- PC, close other programs (browsers use a lot of RAM) and try again. If it keeps happening, pick a smaller size (Q2_0
- or IQ2_XS).
-
- **The engine stops while it starts, on a small graphics card or a PC with little RAM. Can I turn the draft layer (MTP) off?**
- Yes. The draft layer is what makes answers faster, and it takes about 1 GB of graphics memory (plus some RAM and a memory
- copy that grows with the context). Without it the expert cache gets that memory back and answers are slower. Turn it off
- for one model: in the app, Models, Expert settings, "Draft layer (MTP)": Off; in the Terminal,
- `strata launch --model q2_0 --mtp off` (older Terminals: `--set mtp=off --set spec-min-p=off`); by hand, add `"mtp": false` to the
- model's `strata-<model>.json`. The choice is kept per model and applied on every start.
-
- **I changed `strata-<model>.json` by hand and the change came back.**
- Engine options you add to `args` by hand (control vectors, `--spec`, `--vram-reserve-mib 0`, anything the app does not offer)
- are kept. The file has two helper keys for this. `user_args` lists your options; every start and every setup run puts them
- over the ones the app generates, and for the same option your value wins. `args_written` is a copy of `args` as the app last
- wrote it, so an option you added or changed in `args` is noticed and moved into `user_args` the next time the app or setup
- touches the file. To undo one, delete it from both `args` and `user_args`. A value you save in the app's Expert settings
- ("GPU memory for other apps") is put in `user_args` for you.
-
- Two things the app still chooses itself: the context size, KV type, picture reading and draft layer. Set them in the Models
- screen, or with `"mtp": false` (draft layer). The app keeps the earlier file as `strata-<model>.json.bak`.
-
- **The app keeps more graphics memory free than I want (decode is slower than in 0.1.45).**
- Without a value of yours the app keeps 1536 MiB free (2048 with picture reading) on a card that drives a display, and 512 MiB
- (700 with pictures) on a card that has no display attached, such as a second GPU with the screen on the integrated one. It
- reads that from the driver (nvidia-smi `display_active`, or the Windows adapter that has the desktop); when it cannot tell, it
- assumes a display. Your own value is never raised or lowered: set "GPU memory for other apps" in Expert settings, or
- `--vram-reserve-mib 0` in `args`. The engine's own warning about low free memory stays; a card that also draws the desktop
- can freeze or slow to a few tokens a second with a very small reserve.
-
- **It stopped while downloading or installing.**
- Run `START-HERE.bat` (Linux: `./setup.sh`) again. It continues where it stopped.
-
- **It says the NVIDIA driver is too old.**
- Update it (NVIDIA App or [nvidia.com/drivers](https://www.nvidia.com/drivers)), restart the PC, and run
- `START-HERE.bat` again.
-
- **It says port 8080 is already in use.**
- Strata is already running. Look for its window. Or another program uses the port: `START-HERE.bat --port 8081`.
- Only an address that is really taken says "already in use". Any other reason (Windows keeps the port reserved, or
- the config's `"host"` is not an address of this PC) is printed as what the OS said, with what to change (#769).
-
- **"Windows blocked the Strata engine (or the image encoder) ... Smart App Control".**
- On a clean Windows 11, Smart App Control refuses programs that are not signed, and Strata's `strata.exe` and
- `strata-vision.exe` are not (#735). Turn it off (Windows Security > App & browser control > Smart App Control
- settings; it cannot be turned back on without a reset of Windows), or, if only the image encoder is blocked, run
- `START-HERE.bat --setup --vision no`.
+ **This model needs a newer engine.**
+ Unload running models, then use the app's engine update or `strata update`. Minimum engine versions vary by model and
+ backend. Check the model guide and the installed engine, not only the app version. If the feed has no compatible engine,
+ report the missing combination.
+
+ **An update says it succeeded but `strata --version` is still old.**
+ The Terminal switches to the updated Control on the next command, so run `strata --version` again. If it is still old,
+ run the one-line installer once more; it keeps models and settings. The app, Control and engine have separate version
+ numbers; see [updating](INSTALL.md#updating) and the [release notes](https://github.com/Niko1221/Strata/releases).
**A new engine misbehaves after an update.**
- An update keeps the engine it replaced in `engine\.previous` (one generation, about 210 MiB).
- `python setup.py --rollback-engine` puts it back (and keeps the newer one there: run it again to go forward) (#670).
-
- **UPDATE.bat / update.sh say "git pull did not succeed", or "has no commit in common" (#1276).**
- The repository's history was cleaned up on 2026-10-06, so a clone made before that cannot be updated with `git pull`.
- The 0.1.40.2 scripts handle it: when no tracked file is edited they keep your old commits in the branch
- `pre-cleanup-backup` and move the clone to the new history; otherwise they print the two commands for you. Your models,
- settings and engine are untracked files and are never touched. An older UPDATE.bat / update.sh (before 0.1.40.2) cannot
- do this itself: run these once in the Strata folder, then use UPDATE.bat as usual (add `git stash` first if `git status`
- lists edited files):
-
- git fetch origin
- git branch pre-cleanup-backup
- git checkout -B main origin/main
-
- **Python or the build tools could not be installed.**
- Install what it names (links are printed), then run it again. Everything already done is kept.
-
- **Linux: the engine does not compile (`unsupported GNU version`, or `exception specification is incompatible` for
- `cospi`/`sinpi`/`rsqrt`).** Two known mismatches between the CUDA toolkit and a new Linux (#601):
- - gcc newer than 14 (Ubuntu 26.04's default 15): CUDA 12.x and 13.0 refuse it. Install g++-14 and run
- `CXX=g++-14 ./setup.sh` (CC, CXX and CUDAHOSTCXX name the build's compilers; setup passes them to CMake itself,
- so an already-configured build folder picks them up too, #1645).
- - glibc 2.43 with CUDA 12.9: the toolkit's math headers clash with glibc's, already in CMake's first test compile.
- Use CUDA 12.8 or 13.x instead. Setup takes the newest toolkit it finds; `STRATA_NVCC=/usr/local/cuda-12.8/bin/nvcc
- ./setup.sh` makes it use that one (only that one).
-
- **The first start takes minutes.**
- It is reading 34-55 GB into RAM; the second start is faster while the files are in the OS cache. Started from Task
- Scheduler, it can be 24x slower: see [Running it at startup](DETAILS.md#running-it-at-startup-task-scheduler).
- On Linux the engine now asks the kernel to read the model files ahead (a cold start went from ~920 s to 70 s on one
- PC); `STRATA_READ_AHEAD=0` turns that off. On Linux with transparent huge pages on `always`, the arena no longer asks
- for `MADV_HUGEPAGE` on top (a fragmented machine spent minutes compacting memory, #771); `STRATA_NO_ARENA_THP=1` skips
- that request on any setting.
-
- **Setup says the engine does not match GitHub's checksum.**
- Setup checks the downloaded ready-made engine against the SHA-256 GitHub publishes. On a mismatch the file is corrupt or was changed on the way, so setup deletes it and stops; run setup again to download it afresh. If GitHub gives no checksum (offline, rate limited, your own mirror), setup warns and installs anyway. `STRATA_SKIP_SHA256=1` skips the check, only if you insist.
+ Stop the model, then use the app's rollback control or `strata components rollback`. Source-checkout engines use a
+ separate rollback workflow, `python setup.py --rollback-engine`, described in [source setup](SOURCE_INSTALL.md).
+
+ **The Mac app cannot be opened.**
+ Check that the download is for Apple Silicon and that macOS is 15 or newer. Follow
+ [Mac installation](MAC.md#the-desktop-app-and-strata-launch-on-a-mac). A warning alone does not establish that a file
+ is safe or intact: verify the download source and release before changing quarantine settings. Release signing and
+ test-build handling are described in [Mac packaging](../packaging/mac/README.md).
+
+ **The Linux AppImage does not open.**
+ Make the downloaded file executable. It may need FUSE 2 (`libfuse2` on Ubuntu 22.04, `libfuse2t64` on newer Ubuntu;
+ package names vary by distribution). Without FUSE, run the file with `--appimage-extract-and-run`. For a crash log,
+ run it with `--save-logs`; see the logs section below.
+
+ ## While installing or starting
+
+ **A download stopped.**
+ Retry it in the app, or rerun the same `strata launch` command. Completed model-download steps are reused. Check
+ free space and the error message. For an interrupted Terminal installer, rerun the install command. Only a source
+ checkout uses `START-HERE.bat` / `./setup.sh` to resume source setup.
+
+ **Startup takes a long time or the computer becomes slow.**
+ Large models need time to check files, prepare packs and fill memory. A first launch can take many minutes; there is
+ no fixed startup time. Watch progress and the engine log. If memory pressure is high, close memory-heavy programs and try a
+ smaller model or context. DeepSeek V4.1-Flash needs 46 GB of RAM at least ([model page](MODELS.md#deepseek-v41-flash));
+ `strata launch --plan --family deepseek41 --model ist-das-2.00bpw` shows what your computer is missing.
+
+ **The NVIDIA driver is too old.**
+ Use the driver required by the engine package. CUDA 13 needs driver 580 or newer; older cards use the
+ [CUDA 12 route](OLDER_GPUS.md). After updating the driver and restarting if needed, open the app or rerun
+ `strata launch`.
+
+ **Port 8080 is already in use, or I changed a running model's settings.**
+ Check `strata launch --status`. To replace your existing launch, rerun the intended command with `--restart`;
+ it stops current answers. To run beside it, choose another port, for example `--port 8081`, if memory permits.
+ Do not stop an unrelated program just because it holds the port. `--yes` alone does not restart a running model.
+
+ **The engine stops on a small GPU or low-memory computer.**
+ Try a smaller pack or context. The draft layer also uses memory. In the app, set the model's Draft layer to Off;
+ in the Terminal, an explicit example is:
+
+ ```sh
+ strata launch --family qwen --model q2_0 --context 32k --mtp off
+ ```
+
+ Use `--restart` if replacing an active run. Turning MTP off can slow decoding. Keep some VRAM free for the display;
+ setting the reserve to zero is not a general speed fix.
+
+ **Pictures do not work.**
+ The model, backend and installed engine package must include a compatible picture reader. Inspect the startup
+ error and the model guide. `--vision off` disables reading pictures; it is different from optional
+ [image generation](IMAGES.md). In the Terminal, use `on|off|gpu|cpu`, not source setup's `yes|no` spelling.
+
+ **Windows blocks an executable.**
+ Verify the official release and the component named in the message. Feed signatures and Windows code-signing are
+ different checks. If only the picture reader is blocked, `--vision off` may let text requests run. Do not disable
+ system-wide protection as the routine installation fix; include the blocked file and exact message in a bug report.
## While it answers
diff --cc packaging/UPDATES.md
index 197af8c9a,74258e17b..0363b627a
--- a/packaging/UPDATES.md
+++ b/packaging/UPDATES.md
@@@ -30,15 -36,15 +36,15 @@@ Comments are for this document only; ac
"sequence": 12, // goes up with every feed; an older one than the last accepted is refused
"generated_at": "2026-10-20T10:00:00Z", "expires_at": "2027-10-20T10:00:00Z", // expires_at may be null
"app": { // exactly Tauri's static updater JSON, plus sha256/size per platform
- "version": "0.2.0", "notes": "...", "pub_date": "2026-10-20T10:00:00Z",
- "platforms": {"windows-x86_64": {"url": "app/Strata_0.2.0_x64-setup.exe", "signature": "<minisign, base64>", "sha256": "...", "size": 71000000}}
+ "version": "0.2.5", "notes": "...", "pub_date": "2026-10-20T10:00:00Z",
- "platforms": {"windows-x86_64": {"url": "app/Strata-0.2.5-windows-x64-setup.exe", "signature": "<minisign, base64>", "sha256": "...", "size": 71000000}}
++ "platforms": {"windows-x86_64": {"url": "app/Strata-0.2.6-windows-x64-setup.exe", "signature": "<minisign, base64>", "sha256": "...", "size": 71000000}}
},
- "control": {"version": "0.1.48", "packages": [{"platform": "linux-x86_64", "format": "tar.gz", "url": "control/...tar.gz",
+ "control": {"version": "0.1.50", "packages": [{"platform": "linux-x86_64", "format": "tar.gz", "url": "control/...tar.gz",
"size": 0, "sha256": "...", "installed_bytes": 0, "entry": "strata.py"}]},
"engine": {"packages": [{
- "version": "0.1.48", "platform": "linux-x86_64", "backend": "cuda", "variant": "cuda13",
+ "version": "0.1.50", "platform": "linux-x86_64", "backend": "cuda", "variant": "cuda13",
"archs": ["sm_75", "sm_86", "sm_89", "sm_120", "compute_120"], "min_driver": {"nvidia": "580.65"}, "min_runtime": null,
- "build_id": "be885026f96a-cuda13.0", "format": "tar.gz", "url": "engine/strata-engine-0.1.48-linux-x86_64-cuda-cuda13.tar.gz",
+ "build_id": "be885026f96a-cuda13.0", "format": "tar.gz", "url": "engine/strata-engine-0.1.50-linux-x86_64-cuda-cuda13.tar.gz",
"size": 505568970, // bytes of the archive
"sha256": "...", // of the archive
"manifest_sha256": "...", // of the package's engine-component.json (it holds every file's hash)
@@@ -119,7 -131,7 +131,7 @@@ All signing happens on the release PC,
**What is built (per OS)**
* *The installer*, one per OS (0.2.5). The Windows and Linux ones have no engine inside: built with `--config src-tauri/tauri.update.conf.json`, which drops `engine-bundle`. The Mac dmg keeps its small Metal engine (one Mac variant).
-- Windows: `Strata-0.2.5-windows-x64-setup.exe`; Linux: `Strata-0.2.5-linux-x86_64.AppImage`; Mac: `Strata-0.2.5-macos-arm64.dmg` for people and
++ Windows: `Strata-0.2.6-windows-x64-setup.exe`; Linux: `Strata-0.2.6-linux-x86_64.AppImage`; Mac: `Strata-0.2.6-macos-arm64.dmg` for people and
`Strata.app.tar.gz` as the updater archive (the updater cannot install from a dmg). The Windows and Linux files are both the first download and the
file `latest.json` names; the first start of the app downloads the engine for the card (the first-run card), or installs a file the person already has.
Why: an app update must not carry an engine, and the right engine depends on the card. Engines come per card from the signed feed
@@@ -137,10 -149,10 +149,10 @@@
# Linux: tauri build --bundles appimage (no engine inside) is the AppImage
# on the release PC, per updater artifact (Windows setup .exe, Linux .AppImage, Mac Strata.app.tar.gz):
npx tauri signer sign -f <path to tauri-updater.key> <artifact> # writes <artifact>.sig
-- python packaging/feed_tool.py set-app-platform --app-json RELEASE/tauri-latest.json --target windows-x86_64 --version 0.2.5 --archive Strata-0.2.5-windows-x64-setup.exe --sig Strata-0.2.5-windows-x64-setup.exe.sig --notes "..."
-- python packaging/feed_tool.py set-app-platform --app-json RELEASE/tauri-latest.json --target linux-x86_64 --version 0.2.5 --archive Strata-0.2.5-linux-x86_64.AppImage --sig Strata-0.2.5-linux-x86_64.AppImage.sig
++ python packaging/feed_tool.py set-app-platform --app-json RELEASE/tauri-latest.json --target windows-x86_64 --version 0.2.5 --archive Strata-0.2.6-windows-x64-setup.exe --sig Strata-0.2.6-windows-x64-setup.exe.sig --notes "..."
++ python packaging/feed_tool.py set-app-platform --app-json RELEASE/tauri-latest.json --target linux-x86_64 --version 0.2.5 --archive Strata-0.2.6-linux-x86_64.AppImage --sig Strata-0.2.6-linux-x86_64.AppImage.sig
python packaging/feed_tool.py set-app-platform --app-json RELEASE/tauri-latest.json --target darwin-aarch64 --version 0.2.5 --archive Strata.app.tar.gz --sig Strata.app.tar.gz.sig
- python packaging/feed_tool.py build-feed --out RELEASE --sequence N --key <feed-key.json> --engine RELEASE/engine --control RELEASE/control --app-json RELEASE/tauri-latest.json
+ python packaging/feed_tool.py build-feed --out RELEASE --sequence N --key <feed-key.json> --engine RELEASE/engine --control RELEASE/control --app-json RELEASE/tauri-latest.json [--dsv41 RELEASE/dsv41]
python packaging/feed_tool.py verify-feed RELEASE --pub <feed-key.pub.json>
`set-app-platform` checks each `.sig` against the public key in `tauri.conf.json` over the exact bytes, so a file signed with another key, or changed after