Instalar UiPath CLI

Requisitos y pasos de instalación para UiPath CLI en Windows, macOS y Linux, incluidos los requisitos previos de Node.js y la instalación global de npm.

UiPath CLI se distribuye en npm como @uipath/cli e instala el comando uip globalmente. Se ejecuta en cualquier plataforma compatible con Node.js 22 o posterior: Windows, macOS y Linux, tanto en x64 como en ARM64.

Requisitos previos

• Node.js 22 o posterior. Node.js se envía con npm, que es suficiente para instalar y ejecutar uip.
• Cualquier plataforma: Windows (x64, ARM64), macOS (x64, ARM64), Linux (x64, ARM64).

Comprueba tu versión de nodo:

node --version

Si Node.js es anterior a 22 o no está instalado, descárgalo de nodejs.org o utiliza un gestor de versiones como nvm (macOS/Linux) o nvm-windows , o deja que el instalador de una línea a continuación aprovisione Node por ti .

Instalar

Instalación rápida (una línea)

La forma más rápida de obtener un uip que funcione. Garantiza Node.js, instala la CLI, ejecuta uip skills install (detectando automáticamente cualquier agente de codificación (Claude Code, Cursor, Copilot, etc.) que esté presente en la máquina) e instala .NET SDK 8.0 y Python. Cada paso es idempotente, por lo que es seguro volver a ejecutar el script: omite lo que ya esté en su lugar.

# macOS / Linux
curl -fsSL https://download.uipath.com/uipath-cli/install.sh | bash

# Windows (PowerShell)
irm https://download.uipath.com/uipath-cli/install.ps1 | iex

Omita las partes que no desee. Cada opción tiene una variable de entorno coincidente, que es útil para el formulario canalizado (bash -s -- --flag no siempre funciona bien con todos los shells):

Marca de macOS/Linux	Conmutador de Windows PowerShell	Variable de entorno	Efecto
--dry-run	-DryRun	UIP_DRY_RUN	Imprime lo que se ejecutaría; no cambia nada.
--skip-runtimes	-SkipRuntimes	UIP_SKIP_RUNTIMES	Omite la instalación de .NET SDK y Python.
--skip-node	-SkipNode	UIP_SKIP_NODE	Deja Node.js intacto.
--skip-skills	-SkipSkills	UIP_SKIP_SKILLS	Omite uip skills install.
--skip-dotnet	-SkipDotnet	UIP_SKIP_DOTNET	Omite la instalación de .NET SDK.
--skip-python	-SkipPython	UIP_SKIP_PYTHON	Omite la instalación de Python.

# Preview first — prints what it would do, changes nothing
curl -fsSL https://download.uipath.com/uipath-cli/install.sh | bash -s -- --dry-run

# CLI + skills only, no .NET / Python
curl -fsSL https://download.uipath.com/uipath-cli/install.sh | bash -s -- --skip-runtimes

Instalación manual

Si ya gestionas Node tú mismo, o solo quieres la CLI sin el aprovisionamiento de habilidades de una sola línea/.NET/Python:

npm install -g @uipath/cli

O con otro gestor de paquetes:

pnpm add -g @uipath/cli

bun add -g @uipath/cli

Nota:

Los tres gestores de paquetes instalan el mismo paquete @uipath/cli desde el registro público de npm. Utilice el que ya tenga su equipo. Si tu .npmrc asigna el ámbito del espacio de nombres del paquete @uipath a una fuente privada (Paquetes de GitHub, un proxy de Artifactory, …), ese ámbito gana al registro predeterminado y obtendrás la compilación de esa fuente en lugar de la pública estable. Fuerce el registro público para esta instalación con:

npm install -g @uipath/cli --@uipath:registry=https://registry.npmjs.org/

Homebrew (macOS/Linux)

UiPath mantiene un toque de Homebrew. Esta es una ruta de instalación totalmente independiente de la anterior y npm/pnpm/bun: Homebrew gestiona el binario uip y su propia dependencia de Node.js.

