GoModel: Um Gateway de IA Leve e de Código Aberto Escrito em Go

GoModel é um gateway de IA de código aberto escrito em Go que fica entre sua aplicação e provedores de modelos como OpenAI, Anthropic, Gemini e outros. Ele fornece uma interface de API unificada compatível com OpenAI enquanto lida internamente com as diferenças específicas de cada provedor.

Principais Características e Diferenças

O projeto foi criado para resolver vários problemas práticos: rastrear o uso de IA e custos por cliente ou equipe, alternar modelos sem alterar o código da aplicação, depurar fluxos de solicitação mais facilmente e reduzir gastos com IA usando cache exato e semântico.

Diferenciadores principais em relação às alternativas:

• Imagem Docker de ~17MB (a imagem da LiteLLM tem ~746MB em amd64, tornando o GoModel 44x mais leve)
• Fluxo de trabalho de solicitações é visível e fácil de inspecionar
• Configuração prioriza variáveis de ambiente por padrão

Início Rápido

Implantação básica com Docker:

docker run --rm -p 8080:8080 \
  -e OPENAI_API_KEY="your-openai-key" \
  enterpilot/gomodel

Para produção, evite passar segredos pela linha de comando e use:

docker run --env-file .env enterpilot/gomodel

Faça sua primeira chamada de API:

curl http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{ "model": "gpt-5-chat-latest", "messages": [{"role": "user", "content": "Olá!"}] }'

Provedores Suportados

GoModel suporta múltiplos provedores de LLM com detecção automática baseada nas credenciais fornecidas:

• OpenAI (OPENAI_API_KEY)
• Anthropic (ANTHROPIC_API_KEY)
• Google Gemini (GEMINI_API_KEY)
• Groq (GROQ_API_KEY)
• OpenRouter (OPENROUTER_API_KEY)
• Z.ai (ZAI_API_KEY)
• xAI/Grok (XAI_API_KEY)
• Azure OpenAI (AZURE_API_KEY + AZURE_BASE_URL)
• Oracle (ORACLE_API_KEY + ORACLE_BASE_URL)
• Ollama (OLLAMA_BASE_URL)

O gateway suporta conclusões de chat, embeddings, processamento de arquivos, operações em lote e capacidades de passagem na maioria dos provedores. Para Oracle, você pode precisar definir ORACLE_MODELS=openai.gpt-oss-120b,xai.grok-3 quando o endpoint upstream /models não estiver disponível.

Métodos Alternativos de Configuração

Você também pode executar a partir do código-fonte (Go 1.26.2+ necessário) ou usar Docker Compose para componentes de infraestrutura incluindo Redis, PostgreSQL, MongoDB e Adminer.

Este tipo de gateway é particularmente útil para equipes que gerenciam múltiplos modelos de IA em diferentes provedores, precisam de rastreamento de custos ou desejam manter flexibilidade para alternar provedores sem alterações de código. A imagem Docker leve o torna adequado para ambientes com recursos limitados.