Agentbox - कोडिंग एजेंट सैंडबॉक्स

एजेंटों को सैंडबॉक्स करने का कोई सही तरीका अभी तक नहीं है, लेकिन कंटेनर एक व्यावहारिक शुरुआत हैं।

Agentbox एक Docker-आधारित कोडिंग एजेंट सैंडबॉक्स है, जो मूल रूप से Batrachian Toad से प्रेरित है, और अब अधिक टूल्स के लिए सामान्यीकृत किया गया है। यह एक अलग वातावरण प्रदान करता है जो कई एजेंट सत्र चलाने के लिए webterm के साथ अच्छी तरह से काम करता है।

सुविधाएँ

डिफ़ॉल्ट कंटेनर प्रदान करता है:

• विकास वातावरण: सामान्य डेवलपमेंट टूल्स के साथ डेबियन ट्रिक्सी
• पूर्व-स्थापित कोडिंग एजेंट: Copilot CLI, Codex, Pi
• पूर्व-स्थापित CLI उपकरण: gh, Nushell, lazygit, killall
• पैकेज प्रबंधक: Homebrew और APT, साथ ही uv और Bun
• वैकल्पिक एजेंट उपकरण: make -C ~ ... के माध्यम से toad, opencode, gemini, और vibe इंस्टॉल करें
• सेवा नियंत्रण: ENABLE_DOCKER, ENABLE_SSH, और ENABLE_RDP के साथ Docker/SSH/RDP को टॉगल करें
• Docker-in-Docker: जब कंटेनर विशेषाधिकार मोड में चलते हैं तब उपलब्ध
• दूरस्थ पहुंच: SSH (ENABLE_SSH=true) और mosh समर्थन
• कार्यक्षेत्र बूटस्ट्रैप: /home/agent/workspace-skel के अंतर्गत अंतर्निहित कार्यक्षेत्र स्केलेटन और एजेंट कौशल

रोडमैप

• CPU और मेमोरी सीमाएँ (बुनियादी Docker संसाधन बाधाएँ)
• नेटवर्क अलगाव विकल्प
• अन्य सैंडबॉक्सिंग तकनीकें (gVisor, Kata Containers, आदि)

सेवा कॉन्फ़िगरेशन

Agentbox यह नियंत्रित करने के लिए पर्यावरण चर का उपयोग करता है कि कंटेनर लॉन्च के समय कौन सी सेवाएँ शुरू हों:

• ENABLE_DOCKER=true - Docker डेमॉन प्रारंभ करें (Docker-in-Docker समर्थन के लिए)
• ENABLE_SSH=true - SSH सर्वर प्रारंभ करें (पोर्ट 22)
• ENABLE_RDP=true - RDP सर्वर प्रारंभ करें (पोर्ट 3389)
• AGENTBOX_ENVIRONMENT=cli|gui - छवि-प्रदत्त पर्यावरण मार्कर (cli हेडलेस/CLI के लिए, gui डेस्कटॉप छवियों के लिए)

डिफ़ॉल्ट व्यवहार: जब तक स्पष्ट रूप से सक्षम न किया जाए, सभी सेवाएँ अक्षम रहती हैं।

उदाहरण:

# Default - all services disabled
docker run -d agentbox

# Enable only Docker daemon
docker run -d -e ENABLE_DOCKER=true agentbox

# Enable Docker and SSH for development
docker run -d -e ENABLE_DOCKER=true -e ENABLE_SSH=true -p 22:22 agentbox

# Full desktop experience with all services (GUI image)
docker run -d -e ENABLE_DOCKER=true -e ENABLE_SSH=true -e ENABLE_RDP=true -p 22:22 -p 3389:3389 agentbox:gui

त्वरित आरंभ

वैकल्पिक उपकरण स्थापनाएँ

कंटेनर के अंदर, agent उपयोगकर्ता के पास एक ~/Makefile होता है जो अतिरिक्त उपकरण स्थापित कर सकता है।

