Repository navigation
am2Strata v0.1.8: a Workshop for making models and training data, a sandbox VM for computer use, HTTPS, API keys
with usage, one live WebSocket channel, installers for six platforms, and a regression suite.
Install or update
Linux (x86_64, arm64) and macOS (Apple silicon, Intel):
curl -fsSL https://github.com/abhaymin/am2strata/releases/latest/download/install.sh | shWindows (x64, Arm64), in PowerShell:
irm https://github.com/abhaymin/am2strata/releases/latest/download/install.ps1 | iexRunning it again over an earlier version keeps your models and settings. am2strata-run doctor then lists each
optional feature and what this machine still needs for it.
On Linux arm64, Intel Macs and Windows Arm64 the Rust engine runs on the CPU only. The Computer tab's desktop and the
sandbox VM are Linux-only; the VM also needs an x86_64 PC with KVM.
New
Workshop (a new tab, and am2strata-run workshop)
- Convert a Hugging Face Llama-family model to GGUF, byte for byte as llama.cpp's converter writes it; quantize
it (Q8_0, Q6_K, Q5_K, Q4_K, Q4_0, asllama-quantize --pure); merge a LoRA adapter from Unsloth or PEFT into its
base; install the result so it appears in the model list. All in Rust, no Python. - Training data written by the model you have loaded: questions and answers or multi-turn chats from your
documents (text, Markdown, code, HTML, PDF), or more examples like your own. Near-duplicates are dropped, an optional
judge pass scores each answer against its source, and every dataset gets a card. Review, edit and delete records in
the tab. - LoRA training from the command line (CPU):
am2strata-workshop trainfine-tunes Llama, Mistral and Qwen
models on a chat dataset, with checkpoints that resume exactly and a PEFT adapter the Workshop's merge takes.
For small machines: a half-precision base, training only the top layers with their inputs cached on disk, and
profile/autopilotto estimate memory and time and pick settings that fit;find-lr;soup.yamlconfigs
are read, and what is not supported is named. Its outputs match the reference implementation to 1e-5. - Jobs run one at a time in a separate process, and only inside the Workshop's folders.
Sandbox VM for computer use (Linux)
- A Debian 13 virtual machine am2Strata creates and runs itself (QEMU with KVM; no root, no Docker). The agent is root
inside it and can install or remove anything; this PC is untouched. Turn it on with
Settings › Computer and browser use › Mode: Sandbox VM, or use it yourself from the Computer tab. - Light: it only gets CPU time that nothing else is using, has a memory ceiling, no GPU, pauses when unused, and is then
saved to disk; a start restores it with its open apps in about a second. - Apps: Chromium, Firefox ESR, Bitwarden, Tailscale, NetBird, Mullvad, Surfshark, WireGuard and OpenVPN, VS Code,
LibreOffice and more with one click; anything else by Debian package, Flathub id,.debor AppImage link. - Ads: a DNS filter with Pi-hole's default list, the AdGuard DNS filter or both, a let-through list for jobs that
must see a site as it is, and an "Ads and trackers" app on the VM's desktop. am2strata-run vm status|start|stop|install|exec|ads|settings.
The Computer tab
- See the desktop computer use works on, live; Take control to use it with your own mouse and keyboard while
the agent waits; copy and paste between your clipboard and its clipboard.
HTTPS and secure WebSockets
- Settings › Secure connection (and
am2strata-run tls): a self-signed certificate made for you, your own
certificate, or a Tailscale certificate browsers trust. HTTPS andwss://are on port 8001 by default. - Plain
http://andws://keep working beside it. You can instead send other devices, or everyone, to HTTPS; HSTS
is sent only when everyone is.
API keys and usage
- Make keys while the server runs (Settings › Clients,
am2strata-run keys): a name, tool sets, an expiry, daily
request and token limits, allowed models. A key is shown once and stored only as a hash. - A generated key opens the model APIs and never the server's settings.
- Usage per key and per model, per day: requests, tokens, media jobs, errors.
One live channel
GET /v1/liveoverws://orwss://: the server pushes status, the queue, jobs and Monitor figures when they
change, and any API request can be sent over the same socket with streamed answers and cancel.- The web app's chat runs over it: answers stream over the open socket, Stop cancels there, and tool approvals,
media job cards and the canvas go the same way. Without the socket (or for a message over 16 MB) the chat uses HTTP
as before; a connection that drops mid-answer keeps what arrived and offers Retry, never resending by itself. The
Monitor tab uses it too.am2strata-run liveprints the pushes for scripts.
Installers and platforms
- Downloads for Linux arm64, Intel Macs and Windows Arm64 join the existing three. The installers detect the OS and
CPU, check the download's SHA-256, install without sudo, and can uninstall.
Regression suite
- A contract table of every route (who may call it, and what each kind of caller gets), recorded response shapes for
the compatible APIs, and one test per bug class fixed before.am2strata-run regressionchecks a running server
after an update and prints a pass/fail table.
Fixed
- A chat request whose JSON body was not an object caused a server error; it is now a 400.
- Seven owner routes that change state did not refuse requests from another site's page.
- A request with a broken body is now refused for its missing key before its body is looked at.
- Training-data chunks could exceed their size limit when they held blank lines or indentation.
- Merging an adapter into a base stored in F16 or BF16 read the weights as F32; it now reads each dtype, takes a
singlemodel.safetensorsas well as shards, and copies the config and tokenizer into the output. - The zip library is updated past five published advisories (one critical).
- Writes from the web app's own page over HTTPS (HTTP/2) were refused as another site's; they work now.
- Tests no longer race on shared fixtures or on the process environment.
Notes
- Sign-ins inside the sandbox VM (a password manager, a VPN, a browser account) are yours: open the app in the
Computer tab, take control and sign in. - Training is command-line and CPU-only in this release: no Train card in the tab yet, no GPU training, no QLoRA
(4-bit base) and no MoE expert adapters. - The installer downloads a headless Chrome for the browser tool without a checksum;
--no-browserskips it.
What's Changed
- Tests: the agents setup/reset test gets its own home folder by @abhaymin in #11
- HTTPS, HSTS and wss on port 8001: self-signed, your own certificate, or Tailscale by @abhaymin in #12
- Tests: no environment changes in test threads (the flaky agents test); a longer worker wait by @abhaymin in #14
- Model Workshop: merge, convert, quantize and install models in Rust — tab, CLI and server jobs by @abhaymin in #13
- Computer tab: see and use the sandbox desktop live — take control, clipboard both ways, UI and CLI by @abhaymin in #15
- Workshop: training data from documents (UI, API, CLI) by @abhaymin in #16
- HTTPS: keep http:// and ws:// working beside https:// and wss:// by @abhaymin in #17
- API keys made at run time, with usage per key and per model by @abhaymin in #19
- Sandbox VM for computer use (Debian, self-managed, light on the host) by @abhaymin in #18
- The live channel: one WebSocket for pushed updates and requests (GET /v1/live) by @abhaymin in #21
- Installers for Linux, macOS (Apple silicon, Intel) and Windows (x64, Arm64), with a doctor report by @abhaymin in #20
- Regression suite: a contract for every route, golden response shapes, bug regressions and a live runner by @abhaymin in #22
- README, banner and social preview for v0.1.8 by @abhaymin in #25
- README: an at-a-glance infographic of v0.1.8 by @abhaymin in #26
- Tests pass on macOS and Windows; regression targets run there in CI by @abhaymin in #28
- Security: patch zip to 9.2.2 in the main workspace (5 Dependabot alerts, 1 critical) by @abhaymin in #29
- Workshop trainer, milestone 1: LoRA training in Rust after Soup (CPU) by @abhaymin in #31
- Docs and help: present am2Strata as its own product, one Credits section by @abhaymin in #30
- Web app: the chat over the live channel (HTTP as the fallback) by @abhaymin in #33
- Remote models (off by default) by @abhaymin in #32
- Release v0.1.8 by @abhaymin in #23
- Trainer CLI test: free RAM is unknown outside Linux by @abhaymin in #34
Full Changelog: v0.1.7...v0.1.8