Python SDK openai-codex-cli-bin missing manylinux aarch64 wheel

Resolved 💬 2 comments Opened Jun 4, 2026 by kirthiprakash Closed Aug 4, 2026
💡 Likely answer: A maintainer (etraut-openai, contributor) responded on this thread — see the highlighted reply below.

What issue are you seeing?

I cannot install or use the official Python SDK package openai-codex on my Linux ARM64 machine.
openai-codex depends on openai-codex-cli-bin, but the published runtime package does not appear to provide a compatible manylinux aarch64 wheel. The package has a musllinux aarch64 wheel, but my system is detected by uv as manylinux_2_41_aarch64, so installation fails.

This blocks using the Python SDK to talk to the local Codex app server from this machine, even though the Codex CLI itself is already installed and works locally

What steps can reproduce the bug?

On a Raspberry Pi / Linux ARM64 machine using glibc, from a Python project:

  1. Create or use a Python environment with Python 3.11+.
  2. Try to install the Python SDK:

```
uv pip install openai-codex

or add openai-codex to pyproject.toml and run:
uv sync


3. The install fails while resolving/installing `openai-codex-cli-bin`.

  Observed error:

Distribution `openai-codex-cli-bin==0.132.0 @ registry+https://pypi.org/simple` can't be installed because it doesn't have a source distribution or wheel for the current platform.

  Hint from uv:

  You're on Linux (`manylinux_2_41_aarch64`), but `openai-codex-cli-bin` only has wheels for:
  - musllinux_1_1_aarch64
  - musllinux_1_1_x86_64
  - macosx_10_9_x86_64
  - macosx_11_0_arm64
  - win_amd64
  - win_arm64

  The local Codex CLI is installed and works:

  codex --version
  codex-cli 0.137.0


### What is the expected behavior?

I expected `openai-codex` to install successfully on Linux ARM64 systems using glibc, such as Raspberry Pi OS / Debian-based ARM64 environments.

Ideally, please publish a compatible manylinux aarch64 wheel for `openai-codex-cli-bin`.

Alternatively, the Python SDK could support using an already installed local `codex` binary or an already running local Codex app server, instead of requiring the bundled `openai-codex-cli-bin` runtime wheel in all cases.

### Additional information

 Python SDK: https://github.com/openai/codex/tree/main/sdk/python
 Runtime package: https://github.com/openai/codex/tree/main/sdk/python-runtime

View original on GitHub ↗

2 Comments

kirthiprakash · 2 months ago

Update: openai-codex==0.1.0b3 installs successfully on the Raspberry Pi / Debian ARM64 system because it depends on openai-codex-cli-bin==0.137.0a4, which includes a manylinux aarch64 wheel.

The older stable resolver path still selected openai-codex-cli-bin==0.132.0, which did not have that wheel. So this may already be fixed in beta/pre-release packages.

For now, the workaround is to run uv sync with --prerelease allow flag

etraut-openai contributor · 24 days ago

Current Python SDK runtime has a published manylinux aarch64 wheel.