Documentação básica · versão inicial
Entenda, instale e avalie o ForgeRouter.
Esta primeira documentação apresenta o fluxo central, a instalação standalone e as telas de gestão. Referência completa de API, troubleshooting, atualização e operação avançada serão documentados na próxima etapa.
Visão geral
Um gateway self-hosted entre suas aplicações e os modelos de IA.
O ForgeRouter recebe chamadas por uma interface compatível, consulta o registro de provedores, considera capacidade e saúde e tenta os destinos na ordem definida. Aplicações deixam de carregar detalhes de cada fornecedor e ganham uma camada central de controle.
O ForgeRouter é um produto open source para a comunidade, mantido pela própria Darckware em produção. O código pode ser avaliado livremente, sem contrato; personalização, instalação, integração e manutenção são caminhos opcionais para quem quiser incorporá-lo à própria operação.
Como funciona
Da requisição ao melhor destino disponível.
Entrada compatível
A aplicação usa OpenAI Chat Completions, Anthropic Messages ou OpenAI Responses.
Registro e demanda
O gateway carrega provedores e modelos, identifica a capacidade e classifica a demanda quando o modo automático é usado.
Saúde e prioridade
Somente candidatos habilitados e aptos entram na rota, ordenados por cadeia, prioridade e sinais operacionais.
Fallback e registro
Se um destino falhar antes do início da resposta, o próximo é tentado e o evento permanece rastreável.
Quickstart
Instalação standalone com Docker.
O instalador oficial cria o arquivo de ambiente quando necessário, gera credenciais do banco, inicia o PostgreSQL, aplica o esquema, constrói a imagem e sobe o ForgeRouter. O processo foi projetado para poder ser executado novamente com segurança.
Verificação
O dashboard fica em http://127.0.0.1:2100/. No primeiro acesso, a conta inicial exige a troca da credencial padrão. Para ambiente produtivo, rede, TLS, segredos, backup e observabilidade precisam ser tratados conforme o contexto da organização.
A instalação rápida é suficiente para avaliação. A Darckware pode desenhar rede e segurança, configurar provedores, integrar aplicações, preparar backup, monitoramento e rotina de atualização.
Telas do sistema
Gestão visual do ambiente ForgeRouter.
As capturas abaixo foram feitas no sistema real para preparar o manual. Dados operacionais identificáveis foram ocultados.
Adoção profissional
O produto é aberto. A implantação pode ser acompanhada.
Ajuste ao seu cenário
Integrações, políticas, perfis, fluxos e extensões alinhados às aplicações existentes.
Ambiente pronto para operar
Rede, containers, banco, segredos, provedores, agentes, segurança e validação.
Continuidade e evolução
Monitoramento, backup, atualização, incidentes, novos provedores e melhoria das rotas.
Prefere contratar a implantação em vez de instalar sozinho?
A Lara qualifica aplicações, provedores, restrições e criticidade e encaminha para a equipe fechar o serviço.