Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tensorlake.ai/llms.txt

Use this file to discover all available pages before exploring further.

View Source Code

Check out the full source code for this example on GitHub.
This tutorial demonstrates how to build a Code Interpreter Agent that can safely execute Python code generated by an LLM. By leveraging Tensorlake’s isolated sandboxing, you can run arbitrary code without compromising your local environment or production servers.

​
Overview

The Code Interpreter Agent follows this workflow:
  1. User Request: The user asks a question that requires code execution (e.g., “Calculate the Fibonacci sequence up to 100”).
  2. Code Generation: An OpenAI agent interprets the request and generates the necessary Python code.
  3. Secure Execution: The code is sent to a Tensorlake function running in a secure, isolated container.
  4. Result Retrieval: The execution output (stdout, stderr) is captured and returned to the agent.
  5. Final Answer: The agent formulates a final response based on the code output.

​
Prerequisites

  • Python 3.11+
  • Tensorlake Account and CLI installed.
  • OpenAI API Key

​
Implementation (app.py)

Here is the complete implementation for the Code Interpreter Agent. 
import sys
import io
import contextlib
from typing import Optional

from openai import OpenAI
from pydantic import BaseModel, Field
from tensorlake import application, function, Image

# Define the execution environment
# We install pandas and numpy to support data analysis tasks
image = Image(name="code-interpreter").run("pip install openai pandas numpy")

class ExecutionResult(BaseModel):
    stdout: str
    stderr: str
    result: Optional[str] = None

@application()
@function(image=image, secrets=["OPENAI_API_KEY"])
def code_interpreter(prompt: str) -> str:
    """
    Main entry point for the Code Interpreter Agent.
    """
    client = OpenAI()
    
    # Step 1: Generate code based on user prompt
    completion = client.chat.completions.create(
        model="gpt-4o",
        messages=[
            {"role": "system", "content": "You are a Python code generator. Output only valid Python code to solve the user's problem. Do not include markdown blocks."},
            {"role": "user", "content": prompt}
        ]
    )
    code = completion.choices[0].message.content
    
    # Step 2: Execute the generated code securely
    print(f"Executing generated code:
{code}")
    execution_result = execute_python_code(code)
    
    # Step 3: formulate final answer
    final_response = client.chat.completions.create(
        model="gpt-4o",
        messages=[
            {"role": "system", "content": "Answer the user's question based on the code execution result."},
            {"role": "user", "content": f"Question: {prompt}
Code Output:
{execution_result.stdout}
Errors:
{execution_result.stderr}"}
        ]
    )
    
    return final_response.choices[0].message.content

@function(image=image)
def execute_python_code(code: str) -> ExecutionResult:
    """
    Executes Python code in a secure sandbox and captures output.
    """
    stdout = io.StringIO()
    stderr = io.StringIO()
    
    try:
        # Redirect stdout and stderr to capture print statements
        with contextlib.redirect_stdout(stdout), contextlib.redirect_stderr(stderr):
            exec(code, {"__name__": "__main__"})
    except Exception as e:
        print(f"Execution error: {e}", file=stderr)
        
    return ExecutionResult(
        stdout=stdout.getvalue(),
        stderr=stderr.getvalue()
    )

​
Running Locally

To test the interpreter locally, add this code block to the end of app.py: 
if __name__ == "__main__":
    from tensorlake.applications import run_local_application
    
    # Run the application locally
    result = run_local_application(code_interpreter, "Calculate the sum of the first 50 prime numbers.")
    print(f"Code Interpreter Output:\n{result}")
Then run the script: 
export OPENAI_API_KEY=your_key_here
python app.py

​
Deploying to Tensorlake

Deploy your secure code interpreter to the cloud with a single command: 
tl secrets set OPENAI_API_KEY=your_key_here
tl deploy app.py
This deployment creates a dedicated, isolated environment for every execution request, ensuring complete safety and scalability for your code interpretation tasks.