lordcronos/openai-proxy repository overview

🧩 OpenAI API Proxy

Um proxy leve e local que permite que qualquer ferramenta compatível com a API da OpenAI (como o IntelliJ AI Assistant, Cursor, VS Code, entre outros) se conecte à API oficial da OpenAI, mesmo quando não é permitido informar diretamente uma chave de API.

Ele adiciona automaticamente sua chave (OPENAI_API_KEY) aos cabeçalhos das requisições e as encaminha para https://api.openai.com⁠. Ideal para cenários em que o cliente (IDE, app, ou script) precisa se comunicar com um endpoint local.

🚀 Como funciona

Você roda o container localmente (localhost:8080);

O proxy intercepta chamadas para /v1/...;

Ele adiciona o cabeçalho Authorization: Bearer $OPENAI_API_KEY;

E encaminha a requisição para https://api.openai.com/v1/⁠...;

Tudo de forma transparente.

🐳 Como usar

1. Defina sua chave da OpenAI

Crie um arquivo .env na mesma pasta com:

OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

1. Suba o container

Usando Docker direto:

docker run -d
--name openai-proxy
-p 8080:8080
-e OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
lordcronos/openai-proxy:latest

Ou com docker-compose.yml:

version: '3' services: openai-proxy: image: lordcronos/openai-proxy:latest container_name: openai-proxy environment: - OPENAI_API_KEY=${OPENAI_API_KEY} ports: - "8080:8080"

E execute:

docker compose up -d

🧠 Como testar curl http://localhost:8080/v1/models⁠

Saída esperada:

{ "object": "list", "data": [ { "id": "gpt-4o-mini", "object": "model", ... } ] }

⚙️ Configuração do IntelliJ (ou outra IDE)

Vá em Settings → AI Assistant → Custom Model Server

Aponte para http://localhost:8080⁠

Use gpt-4o (ou outro modelo compatível)

Salve — pronto! 🎉

🔐 Segurança

A chave não é salva na imagem, apenas passada via variável de ambiente.

O proxy escuta apenas localmente (porta 8080).

É possível adicionar autenticação básica via NGINX, se desejar (consulte documentação no repositório).

⚡ Recursos

✅ Compatível com qualquer cliente OpenAI ✅ Suporte a streaming de respostas (proxy_buffering off) ✅ Baseado em NGINX Alpine (imagem leve) ✅ Configuração via variável de ambiente ✅ Ideal para desenvolvimento local e IDEs que não aceitam chave direta