English Français العربية

Runtime Cloud

السجل الرسمي الذكاء الاصطناعي والوكلاء

Linux microVM sandboxes for AI agents: run commands, files, processes, pause and wake.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http runtime-cloud 'https://api.withruntime.com/mcp' --header 'Authorization: <Optional: Bearer <key> from https://withruntime.com/account/keys. Without it the client signs in through the browser (OAuth).>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "runtime-cloud": {
            "type": "http",
            "url": "https://api.withruntime.com/mcp",
            "headers": {
                "Authorization": "<Optional: Bearer <key> from https://withruntime.com/account/keys. Without it the client signs in through the browser (OAuth).>"
            }
        }
    }
}
NPM package withruntime
Claude Code 
claude mcp add runtime-cloud -- npx -y withruntime@0.37.0 mcp
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "runtime-cloud": {
            "command": "npx",
            "args": [
                "-y",
                "withruntime@0.37.0",
                "mcp"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Runtime
  2. What is here
  3. Documentation
  4. How Runtime compares
  5. Tests
  6. Contributing
  7. License

Runtime

The SDKs, CLI, MCP server and agent integrations for Runtime: sandboxes for AI agents. Each sandbox is a Firecracker microVM with its own Linux kernel, started from one call.

npm install withruntime   # TypeScript SDK, the `runtime` CLI and the MCP server
pip install withruntime   # Python SDK, sync and async
import { Sandbox } from "withruntime";

await using sbx = await Sandbox.create();
const result = await sbx.exec("python3 -c 'print(6 * 7)'");
console.log(result.exitCode, result.stdout);
from withruntime import Sandbox

with Sandbox.create() as sbx:
    result = sbx.exec("python3 -c 'print(6 * 7)'")
    print(result.exit_code, result.stdout)

The client reads RUNTIME_API_KEY, or the connection npx withruntime login saved on this machine. A new account starts on a free trial with no card. The quickstart takes it from there.

What is here

PathWhat it is
packages/cloud-sdkThe TypeScript SDK, the runtime CLI and the MCP server: withruntime on npm
sdks/pythonThe Python SDK: withruntime on PyPI
sdks/python/integrations/langchain-withruntimeLangChain and Deep Agents sandbox backend
sdks/go, sdks/java, sdks/rubyThe Go, Java and Ruby SDKs
integrations/openai-agents, pydantic-ai, google-adk, smolagentsOpenAI Agents SDK, Pydantic AI, Google ADK and smolagents integrations, each <name>-withruntime on PyPI
integrations/claude-code, codex, cursor, gemini-cli, vscode, windsurfSkills, rules and MCP settings for coding agents
packages/cloud-guide/docsThe guides served at withruntime.com/docs, which the SDK tests check samples against

Documentation

How Runtime compares

Pages that answer what people ask when choosing a sandbox, each with the providers' published rates and the date they were read:

Tests

bun test in packages/cloud-sdk and python3 -m unittest discover -s tests in sdks/python run here as they are. The suites that start Runtime's API server in-process, including all of the Go, Java and Ruby tests, run in Runtime's main repository before each release.

Contributing

Each release copies the SDKs here from Runtime's main repository, so each commit here is one copy, named after the versions in its source; a copy made before those versions reach npm and PyPI says so. Issues are welcome. A pull request is reviewed here and carried into the next release with its author credited.

License

Apache-2.0. See LICENSE.

الأسئلة الشائعة

ما هو Runtime Cloud؟

Linux microVM sandboxes for AI agents: run commands, files, processes, pause and wake.

كيف أثبّت Runtime Cloud؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http runtime-cloud 'https://api.withruntime.com/mcp' --header 'Authorization: <Optional: Bearer <key> from https://withruntime.com/account/keys. Without it the client signs in through the browser (OAuth).>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Runtime Cloud إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل Runtime Cloud مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص Apache-2.0.

من يصون Runtime Cloud؟

ينشره withruntime. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.