AIO Sandbox — универсальная среда для AI-агентов

🚀 Быстрый старт

Запуск за 30 секунд:

docker run --security-opt seccomp=unconfined --rm -it -p 8080:8080 ghcr.io/agent-infra/sandbox:latest

Для пользователей из материкового Китая:

docker run --security-opt seccomp=unconfined --rm -it -p 8080:8080 enterprise-public-cn-beijing.cr.volces.com/vefaas-public/all-in-one-sandbox:latest

Чтобы использовать конкретную версию, укажите её в формате agent-infra/sandbox:${version}, например версию 1.0.0.150:

docker run --security-opt seccomp=unconfined --rm -it -p 8080:8080 ghcr.io/agent-infra/sandbox:1.0.0.150
# или для пользователей из материкового Китая
docker run --security-opt seccomp=unconfined --rm -it -p 8080:8080 enterprise-public-cn-beijing.cr.volces.com/vefaas-public/all-in-one-sandbox:1.0.0.150

После запуска среда доступна по адресам:

• 📖 Документация: http://localhost:8080/v1/docs
• 🌐 VNC-браузер: http://localhost:8080/vnc/index.html?autoconnect=true
• 💻 VSCode Server: http://localhost:8080/code-server/
• 🤖 MCP-сервисы: http://localhost:8080/mcp

🎯 Что такое AIO Sandbox?

AIO Sandbox — это универсальная среда-песочница для AI-агентов, объединяющая браузер, Shell, файловые операции, MCP и VSCode Server в одном Docker-контейнере. Построена на облачной легковесной технологии изоляции и предоставляет единую защищённую среду выполнения для AI-агентов и разработчиков.

Почему AIO Sandbox?

Традиционные песочницы узкоспециализированы (браузер, код или Shell), что делает обмен файлами и координацию функций крайне сложными. AIO Sandbox решает эту проблему:

• ✅ Единая файловая система — файлы, загруженные в браузере, мгновенно доступны в Shell и файловых операциях
• ✅ Множество интерфейсов — VNC, VSCode, Jupyter и терминал в одной среде
• ✅ Безопасное выполнение — изолированное выполнение Python и Node.js с гарантиями безопасности
• ✅ Нулевая настройка — предварительно сконфигурированные MCP-серверы и инструменты разработки готовы к использованию
• ✅ Готовность к агентам — MCP-совместимые API для бесшовной интеграции AI-агентов

📦 Установка

Установка SDK

Python

TypeScript/JavaScript

Golang

Базовое использование

Пример на Python

from agent_sandbox import Sandbox

# Инициализация клиента
client = Sandbox(base_url="http://localhost:8080")
home_dir = client.sandbox.get_context().home_dir

# Выполнение shell-команд
result = client.shell.exec_command(command="ls -la")
print(result.data.output)

# Файловые операции
content = client.file.read_file(file=f"{home_dir}/.bashrc")
print(content.data.content)

# Автоматизация браузера
screenshot = client.browser.screenshot()

Пример на TypeScript

import { Sandbox } from '@agent-infra/sandbox';

// Инициализация клиента
const sandbox = new Sandbox({ baseURL: 'http://localhost:8080' });

// Выполнение shell-команд
const result = await sandbox.shell.exec({ command: 'ls -la' });
console.log(result.output);

// Файловые операции
const content = await sandbox.file.read({ path: '/home/gem/.bashrc' });
console.log(content);

// Автоматизация браузера
const screenshot = await sandbox.browser.screenshot();

🌟 Ключевые возможности

🔗 Единая среда

Все компоненты работают в одном контейнере с общей файловой системой, обеспечивая бесшовные рабочие процессы:

🌐 Автоматизация браузера

Полное управление браузером через несколько интерфейсов:

• VNC — визуальное взаимодействие с браузером через удалённый рабочий стол
• CDP — Chrome DevTools Protocol для программного управления
• MCP — высокоуровневые инструменты автоматизации браузера

💻 Инструменты разработки

Интегрированная среда разработки:

• VSCode Server — полноценная IDE в браузере
• Jupyter Notebook — интерактивная среда Python
• Терминал — доступ к терминалу через WebSocket
• Проброс портов — умный предпросмотр веб-приложений

🤖 Интеграция с MCP

Предварительно настроенные MCP-серверы готовы к использованию без дополнительной конфигурации.