This repository provides a reference Docker image for the OpenAI Codex environment, enabling developers to customize and debug their setups locally. It aims to replicate the core components of the Codex development environment, facilitating a smoother workflow for users of OpenAI's coding tools.

How It Works

The image utilizes environment variables (e.g., CODEX_ENV_PYTHON_VERSION, CODEX_ENV_NODE_VERSION) to dynamically configure and install specified language runtimes and associated tools like pyenv, poetry, corepack, and yarn. This approach allows for flexible customization of the development environment, mirroring the capabilities of the actual Codex platform.

Quick Start & Requirements

• Primary install / run command: docker pull ghcr.io/openai/codex-universal:latest
• Usage: docker run --rm -it -e CODEX_ENV_PYTHON_VERSION=3.12 ... ghcr.io/openai/codex-universal:latest
• Prerequisites: Docker.
• Supported language versions are detailed in the README.

Highlighted Details

• Supports configurable versions for Python, Node.js, Rust, Go, and Swift.
• Includes additional tools like pyenv, poetry, uv, ruff, black, mypy, pyright, isort for Python; corepack, yarn, pnpm, npm for Node.js.
• Also includes Ruby 3.2.3, Bun 1.2.10, Java 21, and Bazelisk/Bazel.

Maintenance & Community

No specific community links or maintenance details are provided in the README.

Licensing & Compatibility

The repository does not explicitly state a license in the provided README.

Limitations & Caveats

This image is a reference implementation and not an identical environment to OpenAI Codex. Specific version support for languages is limited to those listed in the documentation.