sandbox-agent

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

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

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

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

Sandbox Agent क्यों?

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

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

1. कोडिंग एजेंटों को सैंडबॉक्स की आवश्यकता होती है — आप AI को अपने प्रोडक्शन सर्वर पर मनमाना कोड निष्पादित नहीं करने दे सकते। कोडिंग एजेंटों को पृथक वातावरण की आवश्यकता होती है, लेकिन मौजूदा SDK स्थानीय निष्पादन मानते हैं। Sandbox Agent एक सर्वर है जो सैंडबॉक्स के अंदर चलता है और HTTP/SSE को उजागर करता है।

2. हर कोडिंग एजेंट अलग है — Claude Code, Codex, OpenCode, Cursor, Amp और Pi में प्रत्येक के मालिकाना API, ईवेंट प्रारूप और व्यवहार हैं। एजेंटों को स्वैप करने का मतलब है आपके एकीकरण को फिर से लिखना। Sandbox Agent एक HTTP API प्रदान करता है — अपना कोड एक बार लिखें, कॉन्फ़िगर बदलकर एजेंट स्वैप करें।

3. सत्र क्षणभंगुर होते हैं — एजेंट ट्रांसक्रिप्ट सैंडबॉक्स में रहते हैं। जब प्रक्रिया समाप्त होती है, तो आप सब कुछ खो देते हैं। 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 सर्वर के रूप में चलता है

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

घटक

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

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

OpenAPI विनिर्देश

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

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