{"slug": "boxagnts-is-an-out-of-the-box-secure-ai-agent-toolbox-in-a-wasm-sandbox", "title": "BoxAgnts is an Out-Of-The-Box Secure AI Agent ToolBox in a WASM SandBox", "summary": "BoxAgnts is an open-source AI Agent ToolBox built with Rust that provides a secure runtime environment using WebAssembly sandbox technology. It offers an out-of-the-box experience by allowing users to download, extract, and run the service with simple command-line options, supporting multiple workspaces and customizable ports. The project features a Rust backend with Tokio async runtime and a Vue 3 + TypeScript frontend, enabling users to add AI models and API keys through a web dashboard.", "body_md": "BoxAgnts is an open-source AI Agent ToolBox built with Rust, dedicated to delivering an ultimate out-of-the-box experience. Leveraging WebAssembly sandbox, it provides a runtime environment that balances security and flexibility, helping users effortlessly tackle a wide range of complex tasks and thus becoming an efficient and trustworthy personal AI assistant.\n\n## Core Architecture\n\n### 🎯 AI Agent Tool**Box**\n\nBoxAgnts is a fully-featured AI Agent toolkit providing:\n\n-\n**Multi-model support**: Compatible with major AI model providers including OpenAI, Anthropic, CodeX, Google, Deepseek, MiniMax, OpenCode -\n**Tool system**: Built-in file operations, web access, code execution, and many other tools -\n**Skill system**: Create specialized AI skills through simple configuration\n\n### 🛡️ WebAssembly Sand**Box**\n\nBuild a secure runtime environment using WebAssembly technology:\n\n-\n**Isolated execution**: All custom tools and skills run in a WASM sandbox -\n**Security control**: Fine-grained permission management and network access control -\n**Cross-platform**: Compile once, run everywhere -\n**High performance**: Based on Wasmtime runtime, near-native performance\n\n### ✨ Out of the **Box**\n\nOut-of-the-box experience:\n\n-\n**Zero-configuration startup**: Download and run, no complex configuration -\n**Web interface**: Built-in beautiful Dashboard for visual management of all features -\n**Built-in extensions**: Pre-configured with commonly used tools and skills, ready to use -\n**Quick start**: Simple API and intuitive workflow\n\n## Key Features\n\n### 🤖 AI Chat and Agents\n\n- Chat with multiple AI models\n- Create and manage custom Agents\n- Save and manage chat history\n- Support for streaming responses\n\n### 🔧 Tool Execution\n\n- File read/write and editing\n- Shell command execution\n- Web content scraping\n- Code review and analysis\n\n### 📦 Skill System\n\n- Quickly create specialized skills\n- Skill combination and reuse\n- Built-in skills including code review, weather query, front-end component generation, etc.\n\n### ⏰ Automatic Tasks Cron\n\n- Create and manage scheduled tasks\n- Support for standard Cron expressions\n- Task execution logs and status tracking\n- Flexible task configuration and triggering methods\n\n### 🌐 Web Service\n\n- Custom website deployment\n- Static file serving\n- API endpoint management\n\n## Quick Start\n\n### Download Executable\n\nDownload the latest compressed package from the [Releases](https://github.com/guyoung/boxagnts/releases) page, extract and run.\n\n### Start Service\n\n```\n# Start service\nboxagnts\n\n# Specify workspace directory\nboxagnts --workspace-dir /path/to/workspace\n\n# Specify port\nboxagnts --workspace-dir /path/to/workspace --port 30002\n```\n\nSuggestion: BoxAgnts supports multiple workspaces, each with its own configuration file and data directory. It is recommended not to run in the default directory, but to specify a workspace directory or workspace-dir.\n\nCommand line arguments:\n\n```\nBoxAgnts is an open-source AI Agent ToolBox built with Rust.\n\nUsage: boxagnts [OPTIONS]\n\nOptions:\n      --port <PORT>          Port to run the web server on [default: 30001]\n      --host <HOST>          Host to bind to (0.0.0.0 for all interfaces) [default: 127.0.0.1]\n      --workspace-dir <DIR>  Set workspace dir, default current dir\n      --app-dir <DIR>        Set app dir, default Boxagnts executable file dir\n      --admin-user <USERNAME>  Set admin username\n      --admin-pass <PASSWORD>  Set admin password\n  -h, --help                 Print help\n  -V, --version              Print version\n```\n\n### Access Dashboard\n\nOpen your browser and visit `http://127.0.0.1:30001`\n\n### Configure Model\n\nAdd AI models and API Keys in the settings page\n\n## Project Structure and Source Code Compilation\n\nThis project is developed based on [claurst](https://github.com/Kuberwastaken/claurst) project code\n\n### Directory Structure\n\n```\nboxagnts/\n├── boxagnts/                 # Rust backend core code\n│   ├── api/                 # AI model API (multi-provider support)\n│   ├── core/                # Core types, constants, and basic functions\n│   ├── gateway/             # API gateway (includes Cron task scheduling)\n│   ├── mcp/                 # MCP protocol implementation (optional)\n│   ├── server/              # Web server and Dashboard interface\n│   ├── tools/               # Tool system and built-in tools\n│   ├── tools-manager/       # Tool manager\n│   ├── query/               # Query orchestration\n│   ├── wasm-sandbox/        # WebAssembly sandbox runtime\n│   ├── wasm-tools/          # WASM tool wrappers\n│   └── workspace/           # Workspace and configuration management\n├── boxagnts-dashboard-web/  # Vue 3 frontend source code\n│   ├── src/\n│   │   ├── api/            # API interface wrappers\n│   │   ├── components/     # Vue components\n│   │   ├── composables/    # Composables\n│   │   ├── stores/         # Pinia state management\n│   │   ├── views/          # Page components\n│   │   └── router/         # Router configuration\n│   └── package.json        # Frontend dependencies\n├── app/                     # Application resources\n│   ├── dashboard-web/      # Compiled web interface static assets\n│   └── extensions/         # Extensions (tools/skills)\n└── Cargo.toml              # Rust workspace configuration\n```\n\n### Backend Code Analysis\n\nThe backend is developed in Rust using Tokio async runtime. The main modules are:\n\n-\n**api/**: Wraps APIs from multiple AI providers including OpenAI, Anthropic, Google, Azure, Bedrock, providing unified interface calling and message format conversion -\n**core/**: Defines core data types, constants, error handling, and system prompts -\n**gateway/**: API gateway layer, handles HTTP requests, includes Cron task scheduling system (cron/ subdirectory), supporting scheduled task creation, management, and execution -\n**server/**: Web server, providing Dashboard REST API and WebSocket support -\n**tools/**: Tool system, implements execution framework for built-in tools and skills -\n**wasm-sandbox/**: WebAssembly sandbox based on Wasmtime, implementing secure code execution environment -\n**workspace/**: Workspace management, handles configuration, authentication, and history storage\n\n### Frontend Code Analysis\n\nThe frontend uses Vue 3 + TypeScript + Vuetify technology stack:\n\n- Uses\n**Pinia** for state management (stores/ directory) - Uses\n**Vue Router** for routing management (router/ directory) - Main pages: Chat, Agents, Cron tasks, Files, Skills, Tools, Sites, Settings, etc.\n- Supports Markdown rendering, code editor (CodeMirror), charts (Chart.js), etc.\n- Communicates with backend via REST API and WebSocket\n\n### Source Code Compilation Method\n\n#### Environment Requirements\n\n- Rust 1.75+ (Install:\n[https://www.rust-lang.org/tools/install](https://www.rust-lang.org/tools/install)) - Node.js 18+ (Install:\n[https://nodejs.org/](https://nodejs.org/)) - npm or pnpm\n\n#### Compile Backend\n\n```\n# Enter project root directory\ncd boxagnts-pub\n\n# Compile Debug version\ncargo build\n\n# Compile Release version (optimize for size and performance)\ncargo build --release\n\n# Compiled executable is located at target/release/boxagnts\n```\n\n#### Compile Frontend\n\n```\n# Enter frontend directory\ncd boxagnts-dashboard-web\n\n# Install dependencies\nnpm install\n\n# Start development mode (hot reload)\nnpm run dev\n\n# Compile production version\nnpm run build\n\n# Compiled static files will be output to app/dashboard-web/\n```\n\n#### Complete Build Process\n\n```\n# 1. Compile frontend\ncd boxagnts-dashboard-web\nnpm install\nnpm run build\n\n# 2. Compile backend\ncd ..\ncargo build --release\n\n# 3. Run\n./target/release/boxagnts\n```\n\n## License\n\n**Repository**: [https://github.com/guyoung/boxagnts](https://github.com/guyoung/boxagnts)", "url": "https://wpnews.pro/news/boxagnts-is-an-out-of-the-box-secure-ai-agent-toolbox-in-a-wasm-sandbox", "canonical_source": "https://dev.to/guyoung/boxagnts-is-an-out-of-the-box-secure-ai-agent-toolbox-in-a-wasm-sandbox-1hif", "published_at": "2026-05-23 03:49:57+00:00", "updated_at": "2026-05-23 04:33:51.831133+00:00", "lang": "en", "topics": ["artificial-intelligence", "open-source", "developer-tools", "products"], "entities": ["BoxAgnts", "Rust", "WebAssembly"], "alternates": {"html": "https://wpnews.pro/news/boxagnts-is-an-out-of-the-box-secure-ai-agent-toolbox-in-a-wasm-sandbox", "markdown": "https://wpnews.pro/news/boxagnts-is-an-out-of-the-box-secure-ai-agent-toolbox-in-a-wasm-sandbox.md", "text": "https://wpnews.pro/news/boxagnts-is-an-out-of-the-box-secure-ai-agent-toolbox-in-a-wasm-sandbox.txt", "jsonld": "https://wpnews.pro/news/boxagnts-is-an-out-of-the-box-secure-ai-agent-toolbox-in-a-wasm-sandbox.jsonld"}}