Codebox Ai

🚀 CodeBox-AI

A secure Python code execution service where each session runs in an independent Docker container for environment isolation.

🚀 Quick Start

CodeBox-AI is a secure Python code execution service. Each session runs in an independent Docker container, leveraging Docker for environment isolation.

✨ Features

• Each session runs independently within a Docker container.
• Supports specifying dependencies (e.g., numpy, pandas, etc.).
• Provides a REST API interface.
• Allows file mounting into the container.
• Enables setting a timeout for code execution.
• Uses a JSON-based request/response format.

📦 Installation

1. Installation Requirements

• Docker Engine installed
• Python 3.8+

pip install -r requirements.txt

2. Start the Service

uvicorn main:app --reload

💻 Usage Examples

Basic Usage

Create a Session

Send a POST request to /sessions and specify the required dependencies:

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

The response will contain a new session_id.

Execute Code

Execute Python code within the created session:

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"
  }'

Query Execution Status

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

Get Execution Results

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

🔒 Security Considerations

• Each session runs in an independent Docker container.
• Code undergoes basic security verification.
• Network access is optional and enabled by default.
• Supports setting an execution timeout.

🔗 Related Projects

• Claude: An AI tool assisting in development.
• Python Docker Isolation: Used for isolating the code execution environment.
• OpenAI API: The GPT - 4o model is used in integration examples.

📄 License

This project is under the MIT License. See the LICENSE file for details.

⚠️ Important Note

This is a prototype implementation. It is not recommended for use in a production environment without additional security measures.