कोडिंग एजेंट/CLI जिन्हें आप make -C ~ … के माध्यम से स्थापित कर सकते हैं:

• toad — Batrachian Toad स्थापित करता है (uv tool के माध्यम से)
• opencode — OpenCode स्थापित करता है (Bun के माध्यम से)
• gemini — Gemini CLI स्थापित करता है (Homebrew के माध्यम से)
• vibe — mistral-vibe स्थापित करता है (uv tool के माध्यम से)

सुविधा लक्ष्य:

• tools — node, go, gemini, vibe स्थापित करता है
• node, go — भाषा टूलचेन स्थापित करें (कुछ एजेंटों के लिए पूर्वापेक्षाएँ)

कार्यक्षेत्र स्केलेटन

Agentbox /home/agent/workspace-skel पर एक अंतर्निहित प्रोजेक्ट स्केलेटन प्रदान करता है।

इसे अपने वर्तमान /workspace में मौजूदा फ़ाइलों को अधिलेखित किए बिना कॉपी करने के लिए:

make init-workspace

विवरण के लिए docs/workspace-skeleton.md देखें।

GUI छवि

GUI बिल्ड को :gui टैग (साथ ही <release>-gui) के रूप में प्रकाशित किया गया है और इसमें XFCE, XRDP और VS Code शामिल हैं।

Docker Compose

अनुशंसित कार्यप्रवाह:

make up
make enter-toad   # or: make enter-copilot
make down

यदि आपको सेवा ओवरराइड की आवश्यकता है, तो docker-compose.override.yml बनाएं:

services:
  toad:
    environment:
      ENABLE_DOCKER: "true"
      ENABLE_SSH: "true"
  copilot:
    environment:
      ENABLE_DOCKER: "true"
      ENABLE_SSH: "true"

फिर चलाएं:

docker compose up -d

Docker का सीधे उपयोग करना

# Build the headless image
docker build -t agentbox .

# Build the GUI image
docker build -t agentbox:gui --target gui .

# Run the container with selected services (GUI image)
docker run -d \
  --name agentbox \
  --privileged \
  -e ENABLE_DOCKER=true \
  -e ENABLE_SSH=true \
  -e ENABLE_RDP=true \
  -p 22:22 \
  -p 3389:3389 \
  -v $(pwd):/workspace \
  agentbox:gui

Batrachian Toad का उपयोग करना

एक बार कंटेनर से कनेक्ट होने पर:

1. Toad स्थापित करें (यदि आवश्यक हो):

make -C ~ toad

2. Toad प्रारंभ करें:

toad

3. या किसी विशिष्ट प्रोजेक्ट निर्देशिका के साथ प्रारंभ करें:

toad /workspace

4. या सीधे किसी एजेंट के साथ लॉन्च करें:

toad -a open-hands

सुरक्षा नोट्स

• सेवा नियंत्रण: डिफ़ॉल्ट रूप से, सभी सेवाएँ (Docker, SSH, RDP) अक्षम हैं। पर्यावरण चर का उपयोग करके केवल उन्हीं को स्पष्ट रूप से सक्षम करें जिनकी आपको आवश्यकता है।
• डिफ़ॉल्ट पासवर्ड कमज़ोर हैं - उत्पादन उपयोग के लिए उन्हें बदलें
• आपके एजेंटों के लिए Docker-in-Docker उपलब्ध होने के लिए कंटेनर को विशेषाधिकार मोड में चलाने की आवश्यकता है (यह कुछ न होने से बेहतर है)
• पासवर्ड प्रमाणीकरण के बजाय SSH कुंजियों का उपयोग करने पर विचार करें
• उत्पादन उपयोग के लिए, अनावश्यक सेवाओं को अक्षम करने और डिफ़ॉल्ट क्रेडेंशियल बदलने पर विचार करें

श्रेय

यह प्रोजेक्ट मोटे तौर पर मेरे प्राचीन rcarmo/docker-templates/desktop-chrome पर आधारित है, जिसमें एक अद्यतन उपयोगकर्ता स्थान है।

लाइसेंस

MIT