Sandbox Agent SDK

सैंडबॉक्स में कोडिंग एजेंट चलाएं। उन्हें HTTP के माध्यम से नियंत्रित करें।

एक सर्वर जो आपके सैंडबॉक्स के अंदर चलता है। आपका ऐप Claude Code, Codex, OpenCode, Cursor, Amp या Pi को नियंत्रित करने के लिए दूरस्थ रूप से कनेक्ट होता है — ईवेंट स्ट्रीम करता है, अनुमतियाँ संभालता है, सत्र प्रबंधित करता है।

दस्तावेज़ीकरण — API संदर्भ — Discord

प्रयोगात्मक: Gigacode — किसी भी कोडिंग एजेंट के साथ OpenCode के TUI का उपयोग करें।

Sandbox Agent क्यों?

कोडिंग एजेंटों को दूरस्थ रूप से चलाना कठिन है। मौजूदा SDK स्थानीय निष्पादन मानते हैं, SSH TTY हैंडलिंग और स्ट्रीमिंग को तोड़ देता है, और हर एजेंट का एक अलग API होता है। शुरू से बनाने का मतलब है प्रत्येक कोडिंग एजेंट के लिए सब कुछ फिर से लागू करना।

Sandbox Agent तीन समस्याओं को हल करता है:

कोडिंग एजेंटों को सैंडबॉक्स की आवश्यकता होती है — आप AI को अपने प्रोडक्शन सर्वर पर मनमाना कोड निष्पादित नहीं करने दे सकते। कोडिंग एजेंटों को पृथक वातावरण की आवश्यकता होती है, लेकिन मौजूदा SDK स्थानीय निष्पादन मानते हैं। Sandbox Agent एक सर्वर है जो सैंडबॉक्स के अंदर चलता है और HTTP/SSE को उजागर करता है।
हर कोडिंग एजेंट अलग है — Claude Code, Codex, OpenCode, Cursor, Amp और Pi में प्रत्येक के मालिकाना API, ईवेंट प्रारूप और व्यवहार हैं। एजेंटों को स्वैप करने का मतलब है आपके एकीकरण को फिर से लिखना। Sandbox Agent एक HTTP API प्रदान करता है — अपना कोड एक बार लिखें, कॉन्फ़िगर बदलकर एजेंट स्वैप करें।
सत्र क्षणभंगुर होते हैं — एजेंट ट्रांसक्रिप्ट सैंडबॉक्स में रहते हैं। जब प्रक्रिया समाप्त होती है, तो आप सब कुछ खो देते हैं। Sandbox Agent ईवेंट को एक सार्वभौमिक स्कीमा में आपके स्टोरेज में स्ट्रीम करता है। Postgres, ClickHouse या Rivet में स्टोर करें। बाद में रीप्ले करें, हर चीज़ का ऑडिट करें।

सुविधाएँ

यूनिवर्सल एजेंट API: Claude Code, Codex, OpenCode, Cursor, Amp और Pi को पूर्ण सुविधा कवरेज के साथ नियंत्रित करने के लिए एकल इंटरफ़ेस
यूनिवर्सल सत्र स्कीमा: मानकीकृत स्कीमा जो भंडारण और रीप्ले के लिए सभी एजेंट ईवेंट प्रारूपों को सामान्य करता है
किसी भी सैंडबॉक्स के अंदर चलता है: हल्का स्टैटिक Rust बाइनरी। E2B, Daytona, Modal, Cloudflare Containers, Agent Computer या Docker के अंदर स्थापित करने के लिए एक curl कमांड
सर्वर या SDK मोड: HTTP सर्वर के रूप में चलाएं या TypeScript SDK के साथ एम्बेड करें
OpenAPI विनिर्देश: अच्छी तरह से प्रलेखित और किसी भी भाषा से एकीकृत करना आसान
OpenCode SDK और UI समर्थन (प्रयोगात्मक): परिचित OpenCode टूलिंग के माध्यम से एजेंटों को नियंत्रित करने के लिए OpenCode CLI, SDK या वेब UI कनेक्ट करें

