Instalar
Puedes instalar Bob Shell con un script de instalación o tu gestor de paquetes.
Requisitos del sistema
Sistemas operativos
macOS, Linux o Windows
Memoria
Mínimo 4 GB de RAM (8 GB recomendado)
Almacenamiento
Mínimo 500 MB de espacio en disco disponible
Red
Conexión a internet activa
Node.js
Versión 24 o posterior
Instalación
Bob Shell 2.0.0 requiere una instalación nueva. Actualmente no hay una ruta de actualización automática desde 1.0.x. Tu configuración y ajustes existentes se conservarán durante la instalación.
Elige instalar Bob Shell con un script de instalación o tu gestor de paquetes.
Usar scripts de instalación
Selecciona tu sistema operativo, luego copia y ejecuta el comando para instalar 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"Instalar desde el paquete descargado
Si has descargado manualmente el paquete de Bob Shell desde la página de Releases, puedes instalarlo usando uno de los siguientes gestores de paquetes:
Debes modificar los siguientes comandos para usar la ruta real donde descargaste el archivo.
Debes ejecutar los siguientes comandos de Windows con PowerShell.
Autenticación
Bob Shell usa el mismo punto de entrada de inicio de sesión que todos los demás clientes de Bob: bob.ibm.com/login. Cuando ejecutas Bob Shell por primera vez, o después de que expire tu sesión, Bob abre tu navegador en esta página.
Para una descripción completa de cómo funciona el inicio de sesión, incluyendo IBMid, SSO y la gestión de sesiones, consulta Iniciar sesión.
Elige entre 2 métodos de autenticación, según tu caso de uso.
| Método | Caso de uso | Requisitos |
|---|---|---|
| SSO / IBMid | Sesiones interactivas | IBMid válido o cuenta SSO corporativa, acceso al navegador |
| API key | Automatización, pipelines de CI/CD, entornos no interactivos | API key del portal web de Bob, variable de entorno |
Autenticación SSO / IBMid (predeterminada)
Cuando Bob Shell necesita autenticarse, abre bob.ibm.com/login en tu navegador. Ingresa tu dirección de correo electrónico de IBMid y haz clic en Continue para ser dirigido automáticamente al proveedor de identidad correcto.
- Si tu organización ha configurado SSO, eres redirigido a la página de inicio de sesión de tu empresa.
- De lo contrario, eres redirigido a IBMid.
Después de completar la autenticación en tu navegador, regresa a Bob Shell. Tu sesión se establece automáticamente.
Autenticación con API key
La autenticación con API key es ideal para automatización, pipelines de CI/CD y entornos no interactivos donde la autenticación basada en navegador no está disponible.
Crea una API key con Scope establecido en Inference en el portal web de Bob. Para instrucciones detalladas, consulta API keys.
Después de generar la clave, descárgala o copia el valor de la clave. Guárdala de forma segura ya que no podrás verla de nuevo.
Nunca compartas tu API key con nadie.
Establece la variable de entorno BOB_API_KEY con el valor de tu API key:
export BOB_API_KEY="your-api-key-here"Para hacerlo permanente, agrégalo a tu perfil de shell (~/.bashrc, ~/.zshrc, etc.):
echo 'export BOB_API_KEY="your-api-key-here"' >> ~/.bashrc$env:BOB_API_KEY="your-api-key-here"Para hacerlo permanente, usa:
[System.Environment]::SetEnvironmentVariable('BOB_API_KEY', 'your-api-key-here', 'User')Ejecuta Bob Shell con tu API key configurada:
bob run "your prompt"O inicia una sesión interactiva:
bob chatSi tu API key es de tipo general (en lugar de Inference), también debes pasar --team-id <team-id> al ejecutar Bob Shell.
Si experimentas problemas de red durante la instalación o autenticación, es posible que necesites configurar tus ajustes de proxy. Para más información, consulta Configurar ajustes de proxy o la sección de resolución de problemas.