Computers for
AI agents.

Python

Install · Python 3.10+

python3 -m pip install mandala-computer
export MANDALA_API_KEY="YOUR_API_KEY"

Save as example.py

from pathlib import Path
from mandala_computer import Client

client = Client()
c = client.computers.create(template="base")
print(c.id)  # find it in your dashboard
c.wait_for_guest()
c.open("https://example.com")
Path("screen.png").write_bytes(c.screenshot())

Run python3 example.py in the same terminal. The screenshot is saved locally; the computer stays in your account. Python guide →

TypeScript

Install · Node.js 22+

npm install mandala-computer
export MANDALA_API_KEY="YOUR_API_KEY"

Save as example.mjs · runs directly in Node.js

import { writeFile } from 'node:fs/promises';
import { Client } from 'mandala-computer';

const client = new Client();
const c = await client.computers.create({
  template: 'base',
});
console.log(c.id); // find it in your dashboard
await c.waitForGuest();
await c.open('https://example.com');
await writeFile('screen.png', await c.screenshot());

Run node example.mjs in the same terminal. The SDK includes TypeScript types; this example also runs as JavaScript. The computer stays in your account. TypeScript guide →

The same package is the mandala command-line client. To install only the command, with Node.js 22+ and npm: curl -fsSL https://mandala.computer/install.sh | sh. Or with Homebrew, which brings its own Node.js: brew install mandalacomputer/tap/mandala.

cd "$(mktemp -d)"
curl -fsSLO https://mandala.computer/install.sh
curl -fsSLO https://mandala.computer/install.sh.sha256
shasum -a 256 -c install.sh.sha256 && sh install.sh

MCP

Claude Code · Node.js 20.3+

claude mcp add mandala \
  -e MANDALA_API_KEY="YOUR_API_KEY" \
  -- npx -y mandala-computer-mcp

Run this in your terminal, then start a new Claude Code session in the same project and ask:

Create a computer from the base template, open example.com, and show me a screenshot.

MCP connects your existing agent to Mandala's desktop tools. The computer stays in your account. Claude Desktop and other MCP clients →