docs: ship no model; make the assistant model-optional
Some checks are pending
ci / test (push) Waiting to run

The AI assistant stays a defining, always-present subsystem, but Phoebus
ships no model. The user may download a local model or configure a remote
provider; with no model the assistant still explains, plans and applies
deterministic changes and the CLI remains available. Installation requires the
network; the installed system must boot, run and recover offline.
This commit is contained in:
Phoebus 2026-09-20 14:29:59 -07:00
parent 15cc9ec58c
commit 9ae86d5234
2 changed files with 15 additions and 11 deletions

View file

@ -11,10 +11,11 @@ It is deliberately concrete: follow it rather than rediscovering the project.
Phoebus OS is a **modern, stable, Gentoo-based workstation operating system**: Phoebus OS is a **modern, stable, Gentoo-based workstation operating system**:
systemd, Wayland-first, PipeWire, UEFI/GPT, LUKS2, Btrfs with snapshots, a fast systemd, Wayland-first, PipeWire, UEFI/GPT, LUKS2, Btrfs with snapshots, a fast
dwl-style desktop, Flatpak, and a built-in AI administration assistant. The AI dwl-style desktop, Flatpak, and a built-in AI administration assistant. The AI
assistant and Nix are **defining, always-present subsystems**: the assistant assistant and Nix are **defining, always-present subsystems**: the assistant is
ships with a **local model** so it works offline and in recovery, and Nix is a built in and *model-optional* (the user may download a local model or configure
second package lane shipped and updated through Portage. Installation requires a remote provider; no model is shipped), and Nix is a second package lane
the network; the installed system must boot, run and recover without it. The shipped and updated through Portage. Installation requires the network; the
installed system must boot, run and recover without it. The
LLM never holds privilege (see §2.4). LLM never holds privilege (see §2.4).
Fastest start: run `make context` (prints repository state, the roadmap's Fastest start: run `make context` (prints repository state, the roadmap's

View file

@ -34,9 +34,10 @@ Modern architecture + mature implementations
browsers) where legally distributable. No moralising warnings; respect browsers) where legally distributable. No moralising warnings; respect
licences. licences.
- **AI-first, built in.** The assistant and Nix are defining, always-present - **AI-first, built in.** The assistant and Nix are defining, always-present
subsystems, not optional add-ons. The assistant ships with a **local model** subsystems, not optional add-ons. The assistant is **model-optional**: Phoebus
so it works offline; remote providers are an optional upgrade. A Phoebus ships no model, but the user can download a local one or configure a remote
system must boot, run and recover without the network. provider. With no model it still explains, plans and applies validated,
deterministic changes. A Phoebus system must boot, run and recover offline.
- **Nix as a second, built-in package lane.** Portage stays authoritative for - **Nix as a second, built-in package lane.** Portage stays authoritative for
the system (kernel, drivers, systemd, Mesa, PipeWire, core libraries, boot, the system (kernel, drivers, systemd, Mesa, PipeWire, core libraries, boot,
services); Nix provides developer tools, alternate versions and reproducible services); Nix provides developer tools, alternate versions and reproducible
@ -58,10 +59,12 @@ The model never receives the user's sudo password (authentication happens
through sudo/polkit/PAM outside model context), and it has no code path to through sudo/polkit/PAM outside model context), and it has no code path to
read private files: system access is not home-directory access. read private files: system access is not home-directory access.
The default brain is a **local model**, so the assistant works without a network Phoebus ships **no model**. The assistant is *model-optional*: the user may
and inside recovery. Remote providers (DeepSeek/OpenAI) are optional and only download a local model or configure a remote provider (DeepSeek/OpenAI), and a
ever receive approved, bounded system facts. Installation requires the network configured provider only ever receives approved, bounded system facts. With no
(stage3, Portage, packages); the installed system must not. model, the assistant still offers offline explainers, planning and validated
deterministic actions, and the CLI is always available. Installation requires
the network (stage3, Portage, packages); the installed system must not.
The assistant is the **preferred front-end, never a gate**. The deterministic The assistant is the **preferred front-end, never a gate**. The deterministic
command line is always available with no model, and a user who wants the command line is always available with no model, and a user who wants the