Skip to content

Latest commit

 

History

151 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Animated Relmio mascot carrying a private n8n connection through its doorway

Relmio

Use ChatGPT sign-in with n8n. Keep every credential where it belongs.

npm version npm monthly downloads GitHub stars CI status Apache 2.0 license

Relmio helps self-hosted n8n use models available through your own ChatGPT/Codex sign-in. It installs an unofficial openai-oauth sidecar on the same private Docker network as n8n. The bridge has no host port.

Need the supported OpenAI API instead? Relmio can set up a separate local /v1 endpoint backed by your OpenAI Platform API key.

ChatGPT sign-in is not an OpenAI Platform API key. Relmio keeps those paths separate.

Quick install

On macOS, Linux, WSL, or Git Bash:

npx --yes --ignore-scripts relmio@latest

The command opens a private browser wizard on 127.0.0.1. Pick an option, review exactly what it will create, then confirm the install.

Open the hosted install guide

Pick a path

I already run n8n

Choose Existing n8n model bridge.

  1. Sign in with your own ChatGPT/Codex account.
  2. Select the running n8n container and its private Docker network.
  3. Review and install the sidecar.
  4. In n8n, use http://n8n-openai-oauth:10531/v1 with the placeholder API key local-only.

Relmio does not edit, restart, rebuild, or expose n8n. The bridge is unofficial, private, experimental, and policy-uncertain. Check the rules that apply to your account before using it.

Read the existing n8n guide

I do not have n8n yet

Choose New local n8n + ngrok. Relmio creates a separate n8n stack and walks you through the ngrok domain, token, and Basic Auth fields. Only the new n8n route is public. Its model bridge, Code Sandbox, and optional SearXNG stay off the host network.

Read the new n8n guide

I need the supported OpenAI API

Choose OpenAI API and enter your own Platform API key. Platform usage is billed separately from ChatGPT. Relmio stores the key in its private local service and gives your app a different local credential.

Read the local endpoint guide

n8n AI Assistant tools

Choose n8n AI Assistant tools in the local browser wizard to add Code Sandbox beside an existing n8n container. SearXNG web search is optional and off by default. Relmio shows the sandbox key and n8n settings once. It does not change or restart n8n.

The Assistant model provider still needs its own supported credential. Enter your Platform API key directly in n8n. The privileged local runner is for development and testing; n8n recommends Daytona for production.

Read the AI Assistant guide

Codex device sign-in

The Codex App Server and Codex Chat Adapter options use the official Codex device-code sign-in. The ChatGPT credential stays inside the isolated Codex container. These experimental routes are for trusted local apps and development backends, not browsers or public servers.

Sign-in lifetime

ChatGPT/Codex sign-in tokens expire. The official Codex client refreshes them automatically during active use before they expire, so active sessions usually continue without another browser login. Official OpenAI documentation does not publish a fixed 10-day lifetime; do not plan around one. This provider credential is separate from Relmio's local capability, which remains valid until you rotate it.

Common problems

  • Docker is not running. Start Docker Desktop or Docker Engine, then open a fresh wizard session.
  • Authentication fails. Close old sign-in tabs and use the newest local URL printed by the active Relmio terminal.
  • Local image build failed. Check Docker, disk space, and registry access.

Open troubleshooting

Guides

Support

Relmio is free to use. If it helped you, you can buy me a coffee.

Support Relmio on Ko-fi

Legal

Relmio is an unofficial, community-maintained project. It is not affiliated with, endorsed by, or sponsored by OpenAI.

Treat ChatGPT/Codex credentials like passwords. Use only your own account. Do not pool, share, forward, or sell access tokens. Any request made with those credentials must be authorized by the account owner.

You are responsible for following OpenAI's Terms of Use, Usage Policies, and any other agreement that applies to your account.

Warning

Do not bypass rate limits, restrictions, or safeguards.

Relmio is provided as-is without warranties. OpenAI or an upstream service may change or discontinue access at any time. You accept the risks of using this experimental community project.

About

A safe local browser wizard for installing an OpenAI OAuth sidecar beside self-hosted n8n.

Topics

Resources

Contributing

Security policy

Stars

42 stars

Watchers

3 watching

Forks

Releases

Packages

Contributors

Languages