Saltar al contenido
darckwaredarckware
DisponibleAutoalojadoMPL-2.0
ForgeRouter

Gateway de código abierto para IA

Una capa para controlar proveedores, rutas y continuidad.

ForgeRouter centraliza llamadas de IA, monitorea el estado de salud, selecciona destinos y aplica fallback automático. Las aplicaciones obtienen una interfaz estable y la operación mantiene las decisiones bajo control.

Problema
Dependencia y fragmentación entre proveedores de IA
Evidencias
Sistema, pantallas, documentación y código publicados
Uso
Evaluación autónoma o despliegue asistido

Python + FastAPI, PostgreSQL con fallback en YAML. Se ejecuta mediante Docker Compose en su propio servidor — sin depender de nubes de terceros.

Captura de pantalla real del panel Overview de ForgeRouter con métricas operativas.

El problema

Cuando cada aplicación se conecta directamente a cada proveedor, cambiar cuesta más de lo debido.

Credenciales, formatos, modelos y políticas se dispersan por el entorno. Una caída de proveedor se convierte en incidente en varios sistemas a la vez.

Dependencia

Integraciones acopladas

Cada producto debe conocer detalles del proveedor y duplicar el manejo de errores.

Visibilidad

Consumo fragmentado

Resulta difícil saber qué aplicación consumió qué modelo y a través de qué ruta.

Continuidad

Falla sin alternativa

Cuando un destino cae, el software consumidor se detiene o requiere improvisaciones.

Lo que resuelve ForgeRouter

Un único gateway delante de todos los proveedores de IA que utiliza — local, por clave de API o suscripción.

Múltiples proveedores, un solo gateway

Ollama local y proveedores por API key (Groq, OpenRouter, Mistral, NVIDIA, Cloudflare, Cohere, Gemini Studio, GitHub Models) o por suscripción (Claude Code, Codex, Antigravity, DeepSeek, Z.ai) — todo en un solo pool.

Salud y fallback automático

Cada petición evalúa candidatos en orden — un proveedor con falla o saturado es omitido en favor del siguiente disponible sin romper la petición.

Enrutamiento por demanda

Clasifica cada petición según su contenido (simple, compleja, razonamiento, visión, audio, código) para seleccionar el modelo adecuado sin desperdiciar cuotas.

3 protocolos, 1 pipeline

Soporte para OpenAI Chat Completions, Anthropic Messages (Claude Code) y OpenAI Responses (Codex CLI) — con streaming incremental real en todo el flujo.

Panel administrativo integrado

Interfaz React integrada para administrar proveedores, agentes, rutas y consumo — servida directamente por la API sin servicios adicionales.

Clave y presupuesto por agente

Cada cliente conectado recibe clave de API propia, restricción de modelos y límite mensual de costo — sin almacenar contenido de conversaciones.

Cómo poner en producción

Instalador independiente con PostgreSQL integrado — sin necesidad de aprovisionamiento previo:

instalación
$ git clone https://github.com/darckware/forgerouter.git
$ cd ForgeRouter
$ ./scripts/install_standalone.sh
→ panel en http://127.0.0.1:2100 · acceso inicial admin/admin

Por qué es gratis

Las herramientas que resuelven problemas reales no necesitan estar ocultas tras un muro de ventas. ForgeRouter es el código que la propia Darckware utiliza a diario para enrutar llamadas de IA entre proveedores gratuitos, locales y comerciales. Compartirlo con la comunidad es nuestra manera de demostrar cómo construimos software con rigor técnico. Licencia MPL-2.0, libre de uso y sin costos, para ejecutarlo en su propia infraestructura.

Documentación

Flujo de funcionamiento, instalación, verificación y pantallas reales.

La documentación completa muestra el funcionamiento del enrutamiento, la guía paso a paso de instalación y las capturas de las cuatro pantallas administrativas.

¿Vio calidad en nuestro trabajo y busca construir algo?

Lara comprende lo que llamó su atención, identifica su resultado esperado y organiza el contexto para una conversación técnica.