Instalación local de OmniRoute y validación de inicio

Esta página es para usuarios nuevos de HagiCode que desean la ruta de configuración de OmniRoute más corta: inicie el servicio local, verifique que http://localhost:20128/v1 funciona y confirme que tanto el Panel como la API estén disponibles.

Ruta recomendada

Esta primera versión mantiene primero la ruta más estable: npm install -g omniroute, omniroute, Panel de control en http://localhost:20128y la URL base compatible con OpenAI en http://localhost:20128/v1. Docker, VPS y los modos de implementación más avanzados permanecen en la sección opcional.

Requisitos previos

• Node.js ya está instalado. completo Instalación de Node.js primero si es necesario.
• Puerto local 20128 está disponible y aún no está ocupado.
• Tiene al menos una cuenta de proveedor de modelo ascendente que planea enrutar a través de OmniRoute.
• Antes de integrar HagiCode, una CLI o un SDK, mantenga estas dos direcciones separadas:
  • Panel de control: http://localhost:20128
  • URL base compatible con OpenAI: http://localhost:20128/v1

Instalar y ejecutar localmente

Comience con la ruta npm global recomendada:

npm install -g omniroute
omniroute

Una vez iniciado el servicio, valídelo en este orden:

1. Abierto http://localhost:20128 en un navegador y confirme que se carga el Panel.
2. Ir al Endpoints página en el Panel y cree o copie una clave API.
3. Anota la URL base que entregarás a las herramientas más adelante: http://localhost:20128/v1.

Por qué empezar con el Panel

Para la primera configuración, el Panel es la forma más rápida de confirmar que OmniRoute se está ejecutando, que sus proveedores están conectados y que existe una clave API. Si falla una llamada de cliente posterior, comprobar primero el Panel de control suele ser más rápido que depurar el código SDK inmediatamente.

Validar el servicio en ejecución

Validación 1: confirmar que el catálogo de modelos es legible

Pon la llave del Endpoints página en una variable de entorno:

export OMNIROUTE_API_KEY="replace-with-the-key-you-copied-from-the-Endpoints-page"

Entonces solicita /v1/models:

curl http://localhost:20128/v1/models \
  -H "Authorization: Bearer ${OMNIROUTE_API_KEY}"

Si recupera una lista de modelos, el punto final compatible con OpenAI y el flujo de autenticación están funcionando.

Validación 2: enviar una solicitud de chat mínima

curl http://localhost:20128/v1/chat/completions \
  -H "Authorization: Bearer ${OMNIROUTE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "replace-with-a-model-id-from-v1-models",
    "messages": [
      { "role": "user", "content": "Reply with ok." }
    ]
  }'

El objetivo aquí no es la calidad inmediata. Es para demostrar que el modelo elegido ya se puede enrutar exitosamente a través de OmniRoute.

Próximos pasos

Installing Node.js

AI Agent CLI Installation

OmniRoute Upstream Project