abstractframework 0.2.0__tar.gz → 0.2.1__tar.gz

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

@@ -2,7 +2,37 @@
 
 All notable changes to AbstractFramework will be documented in this file.
 
-## [Unreleased]
+## [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.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: abstractframework
-Version: 0.2.0
+Version: 0.2.1
 Summary: Unified installer and documentation hub for the AbstractFramework ecosystem
 Author-email: Laurent-Philippe Albou <contact@abstractframework.ai>
 License: MIT
@@ -30,7 +30,7 @@ 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
@@ -300,7 +300,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.2.1)
 
 `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
@@ -316,7 +316,7 @@ and tested together.
 | 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 |

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

@@ -257,7 +257,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.2.1)
 
 `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
@@ -273,7 +273,7 @@ and tested together.
 | 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 |

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

@@ -10,7 +10,7 @@ Most implementation functionality still lives in component projects.
 
 from __future__ import annotations
 
-__version__ = "0.2.0"
+__version__ = "0.2.1"
 __author__ = "Laurent-Philippe Albou"
 __license__ = "MIT"
 
@@ -21,7 +21,7 @@ RELEASE_VERSIONS: dict[str, str] = {
     "abstractgateway": "0.3.0",
     "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",

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: abstractframework
-Version: 0.2.0
+Version: 0.2.1
 Summary: Unified installer and documentation hub for the AbstractFramework ecosystem
 Author-email: Laurent-Philippe Albou <contact@abstractframework.ai>
 License: MIT
@@ -30,7 +30,7 @@ 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
@@ -300,7 +300,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.2.1)
 
 `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
@@ -316,7 +316,7 @@ and tested together.
 | 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 |

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

@@ -5,7 +5,7 @@ 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
 

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

@@ -57,7 +57,7 @@ The response type returned by `llm.generate(...)`.
 
 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,
+`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`

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

@@ -179,6 +179,13 @@ user account. Only optional vendor installers may: Ollama on Linux uses sudo (it
 service), Ollama on macOS may ask to link `/usr/local/bin/ollama`, and LM Studio on Linux may ask
 to install `libatomic1`. The script tells you before running them.
 
+### Do I need Xcode or a C compiler?
+
+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)).
+
 ### Windows says scripts are disabled on this system
 
 Pasting the one-liner works under the default `Restricted` policy because

{abstractframework-0.2.0 → abstractframework-0.2.1}/docs/install.md

@@ -30,7 +30,8 @@ default model picked from the models that fit your machine, and the apps. The **
    `light` otherwise.
 2. Installs [uv](https://docs.astral.sh/uv/) when it is missing, then Python 3.12 through uv.
 3. Installs the gateway as an isolated uv tool, pinned to this release:
-   `uv tool install --python 3.12 "abstractgateway[<profile>,tray]==0.3.0"`.
+   `uv tool install --python 3.12 "abstractgateway[<profile>,tray]==0.3.0"`, from prebuilt wheels
+   only (see [No compiler needed](#no-compiler-needed)).
 4. Optionally installs Node.js for the browser apps, terminal tools, Ollama or LM Studio (flags
    below).
 5. Registers the gateway to start at login with `abstractgateway service install` (a LaunchAgent on
@@ -44,6 +45,28 @@ default model picked from the models that fit your machine, and the apps. The **
 Every command is printed as it runs, and the summary lists them all. Re-running the script
 upgrades or repairs the install in place.
 
+### No compiler needed
+
+By default the script never compiles anything, so you do not need Xcode Command Line Tools, gcc
+or the MSVC Build Tools. It passes uv a small overrides file (`uv-overrides.txt` in the gateway
+data directory; `--print` shows it) that swaps `webrtcvad` for `webrtcvad-wheels`, keeps `vllm`
+to Linux, and leaves out the three compiled extras below, and it refuses to build those packages
+from source, so a gap fails with a clear error instead of starting a compiler. If macOS asks you
+to install the command line developer tools (an `xcode-select` prompt) during an install, you are
+running an older copy of the script: cancel the prompt, fetch the script again with the one-liner
+above and re-run it.
+
+### Compiled extras
+
+Three optional engines publish no wheel on PyPI and are skipped by default: llama.cpp GGUF models
+in-process (`llama-cpp-python`), stable-diffusion.cpp image generation
+(`stable-diffusion-cpp-python`) and voice echo cancellation (`aec-audio-processing`). `--full`
+(Windows: `-Full`) keeps them and builds them from source, which takes several minutes and needs a
+C/C++ compiler (macOS: `xcode-select --install`; Debian/Ubuntu: `sudo apt-get install -y
+build-essential`; Windows: Visual Studio Build Tools with "Desktop development with C++"). Without
+a compiler, `--full` stops before installing anything. You do not need them for MLX on Apple
+Silicon, for Ollama, LM Studio or other endpoint engines, or for cloud providers.
+
 ### Options
 
 | macOS/Linux | Windows | What it does |
@@ -56,6 +79,7 @@ upgrades or repairs the install in place.
 | `--with-console` | `-WithConsole` | Install the `abstractgateway-console` crate with cargo (terminal console; needs Rust) |
 | `--with-code-cli` | `-WithCodeCli` | Install the `abstractcode` crate with cargo (terminal client; needs Rust) |
 | `--with-core-cli` | `-WithCoreCli` | Also put the `abstractcore` command on PATH |
+| `--full` | `-Full` | Also build the [compiled extras](#compiled-extras) from source (needs a C compiler) |
 | `--no-service` | `-NoService` | Do not register a login service |
 | `--no-open` | `-NoOpen` | Do not open the browser |
 | `--pin X` / `--from PATH` | `-Pin` / `-From` | Install another gateway version or a local checkout |
@@ -79,6 +103,7 @@ curl -LsSf https://raw.githubusercontent.com/lpalbou/AbstractFramework/main/scri
 curl -LsSf https://astral.sh/uv/install.sh | sh             # Windows: irm https://astral.sh/uv/install.ps1 | iex
 uv python install 3.12
 uv tool install --python 3.12 "abstractgateway[tray]==0.3.0"    # [apple,tray] or [gpu,tray] for local engines
+                       # (add --with and --overrides as shown by `install.sh --print` to avoid compiling)
 uv tool update-shell                                          # puts ~/.local/bin on PATH; open a new terminal
 abstractgateway service install --host 127.0.0.1 --port 8080   # or: abstractgateway serve
 abstractgateway-config claim-url --base-url http://127.0.0.1:8080  # prints a one-time console link
@@ -155,9 +180,14 @@ whether local inference engines are installed.
 | Apple | macOS 14 or later on Apple Silicon | 3.10–3.13 | MLX wheels need macOS 14+. F5-TTS voice cloning needs Python 3.11+; the rest of the profile works on 3.10. |
 | GPU | Linux (and Windows where the engines publish wheels) with NVIDIA CUDA or AMD ROCm drivers | 3.10–3.13 | F5-TTS voice cloning needs Python 3.11+; the rest of the profile works on 3.10. |
 
+A plain `pip install` of the `apple` or `gpu` profile builds the
+[compiled extras](#compiled-extras) (`llama-cpp-python`, `stable-diffusion-cpp-python`,
+`aec-audio-processing`) from source, so it needs a C/C++ compiler. The one-line install above
+does not.
+
 `abstractframework` 0.2.0 pins `abstractgateway==0.3.0`, `abstractassistant==0.5.0`,
 `abstractcore==2.14.0`, `AbstractRuntime==0.4.33`, `abstractagent==0.3.13`,
-`AbstractMemory==0.3.0`, `abstractsemantics==0.0.5`, `abstractvoice==0.11.3`,
+`AbstractMemory==0.3.0`, `abstractsemantics==0.0.5`, `abstractvoice==0.11.4`,
 `abstractvision==0.3.29` and `abstractmusic==0.1.15`. The `apple` and `gpu` extras select
 `abstractgateway[apple|gpu]` and `abstractassistant[apple|gpu]` at the same versions
 (`abstractassistant[apple]` is installed on macOS only). `abstractframework doctor` reports any

{abstractframework-0.2.0 → abstractframework-0.2.1}/llms-full.txt

@@ -261,7 +261,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.2.1)
 
 `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