brew install uipath/tap/uip

O tócalo explícitamente primero:

brew tap uipath/tap
brew install uip

La actualización y la desinstalación siguen las convenciones normales de Homebrew:

brew upgrade uip
brew uninstall uip

Nota:

Las herramientas instaladas a través de uip tools install <tool> se escriben en el prefijo global de npm (npm root -g), no en el sótano de Homebrew: persisten en brew upgrade uip. Para eliminar todo por completo: brew uninstall uip && rm -rf "$(npm root -g)/@uipath".

La instalación coloca el ejecutable uip en tu PATH. En Windows, el lanzador uip.cmd / uip.ps1 se encuentra en %APPDATA%\npm\; en macOS y Linux, el lanzador uip (una pequeña corrección alrededor de node ./dist/index.js) vive bajo el prefijo informado por npm config get prefix (comúnmente /usr/local/bin o ~/.npm-global/bin).

Verifica la instalación

uip --version

Deberías ver el número de versión instalada (por ejemplo, 1.0.0).

uip --help

Debería ver una lista de comandos básicos: login (con los subcomandos status, tenant list, tenant set ), logout, tools, skills, mcp, completion : seguidos por las herramientas que se han instalado o registrado en tu máquina.

Para confirmar dónde se encuentran el lanzador uip y sus herramientas:

npm root -g              # directory holding @uipath/cli and installed tools
npm config get prefix    # parent directory whose bin/ folder holds the uip launcher

Primer comando

UiPath CLI se envía solo con el host y un pequeño conjunto de comandos básicos. No hay herramientas preinstaladas. La primera vez que invocas un comando cuyo prefijo coincide con una herramienta en la lista blanca de instalación automática, el host descarga e instala esa herramienta desde npm automáticamente.

Por ejemplo, la primera vez que ejecutas un comando de Orchestrator, uip instala @uipath/orchestrator-tool:

uip or folders list

Installing @uipath/orchestrator-tool...
✓ Installed @uipath/orchestrator-tool
...

Las invocaciones posteriores de uip or ... utilizan la herramienta instalada directamente. También puedes instalar herramientas de forma explícita (útil en ejecutores de CI y redes restringidas) con uip tools install:

uip tools install @uipath/orchestrator-tool
uip tools install @uipath/solution-tool

Consulta Herramientas (complementos) para ver la lista blanca completa y Gestionar herramientas y habilidades para la gestión diaria de herramientas.

Instalación automática de la herramienta de control

La instalación automática se ejecuta siempre que el verbo invocado esté en la lista blanca y la herramienta aún no esté instalada. CI=true no tiene ningún efecto sobre ella: esa variable no se consulta en ningún lugar de la ruta de instalación automática. La verdadera opción de exclusión es UIPATH_CLI_DISABLE_AUTOINSTALL=true, que desactiva por completo las instalaciones de herramientas implícitas, incluida la comprobación diaria de actualización por herramienta descrita en Control de versiones y estabilidad. En los ejecutores de CI sin estado, sin preinstalar ni establecer esta variable, el primer comando de una compilación descarga su herramienta y los comandos posteriores en el mismo trabajo reutilizan la copia ya instalada, lo que hace que el primer comando sea más lento que los siguientes.

Para mantener los tiempos de compilación de CI deterministas, preinstala las herramientas que utilizas como un paso independiente, de modo que cada llamada posterior uip las encuentre ya presentes:

uip tools install @uipath/orchestrator-tool @uipath/solution-tool

La instalación automática no es operativa cuando la herramienta ya está instalada, por lo que el paso de preinstalación es el único cambio de comportamiento que necesitas. En un ejecutor aislado en el que quieres una garantía sólida de que nada intenta llegar a npm a mitad de la compilación, establece también UIPATH_CLI_DISABLE_AUTOINSTALL=true: un comando para una herramienta que aún no está presente falla inmediatamente en lugar de intentar una descarga.

Habilitar finalización de shell

