ipybox

🚀 ipybox

ipybox 是一个轻量级且安全的 Python 代码执行沙箱，它基于 IPython 和 Docker 构建。你可以在本地计算机上运行它，也可以在你选择的远程环境中运行。ipybox 专为需要安全执行代码的 AI 智能体而设计，例如用于数据分析用例，或者像在 freeact 智能体中执行代码操作。

🚀 快速开始

安装 ipybox Python 包

pip install ipybox

在 ipybox 容器中执行代码

import asyncio
from ipybox import ExecutionClient, ExecutionContainer

async def main():
    async with ExecutionContainer(tag="ghcr.io/gradion-ai/ipybox") as container:
        async with ExecutionClient(port=container.executor_port) as client:
            result = await client.execute("print('Hello, world!')")
            print(f"Output: {result.text}")

if __name__ == "__main__":
    asyncio.run(main())

✨ 主要特性

• 在 Docker 容器内安全地执行代码
• 通过可配置的防火墙 限制网络访问
• 使用 IPython 内核进行有状态的代码执行
• 实时流式输出代码执行结果
• 在构建时或运行时安装 Python 包
• 返回使用可视化库生成的绘图
• 提供 MCP 服务器 接口，便于与 AI 智能体集成
• 通过生成的客户端代码 调用 MCP 服务器
• 支持灵活的部署选项，包括本地或远程部署
• 提供 asyncio API 来管理执行环境

📚 详细文档

• 用户指南
• API 文档

📦 MCP 服务器

ipybox 可以作为 MCP 服务器 进行安装。

{
  "mcpServers": {
    "ipybox": {
      "command": "uvx",
      "args": ["ipybox", "mcp"]
    }
  }
}

💻 使用示例

基础用法

import asyncio
from ipybox import ExecutionClient, ExecutionContainer

async def main():
    async with ExecutionContainer(tag="ghcr.io/gradion-ai/ipybox") as container:
        async with ExecutionClient(port=container.executor_port) as client:
            result = await client.execute("print('Hello, world!')")
            print(f"Output: {result.text}")

if __name__ == "__main__":
    asyncio.run(main())

高级用法

# 这里可以添加高级场景的说明，由于原文档未提供，暂不补充
import asyncio
from ipybox import ExecutionClient, ExecutionContainer

# 可以在这里编写高级用法的代码示例