codex-python-sdk — a tiny Python wrapper to use Codex without subprocess glue

Codex Codex CLI
, , , ,
1

Hi folks — I just open-sourced codex-python-sdk, a tiny Python SDK that makes it easy to call Codex from Python with an ergonomic client API.

Why I built this
I use Codex a lot in automation and quick prototypes, and I kept running into the same pain points when using the CLI from Python:

  • subprocess + stdout parsing gets messy quickly (errors, retries, structured outputs, tracing)

  • I wanted a clean “Python-native” interface that’s easy to embed in scripts / CLIs / notebooks

So this project focuses on a minimal surface area: create a client, send a prompt, get back the result text + a session_id you can use for tracing/debugging.

Quickstart

from codex_python_sdk import create_client

with create_client() as client:
    result = client.responses_create(prompt="Reply with exactly: READY")
    print(result.session_id)
    print(result.text)

Source code: https://github.com/spdcoding/codex-python-sdk

Feedback I’d love

  • API ergonomics: naming, method shape, return object design

  • What you’d expect next: async support, streaming/events, config patterns, better error types, examples

  • Any compatibility edge cases you’ve hit with Codex CLI / local setups

If you try it and something feels off, please tell me — I’m iterating fast.

2

This looks very useful, especially for developers who want a simpler and cleaner way to integrate Codex into Python workflows. Avoiding subprocess handling makes automation more reliable and easier to maintain. Having structured outputs and better error handling will also help when building larger tools or integrating Codex into production systems.

1 Like