CodeBox-AI

一个安全的Python代码执行服务，每个会话都在独立容器中运行，使用Docker隔离环境。

特性

• 每个会话独立运行在Docker容器中
• 支持指定依赖项（如numpy, pandas等）
• 提供REST API接口
• 支持文件挂载到容器
• 设置代码执行超时
• 基于JSON的请求/响应格式

安装与启动

1. 安装要求

• Docker Engine installed
• 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 实现，未经额外安全措施的情况下不建议用于生产环境。