@@ -277,7 +277,7 @@ and tested together.
 | 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 |
@@ -471,7 +471,7 @@ Notes for LLMs working in this repo:
 - [abstractframework/__init__.py](abstractframework/__init__.py): `RELEASE_VERSIONS`, `NPM_RELEASE_VERSIONS`, `get_release_profile()`, `print_status()`.
 - [docs/installers/install-manifest.json](docs/installers/install-manifest.json): Generated install manifest, schema v2 (pins, profiles, npm apps, `bootstrap` gateway pin/scripts/flags, console-first `post_install`).
 - [scripts/install.sh](scripts/install.sh) / [scripts/install.ps1](scripts/install.ps1): The bootstrap installers.
-- abstractframework 0.2.0 pins (PyPI, `==`): abstractgateway 0.3.0, abstractassistant 0.5.0, abstractcore 2.14.0, AbstractRuntime 0.4.33, abstractagent 0.3.13, AbstractMemory 0.3.0, abstractsemantics 0.0.5, abstractvoice 0.11.3, abstractvision 0.3.29, abstractmusic 0.1.15.
+- abstractframework 0.2.1 pins (PyPI, `==`): abstractgateway 0.3.0, abstractassistant 0.5.0, abstractcore 2.14.0, 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.
 - Released with it: npm `@abstractframework/flow` 0.3.20, `code` 0.4.2, `observer` 0.1.12, `continuum` 0.2.0, `entity` 0.1.0 (run with `npx`); crates (`CRATE_RELEASE_VERSIONS`) `abstractgateway-console` 0.7.0, `abstractcore-console` 0.2.0, `abstractcode` 0.5.1, `abstracttui` 0.6.0; images `ghcr.io/lpalbou/abstractgateway:0.3.0`, `ghcr.io/lpalbou/abstractcore-server:2.14.0`.
 - Profiles: light (remote-only), apple (`abstractframework[apple]`, macOS 14+ Apple Silicon), gpu (`abstractframework[gpu]`); Python 3.10-3.13 (F5-TTS voice cloning in apple/gpu needs 3.11+).
 
