Agents
Pi
Run the Pi coding agent as a durable Rivet Actor.
@rivet-dev/pi runs the Pi coding agent in a Rivet Actor. The agent loop runs in the Actor. Pi’s file and shell tools run in a separate sandbox.
Each Actor holds one Pi session and saves it in its SQLite database, so a conversation survives sleep and restarts.
To get started, follow the Quickstart.
Configuration
The Pi Actor accepts every actor() option except db, which Pi uses for the session, and Pi’s session options, such as thinkingLevel, tools, and customTools. It also accepts:
| Option | Description |
|---|---|
model | Model for a new session, as provider/modelId. |
scopedModels | Models a client may switch to with setModel. |
apiKeys | API keys by provider. Defaults to the environment. |
providers | Custom providers, in the shape of Pi’s models.json. |
credentials | Logins your application stores. See User Subscriptions. |
sandbox | Where Pi’s file and shell tools run. See Sandboxes. |
settings | Pi settings for a new session. |