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

# 可以在這裡編寫高級用法的代碼示例