आर्किटेक्चर

एजेंट आर्किटेक्चर आरेख

Sandbox Agent आपके क्लाइंट एप्लिकेशन और विभिन्न कोडिंग एजेंटों के बीच एक यूनिवर्सल एडेप्टर के रूप में कार्य करता है। प्रत्येक एजेंट का अपना एडेप्टर है जो यूनिवर्सल API और एजेंट-विशिष्ट इंटरफ़ेस के बीच अनुवाद को संभालता है।

एम्बेडेड मोड: एजेंटों को उपप्रक्रियाओं के रूप में स्थानीय रूप से चलाता है
सर्वर मोड: किसी भी सैंडबॉक्स प्रदाता से HTTP सर्वर के रूप में चलता है

आर्किटेक्चर दस्तावेज़ीकरण

घटक

आरंभ करें

अपने उपयोग के मामले के लिए सबसे उपयुक्त इंस्टॉलेशन विधि चुनें।

Skill

Skill को इसके साथ इंस्टॉल करें:

npx skills add rivet-dev/skills -s sandbox-agent

bunx skills add rivet-dev/skills -s sandbox-agent

TypeScript SDK

SDK को सीधे अपने Node या ब्राउज़र एप्लिकेशन में आयात करें। पूर्ण प्रकार सुरक्षा और स्ट्रीमिंग समर्थन।

इंस्टॉल

npm install [email protected]

bun add [email protected]
# वैकल्पिक: मूल बाइनरी के लिए पोस्टइंस्टॉल स्क्रिप्ट चलाने के लिए Bun को अनुमति दें (SandboxAgent.start() के लिए आवश्यक)।
bun pm trust @sandbox-agent/cli-linux-x64 @sandbox-agent/cli-linux-arm64 @sandbox-agent/cli-darwin-arm64 @sandbox-agent/cli-darwin-x64 @sandbox-agent/cli-win32-x64

सेटअप

स्थानीय (एम्बेडेड मोड):

import { SandboxAgent } from "sandbox-agent";

const client = await SandboxAgent.start();

दूरस्थ (सर्वर मोड):

import { SandboxAgent } from "sandbox-agent";

const client = await SandboxAgent.connect({
  baseUrl: "http://127.0.0.1:2468",
  token: process.env.SANDBOX_TOKEN,
});

API अवलोकन

const agents = await client.listAgents();

await client.createSession("demo", {
  agent: "codex",
  agentMode: "default",
});

await client.postMessage("demo", { message: "Hello from the SDK." });

for await (const event of client.streamEvents("demo", { offset: 0 })) {
  console.log(event.type, event.data);
}

SDK दस्तावेज़ीकरण — सत्र प्रबंधन

HTTP सर्वर

HTTP सर्वर के रूप में चलाएं और किसी भी भाषा से कनेक्ट करें। E2B, Daytona, Vercel या अपने स्वयं के बुनियादी ढांचे पर तैनात करें।

# इसे इंस्टॉल करें
curl -fsSL https://releases.rivet.dev/sandbox-agent/0.4.x/install.sh | sh
# इसे चलाएं
sandbox-agent server --token "$SANDBOX_TOKEN" --host 127.0.0.1 --port 2468

वैकल्पिक: एजेंट बाइनरी को पूर्व-स्थापित करें (कोई सर्वर आवश्यक नहीं; यदि आप इसे छोड़ देते हैं तो वे पहले उपयोग पर आलसी रूप से स्थापित हो जाएंगे):

sandbox-agent install-agent --all

प्रमाणीकरण को स्थानीय रूप से अक्षम करने के लिए:

sandbox-agent server --no-token --host 127.0.0.1 --port 2468

त्वरित आरंभ — तैनाती गाइड

CLI

CLI रैपर इंस्टॉल करें (वैकल्पिक लेकिन सुविधाजनक):

npm install -g @sandbox-agent/[email protected]