@@ -512,7 +512,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "abstractframework"
-version = "0.2.0"
+version = "0.2.1"
 description = "Unified installer and documentation hub for the AbstractFramework ecosystem"
 readme = "README.md"
 license = {text = "MIT"}
@@ -570,7 +570,7 @@ dependencies = [
 
     # Capability plugins are remote-first by default; local runtimes live behind
     # their package-specific `apple`/`gpu` (or `all-*`) extras.
-    "abstractvoice==0.11.3",
+    "abstractvoice==0.11.4",
     "abstractvision==0.3.29",
     "abstractmusic==0.1.15",
 ]
@@ -644,7 +644,7 @@ Most implementation functionality still lives in component projects.
 
 from __future__ import annotations
 
-__version__ = "0.2.0"
+__version__ = "0.2.1"
 __author__ = "Laurent-Philippe Albou"
 __license__ = "MIT"
 
@@ -655,7 +655,7 @@ RELEASE_VERSIONS: dict[str, str] = {
     "abstractgateway": "0.3.0",
     "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",
@@ -1796,7 +1796,8 @@ default model picked from the models that fit your machine, and the apps. The **
    `light` otherwise.
 2. Installs [uv](https://docs.astral.sh/uv/) when it is missing, then Python 3.12 through uv.
 3. Installs the gateway as an isolated uv tool, pinned to this release:
-   `uv tool install --python 3.12 "abstractgateway[<profile>,tray]==0.3.0"`.
+   `uv tool install --python 3.12 "abstractgateway[<profile>,tray]==0.3.0"`, from prebuilt wheels
+   only (see [No compiler needed](#no-compiler-needed)).
 4. Optionally installs Node.js for the browser apps, terminal tools, Ollama or LM Studio (flags
    below).
 5. Registers the gateway to start at login with `abstractgateway service install` (a LaunchAgent on
@@ -1810,6 +1811,28 @@ default model picked from the models that fit your machine, and the apps. The **
 Every command is printed as it runs, and the summary lists them all. Re-running the script
 upgrades or repairs the install in place.
 
+### No compiler needed
+
+By default the script never compiles anything, so you do not need Xcode Command Line Tools, gcc
+or the MSVC Build Tools. It passes uv a small overrides file (`uv-overrides.txt` in the gateway
+data directory; `--print` shows it) that swaps `webrtcvad` for `webrtcvad-wheels`, keeps `vllm`
+to Linux, and leaves out the three compiled extras below, and it refuses to build those packages
+from source, so a gap fails with a clear error instead of starting a compiler. If macOS asks you
+to install the command line developer tools (an `xcode-select` prompt) during an install, you are
+running an older copy of the script: cancel the prompt, fetch the script again with the one-liner
+above and re-run it.
+
+### Compiled extras
+
+Three optional engines publish no wheel on PyPI and are skipped by default: llama.cpp GGUF models
+in-process (`llama-cpp-python`), stable-diffusion.cpp image generation
+(`stable-diffusion-cpp-python`) and voice echo cancellation (`aec-audio-processing`). `--full`
+(Windows: `-Full`) keeps them and builds them from source, which takes several minutes and needs a
+C/C++ compiler (macOS: `xcode-select --install`; Debian/Ubuntu: `sudo apt-get install -y
+build-essential`; Windows: Visual Studio Build Tools with "Desktop development with C++"). Without
+a compiler, `--full` stops before installing anything. You do not need them for MLX on Apple
+Silicon, for Ollama, LM Studio or other endpoint engines, or for cloud providers.
+
 ### Options
 
 | macOS/Linux | Windows | What it does |
@@ -1822,6 +1845,7 @@ upgrades or repairs the install in place.
 | `--with-console` | `-WithConsole` | Install the `abstractgateway-console` crate with cargo (terminal console; needs Rust) |
 | `--with-code-cli` | `-WithCodeCli` | Install the `abstractcode` crate with cargo (terminal client; needs Rust) |
 | `--with-core-cli` | `-WithCoreCli` | Also put the `abstractcore` command on PATH |
+| `--full` | `-Full` | Also build the [compiled extras](#compiled-extras) from source (needs a C compiler) |
 | `--no-service` | `-NoService` | Do not register a login service |
 | `--no-open` | `-NoOpen` | Do not open the browser |
 | `--pin X` / `--from PATH` | `-Pin` / `-From` | Install another gateway version or a local checkout |
@@ -1845,6 +1869,7 @@ curl -LsSf https://raw.githubusercontent.com/lpalbou/AbstractFramework/main/scri
 curl -LsSf https://astral.sh/uv/install.sh | sh             # Windows: irm https://astral.sh/uv/install.ps1 | iex
 uv python install 3.12
 uv tool install --python 3.12 "abstractgateway[tray]==0.3.0"    # [apple,tray] or [gpu,tray] for local engines
+                       # (add --with and --overrides as shown by `install.sh --print` to avoid compiling)
 uv tool update-shell                                          # puts ~/.local/bin on PATH; open a new terminal
 abstractgateway service install --host 127.0.0.1 --port 8080   # or: abstractgateway serve
 abstractgateway-config claim-url --base-url http://127.0.0.1:8080  # prints a one-time console link
@@ -1921,9 +1946,14 @@ whether local inference engines are installed.
 | Apple | macOS 14 or later on Apple Silicon | 3.10–3.13 | MLX wheels need macOS 14+. F5-TTS voice cloning needs Python 3.11+; the rest of the profile works on 3.10. |
 | GPU | Linux (and Windows where the engines publish wheels) with NVIDIA CUDA or AMD ROCm drivers | 3.10–3.13 | F5-TTS voice cloning needs Python 3.11+; the rest of the profile works on 3.10. |
 
+A plain `pip install` of the `apple` or `gpu` profile builds the
+[compiled extras](#compiled-extras) (`llama-cpp-python`, `stable-diffusion-cpp-python`,
+`aec-audio-processing`) from source, so it needs a C/C++ compiler. The one-line install above
+does not.
+
 `abstractframework` 0.2.0 pins `abstractgateway==0.3.0`, `abstractassistant==0.5.0`,
 `abstractcore==2.14.0`, `AbstractRuntime==0.4.33`, `abstractagent==0.3.13`,
-`AbstractMemory==0.3.0`, `abstractsemantics==0.0.5`, `abstractvoice==0.11.3`,
+`AbstractMemory==0.3.0`, `abstractsemantics==0.0.5`, `abstractvoice==0.11.4`,
 `abstractvision==0.3.29` and `abstractmusic==0.1.15`. The `apple` and `gpu` extras select
 `abstractgateway[apple|gpu]` and `abstractassistant[apple|gpu]` at the same versions
 (`abstractassistant[apple]` is installed on macOS only). `abstractframework doctor` reports any
@@ -3118,7 +3148,7 @@ The response type returned by `llm.generate(...)`.
 
 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,
+`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`
@@ -3449,6 +3479,13 @@ user account. Only optional vendor installers may: Ollama on Linux uses sudo (it
 service), Ollama on macOS may ask to link `/usr/local/bin/ollama`, and LM Studio on Linux may ask
 to install `libatomic1`. The script tells you before running them.
 
+### Do I need Xcode or a C compiler?
+
+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)).
+
 ### Windows says scripts are disabled on this system
 
 Pasting the one-liner works under the default `Restricted` policy because

{abstractframework-0.2.0 → abstractframework-0.2.1}/llms.txt

@@ -122,7 +122,7 @@ Notes for LLMs working in this repo:
 - [abstractframework/__init__.py](abstractframework/__init__.py): `RELEASE_VERSIONS`, `NPM_RELEASE_VERSIONS`, `get_release_profile()`, `print_status()`.
 - [docs/installers/install-manifest.json](docs/installers/install-manifest.json): Generated install manifest, schema v2 (pins, profiles, npm apps, `bootstrap` gateway pin/scripts/flags, console-first `post_install`).
 - [scripts/install.sh](scripts/install.sh) / [scripts/install.ps1](scripts/install.ps1): The bootstrap installers.
-- abstractframework 0.2.0 pins (PyPI, `==`): abstractgateway 0.3.0, abstractassistant 0.5.0, abstractcore 2.14.0, AbstractRuntime 0.4.33, abstractagent 0.3.13, AbstractMemory 0.3.0, abstractsemantics 0.0.5, abstractvoice 0.11.3, abstractvision 0.3.29, abstractmusic 0.1.15.
+- abstractframework 0.2.1 pins (PyPI, `==`): abstractgateway 0.3.0, abstractassistant 0.5.0, abstractcore 2.14.0, 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.
 - Released with it: npm `@abstractframework/flow` 0.3.20, `code` 0.4.2, `observer` 0.1.12, `continuum` 0.2.0, `entity` 0.1.0 (run with `npx`); crates (`CRATE_RELEASE_VERSIONS`) `abstractgateway-console` 0.7.0, `abstractcore-console` 0.2.0, `abstractcode` 0.5.1, `abstracttui` 0.6.0; images `ghcr.io/lpalbou/abstractgateway:0.3.0`, `ghcr.io/lpalbou/abstractcore-server:2.14.0`.
 - Profiles: light (remote-only), apple (`abstractframework[apple]`, macOS 14+ Apple Silicon), gpu (`abstractframework[gpu]`); Python 3.10-3.13 (F5-TTS voice cloning in apple/gpu needs 3.11+).
 

{abstractframework-0.2.0 → abstractframework-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "abstractframework"
-version = "0.2.0"
+version = "0.2.1"
 description = "Unified installer and documentation hub for the AbstractFramework ecosystem"
 readme = "README.md"
 license = {text = "MIT"}
@@ -62,7 +62,7 @@ dependencies = [
 
     # Capability plugins are remote-first by default; local runtimes live behind
     # their package-specific `apple`/`gpu` (or `all-*`) extras.
-    "abstractvoice==0.11.3",
+    "abstractvoice==0.11.4",
     "abstractvision==0.3.29",
     "abstractmusic==0.1.15",
 ]

{abstractframework-0.2.0 → abstractframework-0.2.1}/scripts/install.sh

@@ -13,7 +13,8 @@
 #      profile), free disk, a free port, systemd user bus (Linux)
 #   2. uv (https://docs.astral.sh/uv) if missing, then Python 3.12 through uv
 #   3. `uv tool install --python 3.12 "abstractgateway[<profile>,tray]==<pin>"`
-#      (isolated, user-scoped; commands land in ~/.local/bin)
+#      (isolated, user-scoped; commands land in ~/.local/bin; prebuilt wheels
+#      only, so no C compiler / Xcode tools are needed)
 #   4. optional: Node.js for the browser apps, terminal tools, Ollama, LM Studio
 #   5. registers the gateway as a user service when the installed gateway
 #      supports `abstractgateway service install`, otherwise starts it in the
@@ -35,6 +36,8 @@
 #   --with-core-cli          also expose the `abstractcore` command
 #   --with-ollama            run Ollama's official installer (may ask for sudo)
 #   --with-lmstudio          run LM Studio's headless installer (llmster)
+#   --full                   also build the compiled extras (llama.cpp GGUF,
+#                            stable-diffusion.cpp, echo cancellation); needs a C compiler
 #   --no-tray                skip the tray extra
 #   --no-service             do not register a login service; start in background
 #   --no-start               install only; do not start the gateway
@@ -64,6 +67,40 @@ AF_CRATE_CODE_CLI="abstractcode@0.5.1"
 AF_DOCS="https://github.com/lpalbou/AbstractFramework/blob/main/docs/install.md"
 AF_SCRIPT_URL="https://raw.githubusercontent.com/lpalbou/AbstractFramework/main/scripts/install.sh"
 
+# ---------------------------------------------------------------------------
+# Prebuilt wheels only: by default no C compiler (Xcode CLT, gcc) is needed.
+# A few packages in the gateway tree publish no usable wheel on PyPI, so a plain
+# install compiles them (and on a fresh Mac pops the Xcode tools dialog).
+# `uv tool install` gets an overrides file (an override whose marker is never
+# true drops the package) and --no-build-package for the same packages, so a gap
+# fails fast with a resolver error instead of starting a compiler:
+#   webrtcvad    always dropped; `webrtcvad-wheels` (same module) via --with
+#   vllm         Linux only (no Windows build exists)
+#   the compiled extras, dropped unless --full: llama-cpp-python (llama.cpp
+#   GGUF), stable-diffusion-cpp-python (stable-diffusion.cpp), aec-audio-processing
+#   (echo cancellation). All three are optional and imported lazily; MLX on
+#   Apple Silicon does not need them. --full keeps them and builds them from
+#   source, so it requires a compiler.
+# Pure-Python sdists (langdetect, antlr4-python3-runtime, encodec,
+# transformers-stream-generator) still build: they need no compiler, which is
+# why there is no global --no-build. install.ps1 carries the same lists
+# (tests/test_install_profiles.py keeps them in sync).
+# ---------------------------------------------------------------------------
+AF_WITH_WHEELS="webrtcvad-wheels>=2.0.14"
+AF_COMPILED_EXTRAS="llama-cpp-python stable-diffusion-cpp-python aec-audio-processing"
+AF_SKIPPED_LINE="Skipped compiled extras (llama.cpp GGUF, stable-diffusion.cpp, echo cancellation): re-run with --full after installing a C compiler."
+af_uv_overrides() {
+    echo "webrtcvad; sys_platform == 'never'"
+    echo "vllm>=0.6.0,<1.0.0; sys_platform == 'linux'"
+    if [ "$FULL" = 0 ]; then
+        for _p in $AF_COMPILED_EXTRAS; do echo "$_p; sys_platform == 'never'"; done
+    fi
+}
+af_no_build_packages() {
+    echo "webrtcvad vllm"
+    [ "$FULL" = 1 ] || echo "$AF_COMPILED_EXTRAS"
+}
+
 # ---------------------------------------------------------------------------
 # Options
 # ---------------------------------------------------------------------------
@@ -75,12 +112,12 @@ MANIFEST=""
 DATA_DIR="${AF_DATA_DIR:-${ABSTRACTGATEWAY_DATA_DIR:-}}"
 WITH_APPS=0; WITH_CONSOLE=0; WITH_CODE_CLI=0; WITH_CORE_CLI=0
 WITH_OLLAMA=0; WITH_LMSTUDIO=0
-NO_TRAY=0; NO_SERVICE=0; NO_START=0; NO_OPEN=0; NO_MODIFY_PATH=0
+FULL=0; NO_TRAY=0; NO_SERVICE=0; NO_START=0; NO_OPEN=0; NO_MODIFY_PATH=0
 PRINT=0; UNINSTALL=0; PURGE=0; VERBOSE=0
 
 usage() {
     if [ -f "$0" ] && head -n 3 "$0" 2>/dev/null | grep -q "AbstractFramework bootstrap"; then
-        sed -n '2,50p' "$0" | sed 's/^# \{0,1\}//'
+        sed -n '2,52p' "$0" | sed 's/^# \{0,1\}//'
     else
         echo "Usage: install.sh [--profile auto|light|apple|gpu] [--port N] [--pin X] [--with-apps]"
         echo "                  [--with-ollama] [--with-lmstudio] [--no-service] [--no-open] [--print] [--uninstall]"
@@ -111,6 +148,7 @@ while [ $# -gt 0 ]; do
         --with-core-cli) WITH_CORE_CLI=1 ;;
         --with-ollama) WITH_OLLAMA=1 ;;
         --with-lmstudio) WITH_LMSTUDIO=1 ;;
+        --full) FULL=1 ;;
         --no-tray) NO_TRAY=1 ;;
         --no-service) NO_SERVICE=1 ;;
         --no-start) NO_START=1 ;;
