Qu'est-ce qu'omp (Oh My Pi) ?
omp, également connu sous le nom de Oh My Pi, est un agent de codage de terminal avec des fournisseurs de modèles intégrés et personnalisés.
Ce guide omp déclare un fournisseur compatible TokenHub OpenAI dans models.yml. La clé API est résolue à partir d'une variable d'environnement, et le contexte du modèle et les valeurs de sortie doivent correspondre au modèle sélectionné. Le fichier models.yml contrôle le transport du fournisseur, les informations d'identification basées sur l'environnement, l'ID du modèle, la fenêtre contextuelle et la sortie maximale. L'indentation YAML ou les limites copiées peuvent empêcher le chargement ou produire des requêtes non valides, alors inspectez le fournisseur avec des modèles omp et testez une petite tâche en lecture seule avant de l'utiliser sur un travail actif.
omp combine son catalogue groupé, ~/.omp/agent/models.yml, sa découverte d'exécution et ses modèles enregistrés par extension dans un seul registre. TokenHub est un fournisseur models.yml personnalisé et est sélectionné comme tokenhub/<model-id>.
Étape 1 : définir un identifiant que omp peut résoudre
export TOKENHUB_API_KEY="sk-..."apiKey est résolu soit sous la forme d'un nom de variable d'environnement, soit sous la forme d'une valeur littérale. Si TOKENHUB_API_KEY existe, omp utilise sa valeur ; sinon, il envoie ce texte comme clé. Confirmez que la variable existe après l'avoir configurée.
Étape 2 : modifier ~/.omp/agent/models.yml
providers:
tokenhub:
baseUrl: __API_BASE_URL__/v1
api: openai-completions
apiKey: TOKENHUB_API_KEY
authHeader: true
models:
- id: YOUR_TOKENHUB_MODEL_ID
name: TokenHub / YOUR_TOKENHUB_MODEL_ID
contextWindow: 128000
maxTokens: 8192authHeader: true injecte Authorization: Bearer <key> à chaque requête. Remplacez contextWindow et maxTokens par les valeurs de ce modèle TokenHub exact.
Étape 3 : vérifier que le fournisseur est chargé et disponible
omp models
omp models find YOUR_TOKENHUB_MODEL_IDUn modèle peut entrer dans le registre de omp sans devenir sélectionnable. La règle officielle de disponibilité est que son fournisseur ne figure pas dans la liste effective disabledProviders et qu'il est soit sans clé, soit doté d'informations d'identification résolubles. Une clé valide ne peut pas restaurer le fournisseur tant que tokenhub reste désactivé.
Résoudre les conflits d'informations d'identification dans l'ordre de priorité de omp
Pour plusieurs informations d'identification sur un fournisseur, omp vérifie le moteur d'exécution --api-key, le models.yml apiKey, une clé API du magasin d'authentification local, OAuth, la variable d'environnement du fournisseur et enfin la solution de secours du fournisseur personnalisé. L’épinglage de la clé de TokenHub dans models.yml est prioritaire sur OAuth obsolète, ce qui est approprié pour une base URL personnalisée.
Pour un premier test, choisissez tokenhub/YOUR_TOKENHUB_MODEL_ID, exécutez une tâche en lecture seule et inspectez les journaux TokenHub. Si le fournisseur est absent, inspectez YAML et disabledProviders. S'il est présent mais non sélectionnable, inspectez la résolution de la clé. Pour un 401, vérifiez la variable et authHeader ; pour un 400, vérifiez les capacités et les limites des jetons.
Référence officielle
Choisir un modèle
FAQ du fournisseur omp (Oh My Pi)
Que doit contenir apiKey dans models.yml ?
Utilisez TOKENHUB_API_KEY. Lorsque cette variable d'environnement existe, omp résout sa valeur en tant que clé du fournisseur.
Pourquoi mon fournisseur personnalisé n'est-il pas disponible ?
Vérifiez la syntaxe models.yml, assurez-vous que le fournisseur n'est pas dans DisabledProviders et confirmez que la variable de clé API est disponible pour omp.
Puis-je copier les valeurs de contexte d'un autre modèle ?
Non. Déclarez le contextWindow et les maxTokens réels pour le modèle TokenHub que vous avez sélectionné.
omp et Oh My Pi sont-ils le même outil ici ?
Oui. Cette page couvre l'agent de codage de terminal Oh My Pi et sa configuration de fournisseur ~/.omp/agent/models.yml.
Comment puis-je vérifier qu'omp utilise TokenHub ?
Exécutez les modèles omp, sélectionnez tokenhub/<model-id>, exécutez une tâche en lecture seule et confirmez le modèle exact dans les journaux TokenHub.
Références
Cette configuration s’appuie sur TokenHub et la documentation officielle ; dernière vérification : 2026-09-08。