# मूल बाइनरी के लिए पोस्टइंस्टॉल स्क्रिप्ट चलाने के लिए Bun को अनुमति दें।
bun add -g @sandbox-agent/[email protected]
bun pm -g trust @sandbox-agent/cli-linux-x64 @sandbox-agent/cli-linux-arm64 @sandbox-agent/cli-darwin-arm64 @sandbox-agent/cli-darwin-x64 @sandbox-agent/cli-win32-x64

एक सत्र बनाएं और एक संदेश भेजें:

sandbox-agent api sessions create my-session --agent codex --endpoint http://127.0.0.1:2468 --token "$SANDBOX_TOKEN"
sandbox-agent api sessions send-message my-session --message "Hello" --endpoint http://127.0.0.1:2468 --token "$SANDBOX_TOKEN"
sandbox-agent api sessions send-message-stream my-session --message "Hello" --endpoint http://127.0.0.1:2468 --token "$SANDBOX_TOKEN"

आप npx का उपयोग इस प्रकार भी कर सकते हैं:

npx @sandbox-agent/[email protected] --help

bunx @sandbox-agent/[email protected] --help

CLI दस्तावेज़ीकरण

इंस्पेक्टर

अंतर्निहित इंस्पेक्टर UI (जैसे, http://localhost:2468/ui/) के साथ सत्रों और ईवेंटों को डीबग करें।

Sandbox Agent इंस्पेक्टर

इंस्पेक्टर दस्तावेज़ीकरण

OpenAPI विनिर्देश

API एक्सप्लोर करें — विनिर्देश देखें

टिप: क्रेडेंशियल निकालें

अक्सर आपको सैंडबॉक्स पर एजेंटों का परीक्षण करने के लिए अपने व्यक्तिगत API टोकन का उपयोग करने की आवश्यकता होती है:

sandbox-agent credentials extract-env --export

यह Sandbox Agent SDK के साथ परीक्षण करने के लिए आपकी OpenAI/Anthropic आदि API कुंजियों के लिए पर्यावरण चर प्रिंट करता है।

FAQ

क्या यह Vercel AI SDK को बदलता है?

नहीं, ये पूरक हैं। AI SDK चैट इंटरफ़ेस बनाने और LLM को कॉल करने के लिए है। यह SDK स्वायत्त कोडिंग एजेंटों को नियंत्रित करने के लिए है जो कोड लिखते हैं और कमांड चलाते हैं। अपने UI के लिए AI SDK का उपयोग करें, इसका उपयोग करें जब आपको एक एजेंट की आवश्यकता हो जो वास्तव में कोड करे।

कौन से कोडिंग एजेंट समर्थित हैं?

Claude Code, Codex, OpenCode, Cursor, Amp और Pi। SDK उनके API को सामान्य करता है ताकि आप अपना कोड बदले बिना उनके बीच स्वैप कर सकें।

सत्र डेटा कैसे संग्रहीत किया जाता है?

यह SDK सत्र डेटा के भंडारण को संभालता नहीं है। ईवेंट एक सार्वभौमिक JSON स्कीमा में स्ट्रीम होते हैं जिसे आप कहीं भी स्टोर कर सकते हैं। Postgres या Rivet Actors का उपयोग करके पैटर्न के लिए सत्र प्रबंधन देखें।

क्या मैं इसे स्थानीय रूप से चला सकता हूं या क्या इसके लिए सैंडबॉक्स प्रदाता की आवश्यकता है?

दोनों। विकास के लिए स्थानीय रूप से चलाएं, उत्पादन के लिए E2B, Daytona या Vercel Sandboxes पर तैनात करें।

क्या यह [प्लेटफॉर्म] को सपोर्ट करता है?

सर्वर एक एकल Rust बाइनरी है जो कहीं भी curl इंस्टॉल के साथ चलता है। यदि आपका प्लेटफॉर्म Linux बाइनरी (Docker, VM, आदि) चला सकता है, तो यह काम करता है। E2B, Daytona और Vercel Sandboxes के लिए तैनाती गाइड देखें।

क्या मैं इसे अपनी व्यक्तिगत API कुंजियों के साथ उपयोग कर सकता हूं?

हां। अपने स्थानीय एजेंट कॉन्फ़िग (Claude Code, Codex, OpenCode, Amp, Pi) से API कुंजियाँ निकालने और उन्हें सैंडबॉक्स वातावरण में पास करने के लिए sandbox-agent credentials extract-env का उपयोग करें।

Rust क्यों और [भाषा] क्यों नहीं?

Rust हमें एक एकल स्टैटिक बाइनरी, तेज़ स्टार्टअप और अनुमानित मेमोरी उपयोग देता है। यह Node.js जैसे बड़े रनटाइम को शिप किए बिना सैंडबॉक्स या CI के अंदर चलाना आसान बनाता है।

मैं कोडिंग एजेंटों को स्थानीय रूप से क्यों नहीं चला सकता?

आप विकास के लिए चला सकते हैं। लेकिन उत्पादन में, आपको अलगाव की आवश्यकता है। कोडिंग एजेंट मनमाना कोड निष्पादित करते हैं — यह आपके सर्वर पर नहीं हो सकता। सैंडबॉक्स अलगाव प्रदान करते हैं; यह SDK कोडिंग एजेंटों को दूरस्थ रूप से नियंत्रित करने के लिए HTTP API प्रदान करता है।

यह एजेंट के आधिकारिक SDK से कैसे अलग है?

आधिकारिक SDK स्थानीय निष्पादन मानते हैं। वे प्रक्रियाएँ बनाते हैं और इंटरैक्टिव टर्मिनलों की अपेक्षा करते हैं। यह SDK एक सैंडबॉक्स के अंदर एक सर्वर चलाता है जिससे आप HTTP के माध्यम से कनेक्ट होते हैं — शुरू से दूरस्थ नियंत्रण के लिए डिज़ाइन किया गया।

सैंडबॉक्स में केवल SSH क्यों नहीं?

कोडिंग एजेंट उचित TTY हैंडलिंग वाले इंटरैक्टिव टर्मिनलों की अपेक्षा करते हैं। पाइप किए गए कमांड के साथ SSH टूल पुष्टिकरण, स्ट्रीमिंग आउटपुट और मानव-इन-द-लूप प्रवाह को तोड़ देता है। SDK एक साफ HTTP API पर यह सब संभालता है।

दायरे से बाहर

डिस्क पर सत्रों का भंडारण: सत्र पहले से ही संबंधित कोडिंग एजेंटों द्वारा डिस्क पर संग्रहीत किए जाते हैं। यह माना जाता है कि उपभोक्ता इस मशीन से डेटा को बाहरी स्टोरेज, जैसे Postgres, ClickHouse या Rivet में स्ट्रीम कर रहा है।
प्रत्यक्ष LLM रैपर: यदि आप अपना स्वयं का एजेंट शुरू से लागू करना चाहते हैं तो Vercel AI SDK का उपयोग करें।
Git रेपो प्रबंधन: बस git कमांड का उपयोग करें या अपने सैंडबॉक्स प्रदाता द्वारा प्रदान की गई सुविधाओं का उपयोग करें।
सैंडबॉक्स प्रदाता API: सैंडबॉक्स प्रदाताओं के API में कई सूक्ष्म अंतर हैं, हमारे लिए एक कस्टम परत प्रदान करने का प्रयास करना समझ में नहीं आता। इसके बजाय, हम गाइड प्रदान करते हैं जो आपको इस रिपॉजिटरी को सैंडबॉक्स प्रदाताओं के साथ एकीकृत करने देते हैं।

रोडमैप

Python SDK
स्वचालित MCP और skill और हुक कॉन्फ़िगरेशन
कार्य सूची

सर्वर	Rust डेमॉन (`sandbox-agent server`) जो HTTP + SSE API को उजागर करता है
SDK	एम्बेडेड और सर्वर मोड के साथ TypeScript क्लाइंट
इंस्पेक्टर	सत्रों और ईवेंटों के निरीक्षण के लिए अंतर्निहित UI
CLI	`sandbox-agent` (वही बाइनरी, साथ ही npm रैपर) HTTP एंडपॉइंट को मिरर करता है

sandbox-agent

सबसे लोकप्रिय