UiPath CLI incluye la finalización de pestañas para bash, zsh, fish y pwsh. La finalización se instala desde la propia CLI:

uip completion

En un terminal, uip completion detecta tu shell desde $SHELL / $PSModulePath /plataforma, imprime el archivo rc de destino que modificará y pide confirmación. Acepta la solicitud y vuelve a abrir tu shell: uip <TAB> ahora completa subcomandos y opciones.

Para la configuración con script, canaliza el script de finalización directamente a tu archivo rc:

# zsh
uip completion zsh >> ~/.zshrc

# bash
uip completion bash >> ~/.bashrc

# fish
uip completion fish > ~/.config/fish/completions/uip.fish

# PowerShell
uip completion pwsh >> $PROFILE

Otras opciones:

• uip completion --print — vista previa de la ruta de destino y el bloque que se escribiría, sin modificar el sistema de archivos.
• uip completion --uninstall : elimina el bloqueo de finalización gestionado.

Nota:

La finalización de valor de marcador dinámico (por ejemplo, uip or packages upload --package-name <TAB>) es solo zsh y requiere la utilidad jq en tu PATH. Sin jq, se suprimen los candidatos dinámicos; el subcomando estático y la finalización del nombre de la opción siguen funcionando en los cuatro shells.

ADVERTENCIA:

Vuelva a ejecutar la finalización después de cada actualización de CLI o herramienta

El script de finalización es una instantánea estática de los subcomandos y nombres de opciones conocidos en el momento en que se ejecutó uip completion . Después de npm install -g @uipath/cli@<new-version>, uip tools install <new-tool> o uip tools update, vuelve a ejecutar uip completion para que se indexen los comandos y marcadores recién añadidos:

uip completion              # interactive — refreshes the existing block
uip completion zsh >> ~/.zshrc   # or pipe into the rc file directly

Sin una actualización, los verbos nuevos (por ejemplo, un verbo añadido en una versión MENOR de una herramienta) no se autocompletarán aunque funcionen en la línea de comandos.

Notas de la plataforma

Ventanas

Ejecuta comandos desde PowerShell, Windows Terminal o cmd. Si uip no se reconoce después de la instalación, abre una nueva ventana de terminal para que la actualización de PATH surta efecto, o ejecuta:

npm config get prefix

y confirma que el directorio devuelto está en tu PATH.

macOS y Linux

La mayoría de los gestores de paquetes colocan el ejecutable uip en el PATH predeterminado. Si instalas npm globales en un directorio local de usuario (como se recomienda, evita sudo), asegúrate de que ese directorio esté en tu PATH. Por ejemplo, con un prefijo ~/.npm-global :

export PATH="$HOME/.npm-global/bin:$PATH"

Añade la línea a tu perfil de shell (~/.zshrc, ~/.bashrc, etc.) para persistir.

Detrás de un proxy corporativo

UiPath CLI respeta las variables de entorno del proxy HTTP estándar tanto para la propia CLI como para la autoinstalación de la herramienta:

Variable	Propósito
HTTP_PROXY / http_proxy	Proxy para solicitudes HTTP
HTTPS_PROXY / https_proxy	Proxy para solicitudes HTTPS
NO_PROXY / no_proxy	Lista separada por comas de hosts que omiten el proxy

Ejemplos:

# macOS / Linux
export HTTPS_PROXY=http://proxy.example.com:8080
export NO_PROXY=localhost,127.0.0.1,.internal.corp
uip login

# Windows PowerShell
$env:HTTPS_PROXY = "http://proxy.example.com:8080"
$env:NO_PROXY = "localhost,127.0.0.1,.internal.corp"
uip login

:: Windows cmd
set HTTPS_PROXY=http://proxy.example.com:8080
set NO_PROXY=localhost,127.0.0.1,.internal.corp
uip login

Los proxies con autenticación básica son compatibles si se incluyen las credenciales en la URL: http://user:[e-mail]:8080.

Consejo:

La CLI incluye una implementación fetch con reconocimiento de proxy, por lo que HTTPS_PROXY / HTTP_PROXY se respetan sin configuración adicional en Node.js.

