abstractframework 0.2.0__tar.gz → 0.3.0__tar.gz

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

@@ -2,7 +2,135 @@
 
 All notable changes to AbstractFramework will be documented in this file.
 
-## [Unreleased]
+## [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
+meta-package pins abstractvoice 0.11.4. Everything else is unchanged from 0.2.0.
+
+### Changed
+
+- **abstractvoice 0.11.4** (was 0.11.3). It takes voice activity detection from
+  `webrtcvad-wheels`, which ships prebuilt wheels for macOS arm64, Linux and Windows, instead
+  of `webrtcvad`, which is source-only on PyPI and needs a compiler. This is the pin that made
+  `pip install abstractframework[apple]` build `webrtcvad` from source. The other pins are
+  unchanged: abstractgateway 0.3.0, abstractcore 2.14.0, AbstractRuntime 0.4.33.
+
+### Fixed
+
+- **One-line install needs no compiler.** On a Mac without Xcode Command Line Tools the gateway
+  install failed building `webrtcvad` from source, and `llama-cpp-python`,
+  `stable-diffusion-cpp-python` and `aec-audio-processing` would have failed next. `install.sh` and
+  `install.ps1` now run `uv tool install` with `--with 'webrtcvad-wheels>=2.0.14'`, an overrides
+  file (`uv-overrides.txt` in the gateway data directory) that drops `webrtcvad`, keeps `vllm` to
+  Linux and leaves out the three compiled extras, plus `--no-build-package` for those packages so
+  a missing wheel fails fast instead of starting a compiler. The install runs from the data
+  directory and names the file relatively, because uv splits an `--overrides` value at whitespace
+  (`Application Support`). On macOS, Linux and Windows the preflight says when no compiler is
+  present, and that this is fine; the summary says what was skipped.
+
+### Added
+
+- **`--full` (Windows: `-Full`)** keeps the compiled extras (llama.cpp GGUF, stable-diffusion.cpp,
+  echo cancellation) and builds them from source. It needs a C/C++ compiler and stops before
+  installing when none is found.
 
 ## [0.2.0] - 2026-09-23
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: abstractframework
-Version: 0.2.0
+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,21 +23,21 @@ 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
 Requires-Dist: abstractsemantics==0.0.5
-Requires-Dist: abstractvoice==0.11.3
+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.0)
+### 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,27 +316,27 @@ 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 |
 | PyPI | `abstractsemantics` | 0.0.5 |
-| PyPI | `abstractvoice` | 0.11.3 |
+| PyPI | `abstractvoice` | 0.11.4 |
 | PyPI | `abstractvision` | 0.3.29 |
 | PyPI | `abstractmusic` | 0.1.15 |
 | 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.0 → 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.0)
+### 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,27 +273,27 @@ 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 |
 | PyPI | `abstractsemantics` | 0.0.5 |
-| PyPI | `abstractvoice` | 0.11.3 |
+| PyPI | `abstractvoice` | 0.11.4 |
 | PyPI | `abstractvision` | 0.3.29 |
 | PyPI | `abstractmusic` | 0.1.15 |
 | 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.0 → abstractframework-0.3.0}/abstractframework/__init__.py

@@ -10,18 +10,18 @@ Most implementation functionality still lives in component projects.
 
 from __future__ import annotations
 
-__version__ = "0.2.0"
+__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.3",
+    "abstractvoice": "0.11.4",
     "abstractvision": "0.3.29",
     "abstractmusic": "0.1.15",
     "abstractassistant": "0.5.0",
@@ -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.0 → abstractframework-0.3.0/abstractframework.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: abstractframework
-Version: 0.2.0
+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,21 +23,21 @@ 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
 Requires-Dist: abstractsemantics==0.0.5
-Requires-Dist: abstractvoice==0.11.3
+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.0)
+### 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,27 +316,27 @@ 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 |
 | PyPI | `abstractsemantics` | 0.0.5 |
-| PyPI | `abstractvoice` | 0.11.3 |
+| PyPI | `abstractvoice` | 0.11.4 |
 | PyPI | `abstractvision` | 0.3.29 |
 | PyPI | `abstractmusic` | 0.1.15 |
 | 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.0 → 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.0 → abstractframework-0.3.0}/abstractframework.egg-info/requires.txt

@@ -1,20 +1,20 @@
-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
 abstractsemantics==0.0.5
-abstractvoice==0.11.3
+abstractvoice==0.11.4
 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.0 → abstractframework-0.3.0}/docs/api.md

@@ -55,9 +55,9 @@ 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,
-`abstractmemory` 0.3.0, `abstractsemantics` 0.0.5, `abstractvoice` 0.11.3, `abstractvision` 0.3.29,
+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.
 
 ### `PACKAGE_DISTRIBUTIONS`
@@ -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`.