Installation locale et validation du démarrage d'OmniRoute

Cette page est destinée aux nouveaux utilisateurs de HagiCode qui souhaitent le chemin de configuration OmniRoute le plus court : démarrez le service local, vérifiez que http://localhost:20128/v1 fonctionne et confirmez que le tableau de bord et l’API sont disponibles.

Chemin recommandé

Cette première version conserve en premier le chemin le plus stable : npm install -g omniroute, omniroute, Tableau de bord sur http://localhost:20128, et l’URL de base compatible OpenAI sur http://localhost:20128/v1. Docker, VPS et les modes de déploiement plus avancés restent dans la section facultative.

Conditions préalables

• Node.js est déjà installé. Terminé Installation de Node.js d’abord si nécessaire.
• Port local 20128 est disponible et pas déjà occupé.
• Vous disposez d’au moins un compte de fournisseur de modèles en amont que vous prévoyez d’acheminer via OmniRoute.
• Avant d’intégrer HagiCode, une CLI ou un SDK, séparez ces deux adresses :
  • Tableau de bord : http://localhost:20128
  • URL de base compatible OpenAI : http://localhost:20128/v1

Installer et exécuter localement

Commencez par le chemin npm global recommandé :

npm install -g omniroute
omniroute

Une fois le service démarré, validez-le dans cet ordre :

1. Ouvert http://localhost:20128 dans un navigateur et confirmez que le tableau de bord se charge.
2. Allez au Endpoints dans le tableau de bord et créez ou copiez une clé API.
3. Notez l’URL de base que vous transmettrez aux outils plus tard : http://localhost:20128/v1.

Pourquoi commencer par le tableau de bord

Pour la première configuration, le tableau de bord constitue le moyen le plus rapide de confirmer qu’OmniRoute est en cours d’exécution, que vos fournisseurs sont connectés et qu’une clé API existe. Si un appel client ultérieur échoue, il est généralement plus rapide de vérifier d’abord le tableau de bord que de déboguer immédiatement le code du SDK.

Valider le service en cours d’exécution

Validation 1 : confirmer que le catalogue de modèles est lisible

Mettez la clé du Endpoints page dans une variable d’environnement :

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

Alors demandez /v1/models:

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

Si vous obtenez une liste de modèles, le point de terminaison et le flux d’authentification compatibles OpenAI fonctionnent.

Validation 2 : envoyer une demande de chat minimale

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." }
    ]
  }'

Le but ici n’est pas une qualité rapide. Il s’agit de prouver que le modèle que vous avez choisi peut déjà être acheminé avec succès via OmniRoute.

Prochaines étapes

Installing Node.js

AI Agent CLI Installation

OmniRoute Upstream Project