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