abstractframework 0.2.1__tar.gz → 0.3.0__tar.gz

{abstractframework-0.2.1 → abstractframework-0.3.0}/CHANGELOG.md

@@ -2,6 +2,104 @@
 
 All notable changes to AbstractFramework will be documented in this file.
 
+## [0.3.0] - 2026-09-24
+
+A Mac install that needs no Terminal knowledge (a `.pkg` or a double-click `.command`, and an
+uninstaller), install failures explained in plain words, and the meta-package pins abstractcore
+2.15.0 and abstractgateway 0.4.1.
+
+### Changed (pins)
+
+- **abstractcore 2.15.0** (was 2.14.0) and **abstractgateway 0.4.1** (was 0.3.0; 0.4.0 was never
+  published), in the base install and in the `apple` / `gpu` extras
+  (`abstractgateway[apple|gpu]==0.4.1`). The bootstrap scripts install
+  `abstractgateway[<profile>,tray]==0.4.1` and, with `--with-console`, `abstractgateway-console`
+  0.8.0 (was 0.7.0). The other pins are unchanged: AbstractRuntime 0.4.33, abstractagent 0.3.13,
+  AbstractMemory 0.3.0, abstractsemantics 0.0.5, abstractvoice 0.11.4, abstractvision 0.3.29,
+  abstractmusic 0.1.15, abstractassistant 0.5.0.
+- Browser apps released with it (`--with-apps`, `npx`): `@abstractframework/continuum` 0.3.0 (was
+  0.2.0) and `@abstractframework/entity` 0.2.0 (was 0.1.0); flow 0.3.20, code 0.4.2 and observer
+  0.1.12 are unchanged.
+- The docs name the container images released with it: `ghcr.io/lpalbou/abstractgateway:0.4.1`
+  and `ghcr.io/lpalbou/abstractcore-server:2.15.0`.
+- `docs/backlog/planned/0859` states the real stack port map (observer 3001, continuum 3002,
+  code 3003, entity 3004, flow 3005), as `scripts/start-local.sh` and the gateway's
+  `STACK_PORTS` use.
+- `scripts/lib/packages.txt`: abstractgateway 0.4.1 depends on abstractcore directly
+  (`abstractcore>=2.15.0`), so its edge is `abstractcore:dep` (was `extra`).
+
+### Added
+
+- **A Mac install that needs no Terminal knowledge.** `scripts/lib/build_macos_installer.sh`
+  builds `AbstractFramework-Installer.pkg` (payload-free, "install for me only", no password) and
+  `AbstractFramework-Installer-macOS.zip` (`Install AbstractFramework.command` and
+  `Uninstall AbstractFramework.command`). Both open the same `install.sh` in Terminal with a
+  banner, so every step stays visible and logged; the browser opens AbstractFramework, signed in,
+  at the end. The script signs and notarizes the `.pkg` when given a Developer ID
+  (`AF_PKG_SIGN_IDENTITY`, `AF_NOTARY_PROFILE`); without one it says the build is unsigned.
+- **`scripts/uninstall.sh`**: asks before removing anything, removes the login item, the running
+  gateway and the gateway tool, and asks separately whether to delete your data (`--purge`) and,
+  when the installer added uv, uv with its Python and download cache (`--remove-uv`, about
+  2.5 GB after an Apple Silicon install). `--yes` runs without questions.
+- **`install.sh --interactive`** asks whether to start AbstractFramework at login (default yes; a
+  previous "no" is remembered) and, on `--uninstall`, the data and uv questions. Questions go to
+  the terminal, so it works through `curl | sh`. Answering "no" after an earlier "yes" removes the
+  login item and starts the gateway in the background.
+
+### Changed
+
+- **Every install failure says what to do next, in plain words.** `install.sh` checks internet
+  access to PyPI before changing anything (naming the proxy when one is set), recognises a
+  connection that drops mid-install, stops on folders it cannot write (with the exact
+  `sudo chown` fix), restarts itself natively when Terminal runs under Rosetta on Apple Silicon
+  (and explains the Terminal setting when piped), warns on macOS older than 13, and says why an
+  Apple Silicon Mac on macOS 13 gets the light profile. `install.ps1` has the same network check
+  and messages.
+- **Re-runs repair and stay quiet.** A gateway command that no longer starts (an interrupted or
+  damaged install) is reinstalled in place; a registered, running, unchanged login item is left
+  alone instead of restarted; an already-configured shell profile no longer produces a
+  `uv tool update-shell` warning. The health wait is 180 s (the first start loads the engines) with
+  a progress line every 15 s.
+- **The gateway's Network setting decides where it listens, not the installer.** `install.sh` and
+  `install.ps1` no longer pass `--host 127.0.0.1` to `abstractgateway service install` (it reset a
+  "Local network" choice to localhost on every re-run); they pass `--port` only. Without a login
+  item (background mode) they store the setting first (`abstractgateway network set localhost
+  --port N` when nothing is stored; a stored mode is kept and only the port aligned) and start plain
+  `abstractgateway serve`. Gateways without the `network` command keep the old
+  `serve --host 127.0.0.1 --port N`. The login item itself runs plain `serve` from
+  abstractgateway 0.4.1.
+- The installer ends with a short plain-language summary (where AbstractFramework is, that it
+  starts at login, the menu-bar icon, how to remove it) before the technical details.
+- `docs/install.md` is rewritten from a non-technical user's point of view (download, what you
+  will see, a table of every failure message and what to do, how to remove it); the one-line,
+  options and profile material follows under "Advanced". README and getting-started match.
+- **llama.cpp GGUF is back in the one-line install, without a compiler.** `install.sh` and
+  `install.ps1` take `llama-cpp-python` from upstream's prebuilt wheels for every profile, light
+  included: Metal 0.3.28 on Apple Silicon, CPU 0.3.35 on glibc Linux x86_64/aarch64 and Windows
+  x64 (`--find-links` on the package page of abetlen's wheel index, `--constraints
+  uv-constraints.txt`, `--no-build-package llama-cpp-python` so the PyPI sdist is never built).
+  Where no wheel exists (Intel Mac, musl Linux, Windows on ARM) or the wheel install fails, the
+  script installs without it and prints `GGUF (llama.cpp) skipped: no prebuilt wheel for this
+  machine; re-run with --full after installing a C compiler`. The summary's `GGUF:` line says what
+  was installed. `--full` builds llama.cpp from source, now in the light profile too. CI's
+  bootstrap smoke imports `llama_cpp` from the installed gateway on macOS, Linux and Windows and
+  checks GPU offload on macOS.
+
+### Known limitations
+
+These are unchanged from 0.2.1 (the same packages, checked with `uv pip install --dry-run
+--no-build` against both releases). The one-line installer is not affected by the first two: it
+installs the gateway, not `abstractassistant`, and builds pure-Python source packages.
+
+- A plain `pip install abstractframework` on Linux builds `evdev` from source (a C compiler and
+  kernel headers), through `abstractassistant` 0.5.0 → `pynput`.
+- `langdetect`, `antlr4-python3-runtime`, `encodec` and `transformers-stream-generator` are
+  published as source only; they are pure Python and build without a compiler.
+- `abstractframework[gpu]` on Linux needs glibc 2.35 or later (Ubuntu 22.04+): `mlx[cuda13]`,
+  pulled by `abstractvision[all-gpu]` through `mlx-gen`, has only `manylinux_2_35` wheels.
+- The macOS `.pkg` built by `scripts/lib/build_macos_installer.sh` is not signed yet, so
+  Gatekeeper asks the user to allow it ("Open Anyway").
+
 ## [0.2.1] - 2026-09-24
 
 Patch release: the one-line install works on a machine without a C compiler, and the

{abstractframework-0.2.1/abstractframework.egg-info → abstractframework-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: abstractframework
-Version: 0.2.1
+Version: 0.3.0
 Summary: Unified installer and documentation hub for the AbstractFramework ecosystem
 Author-email: Laurent-Philippe Albou <contact@abstractframework.ai>
 License: MIT
@@ -23,9 +23,9 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: abstractgateway==0.3.0
+Requires-Dist: abstractgateway==0.4.1
 Requires-Dist: abstractassistant==0.5.0
-Requires-Dist: abstractcore==2.14.0
+Requires-Dist: abstractcore==2.15.0
 Requires-Dist: AbstractRuntime==0.4.33
 Requires-Dist: abstractagent==0.3.13
 Requires-Dist: AbstractMemory==0.3.0
@@ -34,10 +34,10 @@ Requires-Dist: abstractvoice==0.11.4
 Requires-Dist: abstractvision==0.3.29
 Requires-Dist: abstractmusic==0.1.15
 Provides-Extra: apple
-Requires-Dist: abstractgateway[apple]==0.3.0; extra == "apple"
+Requires-Dist: abstractgateway[apple]==0.4.1; extra == "apple"
 Requires-Dist: abstractassistant[apple]==0.5.0; platform_system == "Darwin" and extra == "apple"
 Provides-Extra: gpu
-Requires-Dist: abstractgateway[gpu]==0.3.0; extra == "gpu"
+Requires-Dist: abstractgateway[gpu]==0.4.1; extra == "gpu"
 Requires-Dist: abstractassistant[gpu]==0.5.0; extra == "gpu"
 Dynamic: license-file
 
@@ -62,24 +62,31 @@ Think of it as an **agentic OS**: durable runs + replay-first observability + mu
 
 ## Quick start
 
-One line installs the gateway (no admin rights, no system Python), registers it as a login
-service, starts it on `127.0.0.1:8080`, and opens its web console already signed in. A first-run
-guide then sets up a local engine (Ollama, LM Studio, MLX, llama.cpp), downloads a model that fits
-your machine, and lists the apps:
+The installer sets up the gateway in your user account (no admin password, no system Python),
+asks whether to start it at login, starts it on `127.0.0.1:8080`, and opens its web console in
+your browser already signed in. A first-run guide then sets up a local engine (Ollama, LM Studio,
+MLX, llama.cpp), downloads a model that fits your machine, and lists the apps.
 
-```bash
-# macOS / Linux
-curl -LsSf https://raw.githubusercontent.com/lpalbou/AbstractFramework/main/scripts/install.sh | sh
-```
+- **Mac, no Terminal:** download and double-click
+  [AbstractFramework-Installer.pkg](https://github.com/lpalbou/AbstractFramework/releases/latest/download/AbstractFramework-Installer.pkg).
+  A Terminal window shows each step; press Return at its one question.
+- **macOS / Linux, one line:**
 
-```powershell
-# Windows 10 22H2+ / 11
-powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/lpalbou/AbstractFramework/main/scripts/install.ps1 | iex"
-```
+  ```bash
+  curl -LsSf https://raw.githubusercontent.com/lpalbou/AbstractFramework/main/scripts/install.sh | sh -s -- --interactive
+  ```
+
+- **Windows 10 22H2+ / 11** (PowerShell):
+
+  ```powershell
+  powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/lpalbou/AbstractFramework/main/scripts/install.ps1 | iex"
+  ```
 
-Add `--with-apps`, `--with-ollama` or `--with-lmstudio` for Node.js and local engines, `--print` to
-see every command first, and `--uninstall` to remove it. Options, the equivalent commands and
-uninstall details: [Install](docs/install.md).
+Every failure says what to do next; running the installer again repairs or upgrades in place. To
+remove it: `Uninstall AbstractFramework.command`, or
+`curl -LsSf https://raw.githubusercontent.com/lpalbou/AbstractFramework/main/scripts/uninstall.sh | sh`.
+Step by step, the failure table, options (`--with-apps`, `--with-ollama`, `--print`, …):
+[Install](docs/install.md).
 
 Already have Python? Either entry point works the same way: start it, then open the link it prints.
 
@@ -181,7 +188,7 @@ ABSTRACTGATEWAY_AUTH_TOKEN=<token> abstractgateway-console --url http://127.0.0.
 ```
 
 Container images are published for the gateway and the AbstractCore server:
-`ghcr.io/lpalbou/abstractgateway:0.3.0` and `ghcr.io/lpalbou/abstractcore-server:2.14.0`.
+`ghcr.io/lpalbou/abstractgateway:0.4.1` and `ghcr.io/lpalbou/abstractcore-server:2.15.0`.
 
 For artifact and runtime-resource investigation, see
 `docs/guide/runtime-artifacts.md`.
@@ -300,7 +307,7 @@ pip install "abstractframework[gpu]"
 | Apple | `pip install "abstractframework[apple]"` | macOS 14+ on Apple Silicon | 3.10–3.13 (F5-TTS voice cloning needs 3.11+) |
 | GPU | `pip install "abstractframework[gpu]"` | Linux / Windows with a CUDA or ROCm GPU | 3.10–3.13 (F5-TTS voice cloning needs 3.11+) |
 
-### Release matrix (abstractframework 0.2.1)
+### Release matrix (abstractframework 0.3.0)
 
 `abstractframework` pins every Python package with `==`, so one version of the
 meta-package always installs the same stack. The browser apps and Rust tools are
@@ -309,9 +316,9 @@ and tested together.
 
 | Registry | Package | Version |
 |---|---|---|
-| PyPI | `abstractgateway` | 0.3.0 |
+| PyPI | `abstractgateway` | 0.4.1 |
 | PyPI | `abstractassistant` | 0.5.0 |
-| PyPI | `abstractcore` | 2.14.0 |
+| PyPI | `abstractcore` | 2.15.0 |
 | PyPI | `AbstractRuntime` | 0.4.33 |
 | PyPI | `abstractagent` | 0.3.13 |
 | PyPI | `AbstractMemory` | 0.3.0 |
@@ -322,14 +329,14 @@ and tested together.
 | npm | `@abstractframework/flow` | 0.3.20 |
 | npm | `@abstractframework/code` | 0.4.2 |
 | npm | `@abstractframework/observer` | 0.1.12 |
-| npm | `@abstractframework/continuum` | 0.2.0 |
-| npm | `@abstractframework/entity` | 0.1.0 |
+| npm | `@abstractframework/continuum` | 0.3.0 |
+| npm | `@abstractframework/entity` | 0.2.0 |
 | crates.io | `abstractcode` | 0.5.1 |
-| crates.io | `abstractgateway-console` | 0.7.0 |
+| crates.io | `abstractgateway-console` | 0.8.0 |
 | crates.io | `abstractcore-console` | 0.2.0 |
 | crates.io | `abstracttui` | 0.6.0 |
-| GHCR | `ghcr.io/lpalbou/abstractgateway` | 0.3.0 (`gpu-latest` / `<version>-gpu` experimental) |
-| GHCR | `ghcr.io/lpalbou/abstractcore-server` | 2.14.0 |
+| GHCR | `ghcr.io/lpalbou/abstractgateway` | 0.4.1 (`gpu-latest` / `<version>-gpu` experimental) |
+| GHCR | `ghcr.io/lpalbou/abstractcore-server` | 2.15.0 |
 
 Optional add-ons that are not part of any profile install separately:
 `pip install abstract3d` (0.3.1), `pip install abstractcamera` (0.2.0) and

{abstractframework-0.2.1 → abstractframework-0.3.0}/README.md

@@ -19,24 +19,31 @@ Think of it as an **agentic OS**: durable runs + replay-first observability + mu
 
 ## Quick start
 
-One line installs the gateway (no admin rights, no system Python), registers it as a login
-service, starts it on `127.0.0.1:8080`, and opens its web console already signed in. A first-run
-guide then sets up a local engine (Ollama, LM Studio, MLX, llama.cpp), downloads a model that fits
-your machine, and lists the apps:
+The installer sets up the gateway in your user account (no admin password, no system Python),
+asks whether to start it at login, starts it on `127.0.0.1:8080`, and opens its web console in
+your browser already signed in. A first-run guide then sets up a local engine (Ollama, LM Studio,
+MLX, llama.cpp), downloads a model that fits your machine, and lists the apps.
 
-```bash
-# macOS / Linux
-curl -LsSf https://raw.githubusercontent.com/lpalbou/AbstractFramework/main/scripts/install.sh | sh
-```
+- **Mac, no Terminal:** download and double-click
+  [AbstractFramework-Installer.pkg](https://github.com/lpalbou/AbstractFramework/releases/latest/download/AbstractFramework-Installer.pkg).
+  A Terminal window shows each step; press Return at its one question.
+- **macOS / Linux, one line:**
 
-```powershell
-# Windows 10 22H2+ / 11
-powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/lpalbou/AbstractFramework/main/scripts/install.ps1 | iex"
-```
+  ```bash
+  curl -LsSf https://raw.githubusercontent.com/lpalbou/AbstractFramework/main/scripts/install.sh | sh -s -- --interactive
+  ```
+
+- **Windows 10 22H2+ / 11** (PowerShell):
+
+  ```powershell
+  powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/lpalbou/AbstractFramework/main/scripts/install.ps1 | iex"
+  ```
 
-Add `--with-apps`, `--with-ollama` or `--with-lmstudio` for Node.js and local engines, `--print` to
-see every command first, and `--uninstall` to remove it. Options, the equivalent commands and
-uninstall details: [Install](docs/install.md).
+Every failure says what to do next; running the installer again repairs or upgrades in place. To
+remove it: `Uninstall AbstractFramework.command`, or
+`curl -LsSf https://raw.githubusercontent.com/lpalbou/AbstractFramework/main/scripts/uninstall.sh | sh`.
+Step by step, the failure table, options (`--with-apps`, `--with-ollama`, `--print`, …):
+[Install](docs/install.md).
 
 Already have Python? Either entry point works the same way: start it, then open the link it prints.
 
@@ -138,7 +145,7 @@ ABSTRACTGATEWAY_AUTH_TOKEN=<token> abstractgateway-console --url http://127.0.0.
 ```
 
 Container images are published for the gateway and the AbstractCore server:
-`ghcr.io/lpalbou/abstractgateway:0.3.0` and `ghcr.io/lpalbou/abstractcore-server:2.14.0`.
+`ghcr.io/lpalbou/abstractgateway:0.4.1` and `ghcr.io/lpalbou/abstractcore-server:2.15.0`.
 
 For artifact and runtime-resource investigation, see
 `docs/guide/runtime-artifacts.md`.
@@ -257,7 +264,7 @@ pip install "abstractframework[gpu]"
 | Apple | `pip install "abstractframework[apple]"` | macOS 14+ on Apple Silicon | 3.10–3.13 (F5-TTS voice cloning needs 3.11+) |
 | GPU | `pip install "abstractframework[gpu]"` | Linux / Windows with a CUDA or ROCm GPU | 3.10–3.13 (F5-TTS voice cloning needs 3.11+) |
 
-### Release matrix (abstractframework 0.2.1)
+### Release matrix (abstractframework 0.3.0)
 
 `abstractframework` pins every Python package with `==`, so one version of the
 meta-package always installs the same stack. The browser apps and Rust tools are
@@ -266,9 +273,9 @@ and tested together.
 
 | Registry | Package | Version |
 |---|---|---|
-| PyPI | `abstractgateway` | 0.3.0 |
+| PyPI | `abstractgateway` | 0.4.1 |
 | PyPI | `abstractassistant` | 0.5.0 |
-| PyPI | `abstractcore` | 2.14.0 |
+| PyPI | `abstractcore` | 2.15.0 |
 | PyPI | `AbstractRuntime` | 0.4.33 |
 | PyPI | `abstractagent` | 0.3.13 |
 | PyPI | `AbstractMemory` | 0.3.0 |
@@ -279,14 +286,14 @@ and tested together.
 | npm | `@abstractframework/flow` | 0.3.20 |
 | npm | `@abstractframework/code` | 0.4.2 |
 | npm | `@abstractframework/observer` | 0.1.12 |
-| npm | `@abstractframework/continuum` | 0.2.0 |
-| npm | `@abstractframework/entity` | 0.1.0 |
+| npm | `@abstractframework/continuum` | 0.3.0 |
+| npm | `@abstractframework/entity` | 0.2.0 |
 | crates.io | `abstractcode` | 0.5.1 |
-| crates.io | `abstractgateway-console` | 0.7.0 |
+| crates.io | `abstractgateway-console` | 0.8.0 |
 | crates.io | `abstractcore-console` | 0.2.0 |
 | crates.io | `abstracttui` | 0.6.0 |
-| GHCR | `ghcr.io/lpalbou/abstractgateway` | 0.3.0 (`gpu-latest` / `<version>-gpu` experimental) |
-| GHCR | `ghcr.io/lpalbou/abstractcore-server` | 2.14.0 |
+| GHCR | `ghcr.io/lpalbou/abstractgateway` | 0.4.1 (`gpu-latest` / `<version>-gpu` experimental) |
+| GHCR | `ghcr.io/lpalbou/abstractcore-server` | 2.15.0 |
 
 Optional add-ons that are not part of any profile install separately:
 `pip install abstract3d` (0.3.1), `pip install abstractcamera` (0.2.0) and

{abstractframework-0.2.1 → abstractframework-0.3.0}/abstractframework/__init__.py

@@ -10,15 +10,15 @@ Most implementation functionality still lives in component projects.
 
 from __future__ import annotations
 
-__version__ = "0.2.1"
+__version__ = "0.3.0"
 __author__ = "Laurent-Philippe Albou"
 __license__ = "MIT"
 
 RELEASE_VERSIONS: dict[str, str] = {
-    "abstractcore": "2.14.0",
+    "abstractcore": "2.15.0",
     "abstractruntime": "0.4.33",
     "abstractagent": "0.3.13",
-    "abstractgateway": "0.3.0",
+    "abstractgateway": "0.4.1",
     "abstractmemory": "0.3.0",
     "abstractsemantics": "0.0.5",
     "abstractvoice": "0.11.4",
@@ -44,14 +44,14 @@ NPM_RELEASE_VERSIONS: dict[str, str] = {
     "@abstractframework/flow": "0.3.20",
     "@abstractframework/code": "0.4.2",
     "@abstractframework/observer": "0.1.12",
-    "@abstractframework/continuum": "0.2.0",
-    "@abstractframework/entity": "0.1.0",
+    "@abstractframework/continuum": "0.3.0",
+    "@abstractframework/entity": "0.2.0",
 }
 
 # Terminal tools published on crates.io alongside this release (installed with `cargo install`,
 # or by the bootstrap scripts' --with-console / --with-code-cli flags).
 CRATE_RELEASE_VERSIONS: dict[str, str] = {
-    "abstractgateway-console": "0.7.0",
+    "abstractgateway-console": "0.8.0",
     "abstractcore-console": "0.2.0",
     "abstractcode": "0.5.1",
     "abstracttui": "0.6.0",

{abstractframework-0.2.1 → abstractframework-0.3.0/abstractframework.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: abstractframework
-Version: 0.2.1
+Version: 0.3.0
 Summary: Unified installer and documentation hub for the AbstractFramework ecosystem
 Author-email: Laurent-Philippe Albou <contact@abstractframework.ai>
 License: MIT
@@ -23,9 +23,9 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: abstractgateway==0.3.0
+Requires-Dist: abstractgateway==0.4.1
 Requires-Dist: abstractassistant==0.5.0
-Requires-Dist: abstractcore==2.14.0
+Requires-Dist: abstractcore==2.15.0
 Requires-Dist: AbstractRuntime==0.4.33
 Requires-Dist: abstractagent==0.3.13
 Requires-Dist: AbstractMemory==0.3.0
@@ -34,10 +34,10 @@ Requires-Dist: abstractvoice==0.11.4
 Requires-Dist: abstractvision==0.3.29
 Requires-Dist: abstractmusic==0.1.15
 Provides-Extra: apple
-Requires-Dist: abstractgateway[apple]==0.3.0; extra == "apple"
+Requires-Dist: abstractgateway[apple]==0.4.1; extra == "apple"
 Requires-Dist: abstractassistant[apple]==0.5.0; platform_system == "Darwin" and extra == "apple"
 Provides-Extra: gpu
-Requires-Dist: abstractgateway[gpu]==0.3.0; extra == "gpu"
+Requires-Dist: abstractgateway[gpu]==0.4.1; extra == "gpu"
 Requires-Dist: abstractassistant[gpu]==0.5.0; extra == "gpu"
 Dynamic: license-file
 
@@ -62,24 +62,31 @@ Think of it as an **agentic OS**: durable runs + replay-first observability + mu
 
 ## Quick start
 
-One line installs the gateway (no admin rights, no system Python), registers it as a login
-service, starts it on `127.0.0.1:8080`, and opens its web console already signed in. A first-run
-guide then sets up a local engine (Ollama, LM Studio, MLX, llama.cpp), downloads a model that fits
-your machine, and lists the apps:
+The installer sets up the gateway in your user account (no admin password, no system Python),
+asks whether to start it at login, starts it on `127.0.0.1:8080`, and opens its web console in
+your browser already signed in. A first-run guide then sets up a local engine (Ollama, LM Studio,
+MLX, llama.cpp), downloads a model that fits your machine, and lists the apps.
 
-```bash
-# macOS / Linux
-curl -LsSf https://raw.githubusercontent.com/lpalbou/AbstractFramework/main/scripts/install.sh | sh
-```
+- **Mac, no Terminal:** download and double-click
+  [AbstractFramework-Installer.pkg](https://github.com/lpalbou/AbstractFramework/releases/latest/download/AbstractFramework-Installer.pkg).
+  A Terminal window shows each step; press Return at its one question.
+- **macOS / Linux, one line:**
 
-```powershell
-# Windows 10 22H2+ / 11
-powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/lpalbou/AbstractFramework/main/scripts/install.ps1 | iex"
-```
+  ```bash
+  curl -LsSf https://raw.githubusercontent.com/lpalbou/AbstractFramework/main/scripts/install.sh | sh -s -- --interactive
+  ```
+
+- **Windows 10 22H2+ / 11** (PowerShell):
+
+  ```powershell
+  powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/lpalbou/AbstractFramework/main/scripts/install.ps1 | iex"
+  ```
 
-Add `--with-apps`, `--with-ollama` or `--with-lmstudio` for Node.js and local engines, `--print` to
-see every command first, and `--uninstall` to remove it. Options, the equivalent commands and
-uninstall details: [Install](docs/install.md).
+Every failure says what to do next; running the installer again repairs or upgrades in place. To
+remove it: `Uninstall AbstractFramework.command`, or
+`curl -LsSf https://raw.githubusercontent.com/lpalbou/AbstractFramework/main/scripts/uninstall.sh | sh`.
+Step by step, the failure table, options (`--with-apps`, `--with-ollama`, `--print`, …):
+[Install](docs/install.md).
 
 Already have Python? Either entry point works the same way: start it, then open the link it prints.
 
@@ -181,7 +188,7 @@ ABSTRACTGATEWAY_AUTH_TOKEN=<token> abstractgateway-console --url http://127.0.0.
 ```
 
 Container images are published for the gateway and the AbstractCore server:
-`ghcr.io/lpalbou/abstractgateway:0.3.0` and `ghcr.io/lpalbou/abstractcore-server:2.14.0`.
+`ghcr.io/lpalbou/abstractgateway:0.4.1` and `ghcr.io/lpalbou/abstractcore-server:2.15.0`.
 
 For artifact and runtime-resource investigation, see
 `docs/guide/runtime-artifacts.md`.
@@ -300,7 +307,7 @@ pip install "abstractframework[gpu]"
 | Apple | `pip install "abstractframework[apple]"` | macOS 14+ on Apple Silicon | 3.10–3.13 (F5-TTS voice cloning needs 3.11+) |
 | GPU | `pip install "abstractframework[gpu]"` | Linux / Windows with a CUDA or ROCm GPU | 3.10–3.13 (F5-TTS voice cloning needs 3.11+) |
 
-### Release matrix (abstractframework 0.2.1)
+### Release matrix (abstractframework 0.3.0)
 
 `abstractframework` pins every Python package with `==`, so one version of the
 meta-package always installs the same stack. The browser apps and Rust tools are
@@ -309,9 +316,9 @@ and tested together.
 
 | Registry | Package | Version |
 |---|---|---|
-| PyPI | `abstractgateway` | 0.3.0 |
+| PyPI | `abstractgateway` | 0.4.1 |
 | PyPI | `abstractassistant` | 0.5.0 |
-| PyPI | `abstractcore` | 2.14.0 |
+| PyPI | `abstractcore` | 2.15.0 |
 | PyPI | `AbstractRuntime` | 0.4.33 |
 | PyPI | `abstractagent` | 0.3.13 |
 | PyPI | `AbstractMemory` | 0.3.0 |
@@ -322,14 +329,14 @@ and tested together.
 | npm | `@abstractframework/flow` | 0.3.20 |
 | npm | `@abstractframework/code` | 0.4.2 |
 | npm | `@abstractframework/observer` | 0.1.12 |
-| npm | `@abstractframework/continuum` | 0.2.0 |
-| npm | `@abstractframework/entity` | 0.1.0 |
+| npm | `@abstractframework/continuum` | 0.3.0 |
+| npm | `@abstractframework/entity` | 0.2.0 |
 | crates.io | `abstractcode` | 0.5.1 |
-| crates.io | `abstractgateway-console` | 0.7.0 |
+| crates.io | `abstractgateway-console` | 0.8.0 |
 | crates.io | `abstractcore-console` | 0.2.0 |
 | crates.io | `abstracttui` | 0.6.0 |
-| GHCR | `ghcr.io/lpalbou/abstractgateway` | 0.3.0 (`gpu-latest` / `<version>-gpu` experimental) |
-| GHCR | `ghcr.io/lpalbou/abstractcore-server` | 2.14.0 |
+| GHCR | `ghcr.io/lpalbou/abstractgateway` | 0.4.1 (`gpu-latest` / `<version>-gpu` experimental) |
+| GHCR | `ghcr.io/lpalbou/abstractcore-server` | 2.15.0 |
 
 Optional add-ons that are not part of any profile install separately:
 `pip install abstract3d` (0.3.1), `pip install abstractcamera` (0.2.0) and

{abstractframework-0.2.1 → abstractframework-0.3.0}/abstractframework.egg-info/SOURCES.txt

@@ -169,14 +169,17 @@ scripts/start-local.sh
 scripts/start.sh
 scripts/status.sh
 scripts/steer_repl.py
+scripts/uninstall.sh
 scripts/visit_resume_cache_probe.py
 scripts/lib/af_inventory.py
 scripts/lib/af_stack.sh
 scripts/lib/af_supervisor.sh
 scripts/lib/apps_common.sh
+scripts/lib/build_macos_installer.sh
 scripts/lib/gateway_user_tokens.py
 scripts/lib/repo_groups.sh
 scripts/tests/test_af_supervisor.sh
+scripts/tests/test_install_user_path.sh
 scripts/tests/test_inventory.sh
 scripts/tests/test_repo_scripts.sh
 tests/test_install_profiles.py

{abstractframework-0.2.1 → abstractframework-0.3.0}/abstractframework.egg-info/requires.txt

@@ -1,6 +1,6 @@
-abstractgateway==0.3.0
+abstractgateway==0.4.1
 abstractassistant==0.5.0
-abstractcore==2.14.0
+abstractcore==2.15.0
 AbstractRuntime==0.4.33
 abstractagent==0.3.13
 AbstractMemory==0.3.0
@@ -10,11 +10,11 @@ abstractvision==0.3.29
 abstractmusic==0.1.15
 
 [apple]
-abstractgateway[apple]==0.3.0
+abstractgateway[apple]==0.4.1
 
 [apple:platform_system == "Darwin"]
 abstractassistant[apple]==0.5.0
 
 [gpu]
-abstractgateway[gpu]==0.3.0
+abstractgateway[gpu]==0.4.1
 abstractassistant[gpu]==0.5.0

{abstractframework-0.2.1 → abstractframework-0.3.0}/docs/api.md

@@ -55,8 +55,8 @@ The response type returned by `llm.generate(...)`.
 
 ### `RELEASE_VERSIONS`
 
-Dictionary mapping each ecosystem package name to the pinned version for this release. In 0.2.0:
-`abstractcore` 2.14.0, `abstractruntime` 0.4.33, `abstractagent` 0.3.13, `abstractgateway` 0.3.0,
+Dictionary mapping each ecosystem package name to the pinned version for this release. In 0.3.0:
+`abstractcore` 2.15.0, `abstractruntime` 0.4.33, `abstractagent` 0.3.13, `abstractgateway` 0.4.1,
 `abstractmemory` 0.3.0, `abstractsemantics` 0.0.5, `abstractvoice` 0.11.4, `abstractvision` 0.3.29,
 `abstractmusic` 0.1.15, `abstractassistant` 0.5.0.
 
@@ -69,13 +69,13 @@ Maps each package name in `RELEASE_VERSIONS` to its PyPI distribution name (for
 
 The npm apps released with this version, each runnable with `npx <package>`:
 `@abstractframework/flow` 0.3.20, `@abstractframework/code` 0.4.2,
-`@abstractframework/observer` 0.1.12, `@abstractframework/continuum` 0.2.0 and
-`@abstractframework/entity` 0.1.0. They also appear as `npm_apps` in the install manifest.
+`@abstractframework/observer` 0.1.12, `@abstractframework/continuum` 0.3.0 and
+`@abstractframework/entity` 0.2.0. They also appear as `npm_apps` in the install manifest.
 
 ### `CRATE_RELEASE_VERSIONS`
 
 The Rust terminal tools released with this version, installed with `cargo install <crate>`:
-`abstractgateway-console` 0.7.0, `abstractcore-console` 0.2.0, `abstractcode` 0.5.1 and the
+`abstractgateway-console` 0.8.0, `abstractcore-console` 0.2.0, `abstractcode` 0.5.1 and the
 `abstracttui` engine 0.6.0. The bootstrap scripts install `abstractgateway-console` and
 `abstractcode` at these versions with `--with-console` and `--with-code-cli`.
 

{abstractframework-0.2.1 → abstractframework-0.3.0}/docs/faq.md

@@ -28,13 +28,13 @@ No.
 
 | Goal | Install |
 |---|---|
-| A running gateway + web console, no Python setup | the one-line bootstrap in [Install](install.md#quick-start) |
+| A running gateway + web console, no Python setup | the installer (a Mac package, or one line) in [Install](install.md) |
 | Smallest useful (LLM SDK only) | `pip install abstractcore` |
 | Gateway-first deployment | `pip install abstractgateway` |
 | Everything at compatible versions | `pip install abstractframework` |
 | A browser app against an existing gateway | `npx @abstractframework/<flow\|code\|observer\|continuum\|entity>` |
 | A terminal client | `cargo install abstractcode`, `cargo install abstractgateway-console` or `cargo install abstractcore-console` |
-| A container deployment | `ghcr.io/lpalbou/abstractgateway:0.3.0` |
+| A container deployment | `ghcr.io/lpalbou/abstractgateway:0.4.1` |
 
 See [Install AbstractFramework](install.md) for the Light / Apple / GPU chooser. Light is
 remote-first, not reduced-functionality: multimodal and embeddings still work through remote or
@@ -183,8 +183,10 @@ to install `libatomic1`. The script tells you before running them.
 
 No. The default install uses prebuilt wheels only. If macOS shows an "install the command line
 developer tools" prompt, cancel it and re-run the current one-liner: an older copy of the script
-compiled a few packages. You need a compiler only for `--full`, which adds llama.cpp GGUF,
-stable-diffusion.cpp and echo cancellation ([Compiled extras](install.md#compiled-extras)).
+compiled a few packages. llama.cpp GGUF models come from upstream's prebuilt wheel on Apple
+Silicon, Linux and Windows x64 ([llama.cpp GGUF models](install.md#llamacpp-gguf-models)). You
+need a compiler only for `--full`, which adds stable-diffusion.cpp and echo cancellation, and
+llama.cpp on machines without a prebuilt wheel ([Compiled extras](install.md#compiled-extras)).
 
 ### Windows says scripts are disabled on this system
 

{abstractframework-0.2.1 → abstractframework-0.3.0}/docs/getting-started.md

@@ -19,22 +19,27 @@ AbstractFramework is a **stack**:
 
 > **Prerequisites**: Python 3.10–3.13 for the manual installs below. Node.js 18+ (only for browser UIs). An LLM backend — local (Ollama, LM Studio, vLLM, llama.cpp) or cloud (OpenAI, Anthropic, etc.).
 
-## Fastest path: the one-line install
+## Fastest path: the installer
 
-If you want a running gateway and its web console without setting up Python yourself, use the
-bootstrap script. It installs uv, Python 3.12 and the pinned gateway in your user account, registers
-it to start at login, starts it on `127.0.0.1:8080`, and opens `/console` already signed in:
+If you want AbstractFramework running on your computer without setting up Python yourself, use
+the installer. On a Mac, download and double-click
+[AbstractFramework-Installer.pkg](https://github.com/lpalbou/AbstractFramework/releases/latest/download/AbstractFramework-Installer.pkg);
+on macOS or Linux you can instead paste one line in Terminal:
 
 ```bash
-curl -LsSf https://raw.githubusercontent.com/lpalbou/AbstractFramework/main/scripts/install.sh | sh
+curl -LsSf https://raw.githubusercontent.com/lpalbou/AbstractFramework/main/scripts/install.sh | sh -s -- --interactive
 ```
 
 On Windows: `powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/lpalbou/AbstractFramework/main/scripts/install.ps1 | iex"`.
-The console's first-run guide sets up a local engine or a cloud key and a default model (the
-**Models** tab lists the models that fit your machine and downloads them). Then continue with
-[Monitor runs](#4-monitor-runs-with-abstractobserver) or [AbstractFlow](#author-orchestration-with-abstractflow).
-Options and uninstall: [Install](install.md#quick-start). The sections below cover manual installs
-for library and developer use.
+
+It installs uv, Python 3.12 and the pinned gateway in your user account (no admin password), asks
+whether to start it at login, starts it on `127.0.0.1:8080`, and opens its console in your browser
+already signed in. The console's first-run guide sets up a local engine or a cloud key and a
+default model (the **Models** tab lists the models that fit your machine and downloads them). Then
+continue with [Monitor runs](#4-monitor-runs-with-abstractobserver) or
+[AbstractFlow](#author-orchestration-with-abstractflow). Step by step, what to do when something
+fails, and how to remove it: [Install](install.md). The sections below cover manual installs for
+library and developer use.
 
 ---