@@ -350,6 +388,18 @@ printf '%sAbstractFramework bootstrap%s  %s%s%s\n' "$C_B" "$C_0" "$C_D" \
 
 step "Preflight"
 ok "system: $OS_ID $ARCH$([ -n "$MACOS_VERSION" ] && echo " (macOS $MACOS_VERSION)")"
+HAS_CC=1
+if [ "$OS_ID" = macos ]; then xcode-select -p >/dev/null 2>&1 || HAS_CC=0
+elif ! have cc && ! have gcc; then HAS_CC=0; fi
+if [ "$HAS_CC" = 0 ]; then
+    if [ "$FULL" = 1 ]; then
+        if [ "$OS_ID" = macos ]; then die "--full builds llama.cpp, stable-diffusion.cpp and echo cancellation from source and needs a C compiler: run 'xcode-select --install', then re-run with --full"
+        else die "--full builds llama.cpp, stable-diffusion.cpp and echo cancellation from source and needs a C compiler: install one (Debian/Ubuntu: sudo apt-get install -y build-essential), then re-run with --full"; fi
+    fi
+    info "no C compiler ($([ "$OS_ID" = macos ] && echo 'Xcode CLT' || echo 'cc/gcc')) – fine, all packages install as prebuilt wheels"
+elif [ "$FULL" = 1 ]; then
+    ok "C compiler found: --full builds the compiled extras from source (several minutes)"
+fi
 DL="$(fetch_cmd)"
 [ -n "$DL" ] || die "need curl or wget"
 
