Tableau de bord

Vue d'ensemble de la gateway.

Actions rapides

Créer une clé API

La clé complète n'est affichée qu'une seule fois. Copie-la.

Clés existantes

Usage & coûts

Agrégé depuis les logs. Coût = estimation.

Analytics — tokens & coût réel

Consommation dans le temps et coût recalculé depuis le tarif de chaque modèle.

Providers & authentification des CLI

Configure la clé de chaque CLI puis teste la connexion.

Boutique de connexions

Parcours le catalogue et connecte un service en un clic — la gateway construit le connecteur et le câble sur les CLI ciblés.

Connecteur MCP sur mesure

Branche des serveurs MCP (outils) sur les agents CLI.

Connecteurs enregistrés

Coche/décoche une cible CLI directement ici — le changement est appliqué aussitôt et le token est conservé.

Créer un serveur MCP compatible

Prompt prêt à donner à un agent AI pour générer un serveur MCP branchable ici. Adapte la liste des outils.

Notes importantes

• Le token va dans l'en-tête Authorization AVEC le préfixe « Bearer » (sinon 401). L'en-tête Accept (application/json, text/event-stream) est ajouté automatiquement (anti-406).
• La gateway traduit chaque connecteur au format NATIF du CLI ciblé — kimi (mcp.json), claude (claude mcp add), mistral/vibe (config.toml, transport « http »). Rien à adapter côté connecteur.
• Édite un connecteur (crayon) pour changer ses cibles sans re-saisir le token : le secret existant est préservé.
• Coche plusieurs CLI pour câbler le même serveur MCP sur tous en un clic.
• Détails, formats par CLI et dépannage (401 / 406 / 502 / hang) : docs/mcp-integration.md du dépôt.

Skills

Procédures réutilisables (format SKILL.md). Injectées dans le dossier de travail de l'agent : Claude, Kimi et Grok les découvrent nativement ; Vibe via son préambule. Portée par clé, comme les connecteurs MCP.

Boîtes mail IMAP (outil email des agents)

Connecte les boîtes de la société : les agents reçoivent des outils mcp__email__* en LECTURE SEULE (recherche + lecture, jamais marqué lu, aucun envoi). Mots de passe stockés chiffrés.

Portes de réveil (webhooks)

Une adresse par assistant : n'importe quel outil capable d'appeler une URL (Zapier, n8n, un webhook Shopify, un cron, un script de l'assistant lui-même) le réveille avec l'information reçue, par un simple POST — sans clé d'API. L'adresse EST le secret : elle n'est montrée qu'une fois, et se révoque en un clic.

PUBLIC_BASE_URL n'est pas réglée : la gateway ne connaît pas son adresse publique, elle rendra donc le jeton sans l'URL complète. Règle-la dans l'onglet Déploiement pour obtenir une adresse prête à coller.

Sécurité de la console admin

Protège UNIQUEMENT ce panneau d'administration (l'API reste protégée par les clés yumi-…). Recommandé si la box est exposée sur internet.

Déploiement : domaine + HTTPS

Génère la config nginx (WebSocket inclus) + les commandes TLS à copier-coller EN ROOT sur le serveur. Pour ta sécurité, la console n'exécute rien en root elle-même.

1) DNS : crée un enregistrement A « domaine → IP du serveur ». 2) Lance les commandes ci-dessous en root :

Comment ça marche

La gateway expose un endpoint compatible OpenAI et route vers un agent CLI.

Client (SDK OpenAI)
   │  Authorization: Bearer yumi-…
   ▼
Yumi AI Gateway  (/v1/chat/completions)
   ├─► claude_cli   → claude -p …
   ├─► kimi_cli     → kimi -p … (stream-json)
   └─► mistral_cli  → vibe -p … --yolo

Modèles disponibles

Le nom du modèle dans l'appel sélectionne l'agent CLI. Pour Claude, le suffixe choisit la variante — -sonnet (Sonnet 5), -opus (Opus 4.8), -haiku (Haiku 4.5), -fable (Fable 5) — le modèle exact étant défini par CLI_MODEL_MAP. Liste en direct depuis /v1/models :

Exemples d'appel

Remplace BASE et yumi-… par les tiens.

Exposer l'API (mapping de port sur la box)

Si la gateway tourne sur un nano-ordinateur (Raspberry Pi / SmartPi) derrière une box internet, il faut rediriger un port pour y accéder depuis l'extérieur.

1. Sur le nano-PC : lance la gateway en écoute sur 0.0.0.0:8001 (IP LAN, ex. 192.168.1.50).
2. Sur la box (routeur) : crée une redirection de port (NAT/Port Forwarding) port externe → 192.168.1.50:8001 (ou 443 si nginx/TLS).
3. Utilise l'IP publique de la box, ou un DNS dynamique (DuckDNS…) car l'IP résidentielle change.
4. Sécurité : n'expose jamais sans TLS + clé yumi-…. Restreins la console admin (ADMIN_IP_ALLOWLIST, pare-feu).

L'avantage de la solution

• Un seul endpoint OpenAI pour plusieurs agents CLI.
• Toute l'orchestration agentique du CLI via un simple appel chat.
• Auto-hébergé : les credentials ne quittent jamais ton serveur.
• Clés maîtresses par client : rate-limit, budget, allow-list, suivi de coût.
• Zéro lock-in : on change de provider via le routage.

Préambule système injecté (couche de sécurité)