osirAppDeploy
osirAppDeploy: Deploy an app to Osir (free tier) and get a live HTTPS URL; the app runs isolated in a microVM. Send the project's source as 'files' (each {path, content}) - you never zip, upload or make an HTTP request yourself. Returns immediately with status BUILDING: poll osirAppStatus until READY (typically 1-2 min, up to ~7 for a first build) before telling the user the URL is live; if it ends BUILD_FAILED, fix the source and redeploy - never deploy around a failed build by hand. Deploying an existing app name redeploys it (new version) and applies any secrets set via osirAppSetSecret. A plain static website (HTML/CSS/JS with no framework or build step) is also supported: it is auto-detected and served directly; pass language 'node' for it. If the project has its own Dockerfile at the root, the platform builds exactly that: pass language 'node' for it; the container must listen on port 8080. Shared-tier apps get 256 MB / 0.5 CPU, so a big image-based app belongs on the user's own VPS (osirAppDeployToVps). For a ready-made AI agent (Hermes), use osirAgentDeploy - never this tool and never a hand-written Dockerfile. To put the app on the user's OWN VPS, server or production box instead, deploy it here first and then call osirAppDeployToVps - never SSH into the box or write an install script. Once an app is on the user's own VPS, redeploying HERE under the same name is how you update it: the platform re-ships it to the box and keeps its domain. 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": {
"name": "<name>",
"language": "<language>"
},
"name": "osirAppDeploy"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | App name: lowercase letters, digits, and hyphens, e.g. 'habit-tracker'. | |
| files | No | The project's source files: [{path, content, encoding?}]. path is relative and forward-slashed (e.g. 'src/index.js'); encoding is 'utf8' (default) or 'base64' for binaries such as images. Include every file the app needs - omitted files are not in the new version. Up to 500 files / 6 MiB. Use this OR uploadTicket. | |
| region | No | Region: 'us' or 'al' ('al' is Albania/Tirana); defaults to the platform's home region. | |
| language | Yes | Runtime language: 'node', 'python', 'php-laravel', or 'go'; use 'node' for a plain static site or a project with its own Dockerfile. | |
| 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. | |
| uploadTicket | No | Only for the shell path: upload ticket from osirAppCreateUpload, after PUTting the zipped source to its putUrl. Leave out when sending files. |