@@ -499,13 +549,27 @@ run "install Python $AF_PYTHON" "$UV" python install "$AF_PYTHON"
 step "AbstractGateway"
 BEFORE=""
 if [ "$PRINT" = 0 ]; then BEFORE="$("$UV" tool list 2>/dev/null | sed -n 's/^abstractgateway v\([^ ]*\).*/\1/p' | head -n 1)"; fi
-set -- "$UV" tool install --python "$AF_PYTHON"
+OVERRIDES_FILE="$DATA_DIR/uv-overrides.txt"
+if [ "$PRINT" = 1 ]; then
+    info "$OVERRIDES_FILE (written at install time; see the top of install.sh):"
+    af_uv_overrides | sed 's/^/      /'
+else
+    af_uv_overrides >"$OVERRIDES_FILE"
+fi
+# uv splits an --overrides value at whitespace ("Application Support"), so the install
+# runs from the data dir and names the file relatively.
+set -- "$UV" tool install --python "$AF_PYTHON" --with "$AF_WITH_WHEELS" --overrides uv-overrides.txt
+for _p in $(af_no_build_packages); do set -- "$@" --no-build-package "$_p"; done
 [ "$WITH_CORE_CLI" = 1 ] && set -- "$@" --with-executables-from abstractcore
 if [ -n "$BEFORE" ] && [ "$PIN" = latest ] && [ -z "$FROM" ] && [ "$ST_PROFILE" = "$PROFILE" ]; then
     run "upgrade abstractgateway" "$UV" tool upgrade abstractgateway
 else
     [ -n "$FROM" ] && set -- "$@" --reinstall
