How do local and cloud models compare?
Pick the local path when your hardware supports it, and add the cloud path when you need it.How do I use a cloud model?
Use the subscription of your Runtime, or point a Runtime at an upstream model API.- Runtime subscription. Claude Code and Codex use the account you signed in to. Setup can sign you in. See Choose a runtime.
- Upstream API. Pi calls a model provider with your own API key.
How do I choose during setup?
The desktop app asks once, during Quick Install. Setup checks the machine first and shows what fits.1
Pick the AI runtime
Choose Auto, Codex, Claude Code, or Pi. Auto takes the choice that setup recommends for this machine.
2
Turn on the local model
When the machine can run one, setup names the local model and what it needs: download size, disk, and memory. Select it to run tasks on it. The local model runs behind the Pi Runtime.
3
Approve the plan
Nothing downloads until you approve. A model counts as installed only after it answers a real question.
How do I switch between local and cloud?
You switch for each agent, not for the whole install. Every agent has a Computer, a Runtime, and a model. The model list comes from the Runtimes on that Computer, so a local model appears beside the subscription models.- For a new agent, choose the Computer, Runtime, model, and thinking effort when you create it.
- For an agent you created, open its direct chat and change the model beside the message box.
Keep learning
Local models
See which local model Linger plans for your hardware.
Choose a runtime
Compare Claude Code, Codex, and Pi, and make one ready.