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

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

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

विशेषताएँ

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

• विकास वातावरण: सामान्य विकास उपकरणों के साथ Debian Stable
• पूर्व-स्थापित कोडिंग एजेंट: 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