Codebox Ai

🚀 CodeBox-AI

CodeBox-AI 是一個安全的 Python 代碼執行服務，它將每個會話置於獨立的 Docker 容器中運行，利用 Docker 的隔離特性確保環境安全，為代碼執行提供穩定可靠的環境。

🚀 快速開始

CodeBox-AI 是一個安全的 Python 代碼執行服務，藉助 Docker 容器實現會話隔離。下面為你介紹其安裝與使用步驟。

✨ 主要特性

• 每個會話獨立運行在 Docker 容器中，確保環境隔離與安全。
• 支持指定依賴項（如 numpy, pandas 等），滿足多樣化的代碼運行需求。
• 提供 REST API 接口，方便與其他系統集成。
• 支持文件掛載到容器，便於數據交互。
• 可設置代碼執行超時，避免長時間佔用資源。
• 基於 JSON 的請求/響應格式，數據傳輸規範統一。

📦 安裝指南

1. 安裝要求

• 已安裝 Docker Engine
• Python 版本 3.8 及以上

pip install -r requirements.txt

2. 啟動服務

uvicorn main:app --reload

💻 使用示例

基礎用法

創建會話

發送 POST 請求到 /sessions，指定需要的依賴項：

{
    "dependencies": ["numpy", "pandas"]
}

響應將包含一個新的 session_id。

執行代碼

在創建的會話中執行 Python 代碼：

curl -X POST http://localhost:8000/execute \
  -H "Content-Type: application/json" \
  -d '{
    "code": "import numpy as np\nprint(np.version.version)",
    "session_id": "YOUR_SESSION_ID"
  }'

查詢執行狀態

curl http://localhost:8000/execute/YOUR_REQUEST_ID/status

獲取執行結果

curl http://localhost:8000/execute/YOUR_REQUEST_ID/results

📚 詳細文檔

安全注意事項

• 每個會話都在獨立的 Docker 容器中運行，保障代碼執行的安全性。
• 代碼經過基礎安全驗證，降低潛在風險。
• 網絡訪問可選，默認開啟，可根據需求靈活配置。
• 支持設置執行超時，避免資源過度佔用。

相關項目

• Claude：協助開發的 AI 工具。
• Python Docker 隔離：用於代碼執行環境隔離。
• OpenAI API：集成示例中使用了 GPT - 4o 模型。

📄 許可證

本項目採用 MIT License，具體詳情見 LICENSE 文件。

⚠️ 重要提示

這是一個 prototype 實現，未經額外安全措施的情況下不建議用於生產環境。