Setup Wizard
The local B3IQ wizard for claiming a node, reviewing hardware, choosing mode, installing models, and creating local credentials.
The setup wizard is the operator UI served by the host agent at /setup/. It
turns a fresh install into a claimed local node and keeps every important
readiness signal visible.
Setup Flow
Open the local wizard
Use the setup URL printed by the installer or ask the host agent for a fresh tokenized URL.
Claim ownership
Create the first local owner account. Future setup access uses owner auth rather than relying on bootstrap tokens.
Review inventory
Check CPU, RAM, GPU, disk, OS, runtime, model, and network posture reported by the host agent.
Choose operating mode
Local Mode is the default. Managed Mode is a deliberate opt-in. Network Mode remains gated by route, protocol, model, benchmark, and customer policy.
Install models and test
Pick model profiles, watch install jobs, and use the local playground when the runtime is ready.
Wizard Principles
Expose real machine state
The wizard should show identity, readiness, runtime, endpoint, model profile, enrollment, support grants, and audit state.
Hide advanced state behind marketing copy
Operators are configuring real hardware. Trust comes from visible state, explicit actions, and clear recovery paths.
Setup Surfaces
| Surface | Purpose | Credential |
|---|---|---|
| Bootstrap setup URL | Initial claim or recovery entry | Setup token |
| Owner login | Normal local operator access | HttpOnly session cookie |
| Local API keys | Local inference clients | `b3iq_local_` scoped secret |
| Support grants | Temporary diagnostics access | `b3iq_support_` scoped secret |
| Managed enrollment | Signed node sync with control plane | Node Ed25519 identity |
Local Playground
Signed-in operators can use persisted local playground sessions to test runtime and model behavior. API-key request logs stay separate and redacted by default.
Use the playground for operator smoke testing. Use b3iq_local_ API keys for
application clients.
Appliance And Network Step
The wizard can read appliance planning state from the host agent, including OS support, NetworkManager presence, setup endpoint, Wi-Fi planning, and hotspot recovery status. The current Linux Wi-Fi plan is non-mutating. Real network changes require future apply gates and hardware smoke evidence.