+    _cwd="$(pwd)"
+    RUN_SHOW="cd $(q "$DATA_DIR") && $(show_cmd "$@" "$GW_SPEC")"
+    [ "$PRINT" = 1 ] || cd "$DATA_DIR"
     run "install abstractgateway" "$@" "$GW_SPEC"
+    [ "$PRINT" = 1 ] || cd "$_cwd" 2>/dev/null || cd "$HOME"
 fi
 AFTER="$BEFORE"
 if [ "$PRINT" = 0 ]; then
@@ -728,6 +792,9 @@ echo "  Start:      $([ "$MODE" = service ] && echo "abstractgateway service ins
 echo "  Upgrade:    re-run this installer (or: uv tool upgrade abstractgateway)"
 echo "  Uninstall:  sh install.sh --uninstall   (or: $([ "$MODE" = service ] && echo 'abstractgateway service uninstall && ')uv tool uninstall abstractgateway)"
 echo "  Check:      uvx abstractframework doctor"
+if [ "$FULL" = 0 ] && { [ "$PROFILE" = apple ] || [ "$PROFILE" = gpu ]; }; then
+    echo "  $AF_SKIPPED_LINE"
+fi
 echo "  Apps:       npx -y @abstractframework/flow   (also: code, observer, continuum, entity)"
 echo "  Docs:       $AF_DOCS"
 if [ -n "$TWINS" ]; then