Telemetría

UiPath CLI envía telemetría de uso anónimo a UiPath para ayudar a mejorar el producto. No se transmiten argumentos de comando, contenidos de archivo o credenciales.

Variable	Comportamiento
UIPATH_TELEMETRY_DISABLED	Establezca en 1 o true para excluirse.
UIPATH_AI_CONNECTION_STRING	Anula la cadena de conexión de Application Insights, por ejemplo, para enrutar la telemetría a tu propia instancia.

# Opt out for the current shell
export UIPATH_TELEMETRY_DISABLED=1

# Or just for one command
UIPATH_TELEMETRY_DISABLED=1 uip login

Instalar en CI/CD

Instala la CLI como un paso en tu proceso. Como uip no tiene herramientas preinstaladas, deja que las herramientas se instalen automáticamente en el primer uso o preinstalalas explícitamente. Esto último es más rápido en ejecutores sin estado porque la descarga de la herramienta se produce una vez por paso en lugar de en cada comando.

Acciones de GitHub

steps:
  - uses: actions/setup-node@v4
    with:
      node-version: '22'

  - name: Install UiPath CLI
    run: npm install -g @uipath/cli

  - name: Pre-install tools
    run: uip tools install @uipath/orchestrator-tool @uipath/solution-tool

  - name: Authenticate
    run: uip login --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET
    env:
      UIPATH_CLIENT_ID: ${{ secrets.UIPATH_CLIENT_ID }}
      UIPATH_CLIENT_SECRET: ${{ secrets.UIPATH_CLIENT_SECRET }}

  - name: Run CLI commands
    run: uip or folders list --output json

Azure DevOps

steps:
  - task: NodeTool@0
    inputs:
      versionSpec: '22.x'
    displayName: 'Use Node.js 22'

  - script: npm install -g @uipath/cli
    displayName: 'Install UiPath CLI'

  - script: uip tools install @uipath/orchestrator-tool @uipath/solution-tool
    displayName: 'Pre-install UiPath CLI tools'

  - script: uip login --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET
    displayName: 'Authenticate'
    env:
      UIPATH_CLIENT_ID: $(UIPATH_CLIENT_ID)
      UIPATH_CLIENT_SECRET: $(UIPATH_CLIENT_SECRET)

Jenkins (canalización declarativa)

stage('Install UiPath CLI') {
  steps {
    sh 'npm install -g @uipath/cli'
    sh 'uip tools install @uipath/orchestrator-tool @uipath/solution-tool'
  }
}

stage('Authenticate') {
  steps {
    withCredentials([
      string(credentialsId: 'UIPATH_CLIENT_ID', variable: 'UIPATH_CLIENT_ID'),
      string(credentialsId: 'UIPATH_CLIENT_SECRET', variable: 'UIPATH_CLIENT_SECRET')
    ]) {
      sh 'uip login --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET'
    }
  }
}

Consulta Recetas de CI/CD para ver ejemplos de procesos completos, incluidas las etapas de empaquetado, publicación y prueba.

Consejo:

Almacena en caché el directorio global npm entre compilaciones para evitar reinstalar @uipath/cli y sus herramientas en cada ejecución. En Acciones de GitHub, utiliza la clave actions/cache en la versión de CLI que anclas.

Instalar desde el registro npm de GitHub

