Installation
Tu peux installer Bob Shell avec un script d'installation ou ton gestionnaire de paquets.
Configuration requise
Systèmes d'exploitation
macOS, Linux, ou Windows
Mémoire
Minimum 4 Go de RAM (8 Go recommandé)
Stockage
Minimum 500 Mo d'espace disque disponible
Réseau
Connexion internet active
Node.js
Version 24 ou ultérieure
Installation
Bob Shell 2.0.0 nécessite une nouvelle installation. Actuellement, il n'existe pas de chemin de mise à niveau automatique depuis 1.0.x. Tes paramètres et configurations existants seront conservés pendant l'installation.
Choisis d'installer Bob Shell avec un script d'installation ou ton gestionnaire de paquets.
Utiliser les scripts d'installation
Sélectionne ton système d'exploitation, puis copie et exécute la commande pour installer Bob Shell.
curl -fsSL https://bob.ibm.com/download/bobshell.sh | bashcurl -fsSL https://bob.ibm.com/download/bobshell.sh | bashpowershell -c "irm -Uri https://bob.ibm.com/download/bobshell.ps1 | iex"Installer depuis le package téléchargé
Si tu as téléchargé manuellement le package Bob Shell depuis la page Releases, tu peux l'installer en utilisant l'un des gestionnaires de paquets suivants :
Tu dois modifier les commandes suivantes pour utiliser le chemin réel où tu as téléchargé le fichier.
Tu dois exécuter les commandes Windows suivantes avec PowerShell.
Authentification
Bob Shell utilise le même point d'entrée de connexion que tous les autres clients Bob : bob.ibm.com/login. La première fois que tu exécutes Bob Shell, ou après l'expiration de ta session, Bob ouvre ton navigateur sur cette page.
Pour une vue d'ensemble complète du fonctionnement de la connexion, incluant IBMid, SSO et la gestion des sessions, consulte Connexion.
Choisis parmi 2 méthodes d'authentification, selon ton cas d'usage.
| Méthode | Cas d'usage | Prérequis |
|---|---|---|
| SSO / IBMid | Sessions interactives | IBMid valide ou compte SSO d'entreprise, accès au navigateur |
| Clé API | Automatisation, pipelines CI/CD, environnements non interactifs | Clé API du portail web Bob, variable d'environnement |
Authentification SSO / IBMid (par défaut)
Quand Bob Shell doit s'authentifier, il ouvre bob.ibm.com/login dans ton navigateur. Saisis ton adresse e-mail IBMid et clique sur Continue pour être automatiquement redirigé vers le bon fournisseur d'identité.
- Si ton organisation a configuré SSO, tu es redirigé vers la page de connexion de ton entreprise.
- Sinon, tu es redirigé vers IBMid.
Après avoir complété l'authentification dans ton navigateur, retourne dans Bob Shell. Ta session est établie automatiquement.
Authentification par clé API
L'authentification par clé API est idéale pour l'automatisation, les pipelines CI/CD et les environnements non interactifs où l'authentification basée sur un navigateur n'est pas disponible.
Crée une clé API avec Scope défini sur Inference dans le portail web Bob. Pour des instructions détaillées, consulte Clés API.
Après avoir généré la clé, télécharge-la ou copie la valeur de la clé. Stocke-la de façon sécurisée car tu ne pourras plus la consulter.
Ne partage jamais ta clé API avec qui que ce soit.
Définis la variable d'environnement BOB_API_KEY avec ta valeur de clé API :
export BOB_API_KEY="your-api-key-here"Pour rendre cela permanent, ajoute-le à ton profil shell (~/.bashrc, ~/.zshrc, etc.) :
echo 'export BOB_API_KEY="your-api-key-here"' >> ~/.bashrc$env:BOB_API_KEY="your-api-key-here"Pour rendre cela permanent, utilise :
[System.Environment]::SetEnvironmentVariable('BOB_API_KEY', 'your-api-key-here', 'User')Exécute Bob Shell avec ta clé API définie :
bob run "your prompt"Ou démarre une session interactive :
bob chatSi ta clé API est de type general (plutôt qu'Inference), tu dois aussi passer --team-id <team-id> lors de l'exécution de Bob Shell.
Si tu rencontres des problèmes réseau lors de l'installation ou de l'authentification, tu pourrais avoir besoin de configurer tes paramètres proxy. Pour plus d'informations, consulte Configurer les paramètres proxy ou la section Dépannage.