osirAgentDeploy
osirAgentDeploy: Install a ready-made AI agent - Hermes (Hermes Agent by Nous Research, a self-hosted personal AI agent with a web dashboard) - on the user's OWN VPS, behind HTTPS with a password-protected dashboard. Use this for 'run/install Hermes on my server' INSTEAD of osirAppDeploy, a hand-written Dockerfile, SSH or an install script: the platform installs the vetted agent itself. Needs a VPS with at least 4 GB RAM. TWO WAYS IN, like osirAppDeployToVps: (1) the user already owns a VPS: pass instanceId (from listMyVpsInstances) - spends nothing, no confirmation; (2) no server yet: pass packageId (from listVpsPackages, 4 GB+ RAM) - stages a VPS order (COSTS MONEY): returns an actionId; present the price/summary and call executeConfirmedAction only if the user approves. The result carries the username and the PASSWORD: show the password to the user once, in that reply - it is never shown again (osirAgentResetPassword makes a new one). Then poll osirAgentStatus until installed - it gives the dashboard URL (without a domain, Osir assigns the address; never build it) - and connect a model provider with osirAgentConfigure. Calling this again resumes an install and never buys a second VPS. If the platform says the agent is not available yet, tell the user plainly. Requires authentication.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"agent": "<agent>"
},
"name": "osirAgentDeploy"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent | Yes | The agent to install. Currently only 'hermes'. | |
| domain | No | A domain the user owns to serve the dashboard on, e.g. 'agent.example.com'. Bound automatically if its DNS is hosted at Osir, otherwise the result says which A record to add. Omit it to get an Osir address automatically; never pass an osir.app name. | |
| username | No | Dashboard login name; default 'admin'. | |
| packageId | No | VPS package id from listVpsPackages (at least 4 GB RAM). Only when a server has to be ordered; omit it when passing instanceId. | |
| instanceId | No | Id of a VPS the user ALREADY owns, from listMyVpsInstances. Nothing is ordered or charged. Never invent one. | |
| sessionKey | No | Session key (osk_...) returned by checkDeviceLoginStatus. Pass it on every call when logged in via the in-chat device flow; omit when connected via OAuth. |