Quickstart

O ForgeRouter é um gateway self-hosted que expõe uma única API compatível com o formato OpenAI (/v1/chat/completions, /v1/models) na frente de vários provedores de LLM — você troca de provedor, adiciona fallback e ganha visibilidade sem mudar uma linha do seu código cliente.

Em 3 passos

1. Clone o repositório e copie o arquivo de exemplo de configuração:

   git clone https://github.com/darckware/forgerouter.git
   cd forgerouter
   cp config/providers.example.yaml config/providers.yaml

2. Preencha as chaves de API dos provedores que você já usa em config/providers.yaml (veja Configuração de provedores para o formato completo).

3. Suba o serviço:

   docker compose up -d

O ForgeRouter sobe escutando em http://localhost:2100 por padrão (configurável via FORGEROUTER_PORT). Teste com:

curl http://localhost:2100/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sua-chave-local" \
  -d '{"model": "auto", "messages": [{"role": "user", "content": "oi"}]}'

O campo model: "auto" deixa o ForgeRouter escolher o melhor provedor disponível no momento, com base em saúde e nas regras que você configurar.

Próximos passos

• Instalação — detalhes de deploy em produção, non-root, variáveis de ambiente.
• Configuração de provedores — todos os provedores suportados e como priorizar entre eles.