Pular para o conteúdo
darckwaredarckware
DisponívelSelf-hostedMPL-2.0
ForgeRouter

Gateway open source para IA

Uma camada para controlar provedores, rotas e continuidade.

O ForgeRouter centraliza chamadas de IA, acompanha saúde, seleciona destinos e aplica fallback. Aplicações ganham uma interface estável e a operação mantém as decisões de roteamento sob controle.

Problema
Dependência e fragmentação entre provedores de IA
Evidências
Sistema, telas, documentação e código publicados
Uso
Avaliação autônoma ou implantação acompanhada

Python + FastAPI, PostgreSQL com fallback em YAML. Sobe via Docker Compose no seu próprio servidor — sem depender de nuvem de terceiro.

Tela real do painel Overview do ForgeRouter com indicadores operacionais.

O problema

Quando cada aplicação conhece cada provedor, mudar custa mais do que deveria.

Credenciais, formatos, modelos e políticas se espalham pelo ambiente. Uma indisponibilidade vira incidente em vários sistemas ao mesmo tempo.

Dependência

Integrações acopladas

Cada produto precisa saber detalhes do provedor e repetir tratamento de falha.

Visibilidade

Uso fragmentado

Fica difícil entender qual aplicação chamou qual modelo e por qual rota.

Continuidade

Falha sem alternativa

Quando um destino cai, o software consumidor também para ou precisa improvisar.

O que o ForgeRouter resolve

Um gateway só, na frente de todos os provedores de IA que você usa — local, por API key, ou por login OAuth/assinatura.

Múltiplos provedores, um só gateway

Ollama local e provedores por API key (Groq, OpenRouter, Mistral, NVIDIA, Cloudflare, Cohere, Gemini Studio, GitHub Models) ou por login/assinatura (Claude Code, Codex, Antigravity, DeepSeek, Z.ai) — tudo num pool só.

Saúde e fallback automático

Cada requisição tenta os candidatos em ordem — um provedor com falha, limite de taxa ou instável é pulado a favor do próximo saudável, sem quebrar o request do cliente.

Roteamento por demanda

Classifica cada requisição pelo conteúdo (simples, complexa, raciocínio, visão, áudio, código) e escolhe o modelo certo — sem gastar cota de modelo caro em pergunta simples.

3 protocolos, 1 pipeline

Compatível com OpenAI Chat Completions, Anthropic Messages (Claude Code) e OpenAI Responses (Codex CLI) — todos com streaming incremental de verdade, não resposta pronta reempacotada.

Dashboard administrativo embutido

Interface React pra gerenciar provedor, agente, roteamento e uso — servida pela própria API, sem precisar subir serviço separado.

Chave e orçamento por agente

Cada cliente conectado ganha API key própria, restrição de modelo e teto de custo de referência mensal — sem guardar o conteúdo das conversas.

Como colocar no ar

Instalador standalone, já com PostgreSQL embutido — nada pra provisionar antes:

instalação
$ git clone https://github.com/darckware/forgerouter.git
$ cd ForgeRouter
$ ./scripts/install_standalone.sh
→ dashboard em http://127.0.0.1:2100 · login inicial admin/admin

Por que é grátis

Ferramenta que resolve problema de verdade não precisa ficar trancada atrás de uma parede de vendas. O ForgeRouter é código que a própria Darckware usa no dia a dia pra rotear chamada de IA entre provedor gratuito, local e pago — abrir ele pra comunidade é forma de mostrar como a Darckware constrói, não só falar sobre isso. Licença MPL-2.0, uso livre, sem custo de licenciamento, pra rodar no seu próprio ambiente.

Documentação

Fluxo de funcionamento, instalação, verificação e telas reais.

A documentação completa mostra como o ForgeRouter roteia cada requisição, o passo a passo de instalação e captura das quatro telas administrativas.

Viu qualidade no trabalho e quer construir algo?

A Lara entende o que chamou sua atenção, identifica seu resultado esperado e organiza o contexto para uma conversa técnica.