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**:
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
assistant and Nix are **defining, always-present subsystems**: the assistant
ships with a **local model** so it works offline and in recovery, and Nix is a
second package lane shipped and updated through Portage. Installation requires
the network; the installed system must boot, run and recover without it. The
assistant and Nix are **defining, always-present subsystems**: the assistant is
built in and *model-optional* (the user may download a local model or configure
a remote provider; no model is shipped), and Nix is a second package lane
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).
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
licences.
- **AI-first, built in.** The assistant and Nix are defining, always-present
subsystems, not optional add-ons. The assistant ships with a **local model**
so it works offline; remote providers are an optional upgrade. A Phoebus
system must boot, run and recover without the network.
subsystems, not optional add-ons. The assistant is **model-optional**: Phoebus
ships no model, but the user can download a local one or configure a remote
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
the system (kernel, drivers, systemd, Mesa, PipeWire, core libraries, boot,
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
read private files: system access is not home-directory access.
The default brain is a **local model**, so the assistant works without a network
and inside recovery. Remote providers (DeepSeek/OpenAI) are optional and only
ever receive approved, bounded system facts. Installation requires the network
(stage3, Portage, packages); the installed system must not.
Phoebus ships **no model**. The assistant is *model-optional*: the user may
download a local model or configure a remote provider (DeepSeek/OpenAI), and a
configured provider only ever receives approved, bounded system facts. With no
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
command line is always available with no model, and a user who wants the