gronod
58cf62a41f
The models option passed an allowlist to openai-oauth --models but was unrequested and of uncertain upstream effect; remove it entirely. Add translations/en.yaml so the Configuration tab explains that an empty api_key auto-generates a persisted key printed in the log, and that a custom key can be pasted instead. Document a key-generation command in DOCS.md.
OpenAI Codex Proxy
Local OpenAI-compatible API endpoint backed by your ChatGPT account's Codex OAuth login — packaged as a Home Assistant add-on.
Point any OpenAI-compatible integration (for example an OpenAI conversation integration in Home Assistant) at this add-on and it answers through your ChatGPT Plus/Pro account instead of paid API credits.
Features
- OpenAI-compatible endpoints:
/v1/responses,/v1/chat/completions,/v1/models, and/v1/images/* - Exposes the Codex models your ChatGPT account can actually use
- Streaming responses, tool calls, and reasoning traces
- Local API key required on every request — generated automatically on first start (no open proxy on your LAN)
- Optional per-request JSON logging for troubleshooting
- OAuth tokens refresh automatically and persist in
/share/auth.json
Requirements
- A ChatGPT account (Plus or Pro recommended for Codex access)
- A Codex
auth.jsonfile, generated on a desktop machine withnpx @openai/codex loginand copied to this Home Assistant machine's/sharefolder
Installation
- Add this repository to Home Assistant
(Settings → Add-ons → Add-on Store → ⋮ → Repositories):
https://git.i3omb.com/gronod/ha-gronod-addons - Copy your
auth.jsonto/share/auth.json(Samba or SSH add-on) - Install OpenAI Codex Proxy and start it
- Copy the generated local API key from the add-on log and configure your
OpenAI-compatible integration with base URL
http://<home-assistant-host>:10531/v1
See DOCS.md for the step-by-step guide, option reference, and troubleshooting.
Credits
This add-on wraps openai-oauth by @EvanZhouDev — an unofficial, community-maintained project that exposes ChatGPT Codex OAuth sessions as an OpenAI-compatible API. Login uses OpenAI's @openai/codex CLI.
License
© 2026 Gordon Bolton. Apache License 2.0 — see LICENCE.md, matching the
licenses of the upstream components this add-on wraps:
openai-oauth (Apache-2.0) and
@openai/codex (Apache-2.0).
Use is subject to OpenAI's Terms of Use and your ChatGPT plan's rate limits.