La mayoría de los usuarios no necesitan esta sección: las instalaciones simples y manuales anteriores extraen @uipath/cli y todas las herramientas de la lista blanca del registro público de npm. Existe para dos casos más específicos, ambos atendidos por el mismo registro npm de GitHub (https://npm.pkg.github.com):

• Compilaciones alfa/internas de @uipath/skills (versiones como @uipath/skills@<version>-alpha.*), instaladas de forma transitiva cuando uip skills install necesita una compilación más reciente que la que está en npm público.
• Vista previa/compilaciones internas de un puñado de paquetes básicos ( cli, solution-tool, codedagent-tool, orchestrator-tool ) publicados en Paquetes de GitHub antes de su lanzamiento público de npm.

Antes de que uip tools install (o uip skills install) pueda resolver uno de estos, configura npm para enrutar el ámbito @uipath a través del registro de GitHub.

Crea (o actualiza) ~/.npmrc (en el nivel de usuario) o ./.npmrc (en el nivel de proyecto) con:

@uipath:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${GH_NPM_REGISTRY_TOKEN}

GH_NPM_REGISTRY_TOKEN es un token de acceso personal de GitHub (clásico) con al menos el ámbito read:packages, autorizado para SSO en UiPath org.

export GH_NPM_REGISTRY_TOKEN=<your-pat>
npm install -g @uipath/cli

Una vez configurados, uip tools install y uip tools update recogen los paquetes registrados en GitHub de la misma manera que recogen los públicos.

Nota:

Esto no está relacionado con @uipath/rpa-tool, cuyo origen y distribución reales se encuentran en un repositorio independiente (UiPath/Studio): el registro npm de GitHub descrito aquí solo contiene las compilaciones alfa/vista previa enumeradas anteriormente.

Ejecutar sin una instalación global

Para uso ad-hoc o procesos que prefieren no instalarse globalmente, puedes ejecutar la CLI a través de npx:

npx -y @uipath/cli <command>

Por ejemplo:

npx -y @uipath/cli login
npx -y @uipath/cli or folders list

La primera invocación descarga el paquete; las invocaciones posteriores reutilizan la caché de npm.

Actualización

Nota:

La CLI se actualiza automáticamente, una vez al día. El primer comando elegible uip cada día busca una versión más reciente en tu canal configurado (stable de forma predeterminada; consulta core.updateChannel en la configuración de uip), la instala si existe y vuelve a ejecutar tu comando original en el nuevo versión. Detecta cómo instalaste uip (Homebrew keg, npm, pnpm o bun global) y envía automáticamente el comando de actualización correspondiente: brew upgrade uip para una instalación de Homebrew, el comando equivalente add/install en caso contrario. Esta actualización automática nunca cruzará a una nueva versión MAYOR por sí sola, que siempre requiere un uip update explícito o un pin de versión. Se ejecuta una comprobación independiente por herramienta, en el primer uso de esa herramienta cada día, actualizándola a la última versión en la propia línea de CLI. Ambas comprobaciones se deshabilitan por completo configurando UIPATH_CLI_DISABLE_VERSION_SYNC=true: útil para ejecutores o procesos aislados que requieren una invocación uip totalmente determinista y sin red.

Los siguientes comandos manuales siguen funcionando en cualquier momento: para saltar a una versión específica inmediatamente, para anclar o con la sincronización diaria deshabilitada. Utiliza el que coincida con la instalación de uip:

# npm
npm install -g @uipath/cli@latest    # latest release
npm install -g @uipath/cli@1.0.0     # pinned version

# pnpm
pnpm add -g @uipath/cli@latest

# bun
bun add -g @uipath/cli@latest

# Homebrew
brew upgrade uip

Homebrew siempre se actualiza a cualquier versión que el toque publique actualmente: fijar una versión exacta no es un concepto de Homebrew, así que utiliza uno de los otros métodos si necesitas anclar.

Consejo:

Anclar una versión exacta en CI. @uipath/cli sigue el versionado semántico, pero la forma de Data en la salida JSON es específica del comando y puede cambiar entre versiones MENOR (consulta Versiones y estabilidad). La fijación evita sorpresas en el momento de la compilación en procesos que analizan JSON. Al aumentar, vuelve a validar los scripts que dependen de nombres de campo específicos.

Consulta las notas de la versión para ver qué ha cambiado entre versiones.

La actualización del host no actualiza automáticamente las herramientas instaladas. Para actualizar herramientas:

uip tools update                        # update all installed tools
uip tools update --name <package>       # update a single tool
uip tools update --name <package> --version <version>   # pin to a specific version

De forma predeterminada, cada versión de la herramienta realiza un seguimiento de la línea MAYOR.MINOR de CLI, por lo que ejecutar uip tools update después de una actualización de CLI pone en marcha todas las herramientas instaladas. Consulta Herramientas (complementos) para el contrato de fijación.

Desinstalando

Elimina la CLI con el método que utilizaste para instalarla:

npm uninstall -g @uipath/cli
# or
pnpm remove -g @uipath/cli
# or
bun remove -g @uipath/cli
# or, if installed via Homebrew
brew uninstall uip

Esto elimina el ejecutable uip. Las herramientas instaladas (@uipath/orchestrator-tool y similares) se encuentran en el prefijo global de npm, independientemente del método que instaló el host, y no se eliminan automáticamente: ejecuta uip tools uninstall <tool> primero o elimina $(npm root -g)/@uipath después para borrar todo a la vez.

Eliminar credenciales y datos

Desinstalar el paquete deja varias partes del estado en disco. Límpialos manualmente cuando quieras empezar de nuevo o necesites dar de baja una máquina.

Credenciales de sesión

uip login persiste la sesión dentro de ~/.uipath/ en tu directorio de inicio de forma predeterminada. Cuando el CLI se inicia, sube desde el directorio actual buscando primero una carpeta .uipath/ , para que una carpeta de proyecto pueda llevar su propia sesión sin modificar el directorio de inicio del usuario. Comprueba ambas ubicaciones al limpiar:

# macOS / Linux
rm -rf ~/.uipath

# Windows PowerShell
Remove-Item -Recurse -Force "$env:USERPROFILE\.uipath"

Comprueba también cada proyecto en el que has trabajado para un .uipath/ local. Consulta Sesiones y credenciales para ver el diseño completo.

Finalización del shell

Si uip completion, el bloque de finalización seguirá estando en tu archivo rc de shell después de la desinstalación. Elimínalo antes de desinstalar @uipath/cli, o límpialo manualmente desde ~/.zshrc, ~/.bashrc o $PROFILE:

# Before uninstalling, while uip is still available:
uip completion --uninstall

Caché global de npm

npm mantiene una caché local de archivos tar descargados en la ruta informada por npm config get cache. Esto no necesita ser limpiado para la mayoría de los usuarios; límpialo solo para recuperar espacio en disco o para solucionar problemas de una descarga corrupta:

npm cache clean --force

Solución de problemas

uip: comando no encontrado después de la instalación

El directorio global npm no está en su PATH. Ejecuta npm config get prefix para ver dónde npm colocó el iniciador uip , luego añade la subcarpeta bin de ese directorio a tu PATH y abre un nuevo terminal.

EACCES o errores de permiso en la instalación

En macOS y Linux, evita sudo npm install. Configura npm para utilizar un prefijo local de usuario una vez:

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"

A continuación, reinstala: npm install -g @uipath/cli.

La instalación automática de la herramienta se bloquea o agota el tiempo de espera

Es posible que estés detrás de un proxy que bloquea npm. Configura HTTPS_PROXY como se describe en Detrás de un proxy corporativo o preinstala las herramientas en una máquina con acceso a Internet y copia el node_modules global en la máquina de destino.

La versión del nodo es demasiado antigua

uip requiere Node.js 22 o posterior. Actualiza Node.js o cambia de versión con nvm use 22.

Consulta Solución de problemas para obtener más errores y sus resoluciones.

Próximos pasos

• Inicio rápido : inicia sesión, enumera las carpetas de Orchestrator y ejecuta un trabajo en cinco minutos.
• Su primer proceso : empaquete un proyecto e impleméntelo desde CI.
• Autenticación : inicio de sesión interactivo, credenciales de cliente de aplicación externa, identidad federada/de carga de trabajo y autenticación de variable de entorno para CI.
• Utilizar UiPath CLI con agentes de codificación : instala habilidades en Claude Code, Cursor, GitHub Copilot y otros agentes de codificación de IA compatibles.