Make Python SDK examples copy-pasteable for installed SDK before 1.0

Open 💬 0 comments Opened Jun 5, 2026 by maksimzayats

What variant of Codex are you using?

SDK

What feature would you like to see?

Right now the examples shows checkout-only import bootstrapping, including local sys.path mutation, _bootstrap imports, and runtime_config() helpers. That makes the examples runnable from the repository, but it also makes them look unlike normal application code someone would paste into a project after installing openai-codex.

I feel like the examples should show how to use the public installed SDK surface:

  • from openai_codex import ...
  • from openai_codex.types import ...
  • Codex() / AsyncCodex()
  • no per-example checkout bootstrap helpers

I put together a focused fork PR as a concrete prototype:
https://github.com/maksimzayats/codex/pull/1

Would the Codex team be open to inviting a focused upstream PR in this direction if the approach matches your intended Python SDK direction?

Best,
Maksim

Additional information

_No response_

View original on GitHub ↗