Code Interpreter API

The Code Interpreter API allows you to execute code in a sandboxed environment, supporting various languages like Python, JavaScript, and Bash.

Basic Execution

You can execute a script by providing the code and the language.

cURL Example

curl -X POST https://api.cognitora.dev/api/v1/code-interpreter/execute \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <api-key>" \
  -d '{
    "language": "python",
    "code": "print(\\"Hello from the Code Interpreter!\\")"
  }'

Python SDK Example

from cognitora import Cognitora

client = Cognitora(api_key="your_api_key")

result = client.code_interpreter.execute(
    code="print('Hello from the Code Interpreter!')",
    language="python"
)

print(f"Status: {result.data.status}")
for output in result.data.outputs:
    print(f"{output.type}: {output.data}")

JavaScript/TypeScript SDK Example

import { Cognitora } from '@cognitora/sdk';

const client = new Cognitora({ apiKey: 'your_api_key' });

const result = await client.codeInterpreter.execute({
  code: "console.log('Hello from the Code Interpreter!')",
  language: 'javascript'
});

console.log(`Status: ${result.data.status}`);
result.data.outputs.forEach(output => {
  console.log(`${output.type}: ${output.data}`);
});

Session Management

For stateful executions where variables and context should be maintained across multiple calls, you can use sessions.

Creating a Session

# Python SDK Example
session = client.code_interpreter.create_session(language="python")
session_id = session.data.session_id

Executing Code in a Session

# Python SDK Example
client.code_interpreter.execute(
    code="x = 10",
    session_id=session_id
)

result = client.code_interpreter.execute(
    code="print(x)",
    session_id=session_id
)

# The output will be "10"
print(result.data.outputs[0].data)