Codex CLI

The codex template ships OpenAI's Codex CLI preinstalled.

Setup

pip install ovrin
export OVRIN_API_KEY="ovrin_..."

Run the agent

import ovrin

client = ovrin.Client()  # reads OVRIN_API_KEY

sandbox = client.sandboxes.create(
    template="codex",
    env={"OPENAI_API_KEY": "sk-..."},
    timeout=1800,
)

result = sandbox.run('codex exec "write a bubble sort in Python and run it"')
print(result.stdout)

sandbox.kill()

Work on a repository

sandbox.files.write("/workspace/app.py", open("app.py").read())

result = sandbox.run(
    'cd /workspace && codex exec "add tests for app.py"',
    timeout=600,
)
print(sandbox.files.read("/workspace/app.py"))

Auth

Variable	Purpose
OPENAI_API_KEY	OpenAI API key
OPENAI_BASE_URL	Point at a compatible endpoint or proxy
OPENAI_MODEL	Override the default model

Any OpenAI-compatible endpoint works through OPENAI_BASE_URL — useful for gateways and self-hosted models.

Related

• Agent environments — every template and its auth
• Claude Code — the same shape with Anthropic's CLI