pi
Run bots on the pi coding agent with the providers and keys you've set up in pi itself.
When to use it
- You already use pi with your own keys.
- You want a local model with a full set of tools.
- You want a bot that can control a USB-connected Android phone on a keys-only setup.
Install
Step 1
Find the engine
Open SettingsModels & enginesEngines and find pi.
You're done when: you can see the pi row and its status line.
Step 2
Install it
If it says Not detected, choose Open install in Terminal. Murage opens Terminal with this command ready to paste:
npm install -g @earendil-works/pi-coding-agent
This needs Node.js and npm.
You're done when: the install command has finished without errors.
Step 3
Set up a provider in pi
Set up at least one provider in pi itself, following pi's own guide (View setup guide).
You're done when: pi has at least one provider.
Step 4
Check again
Back in Murage, choose Check again.
You're done when: pi shows a model list.
What works
- Tools: handing work to other bots, memory search, connected apps, cloud and local computers, this computer (pi shows its own approval prompt, which Murage turns into an approval card) and a USB-connected Android phone.
- Pictures you attach reach pi as a file it opens with its own file reader.
- Model picking: the models pi reports as available, shown as provider and model, plus local models from SettingsModelsLocal models. You can switch the model within a conversation.
- Effort: set in Bot settingsModel. Higher levels only apply on models that support them; otherwise pi keeps its default.
When you pick a local model for a pi bot, Murage adds that server to pi's own models file (~/.pi/agent/models.json) so pi can reach it.
Approvals
A pi bot asks Murage before it runs a command, edits outside its folder or uses a connected app. It follows the same approval levels, stop line and Always allow choices. See Permissions and the stop line.
Known limits
- No custom MCP servers and no built-in browser. pi doesn't take Murage's custom MCP servers or the built-in browser.
- No engine commands in the
/menu. Only Murage's own commands appear for pi bots. - No Flux Router tiers. pi uses its own providers.
- Voice needs its own keys. Voice calls need Flux Router credits or your own voice keys.
Troubleshooting
You see
pi CLI not foundDo this
Install pi, restart Murage, or choose Set CLI… and pick the program yourself.
You see
The model list is emptyDo this
Pi has no providers set up. Add one in pi, then choose Check again. Or add a local server under SettingsModelsLocal models.
You see
A model failsDo this
Try the same model in pi on its own in a terminal. If it fails there too, check that provider's key in pi.