Instalar nrgrd
nrgrd es el cliente de terminal de NeuroGrid: un agente de código que trabaja
en tu repositorio desde la shell. Se conecta a cualquier endpoint compatible
con OpenAI, incluido un deployment de NeuroGrid, y está publicado en PyPI
como nrgrd.
Corre en macOS, Linux y Windows, y necesita Python 3.11 o más reciente.
Esta es la herramienta para usar inferencia. Si quieres alquilar una GPU, lo que necesitas es el agente, que viene como una imagen de Docker.
Instalación
Con uv (recomendado)
uv instala nrgrd en su propio entorno, pone el comando nrgrd en tu PATH, y
descarga un Python adecuado si no tienes uno.
uv tool install nrgrd
¿Todavía no tienes uv? Instálalo primero, y luego corre el comando de arriba en una terminal nueva.
# macOS y Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Con pipx
Necesita Python 3.11 o más reciente ya instalado.
pipx install nrgrd
Con pip
Instálalo en un entorno virtual, no en tu Python del sistema. nrgrd queda entonces disponible cada vez que ese entorno está activo.
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install nrgrd
Comprueba que funcionó
nrgrd --version
Imprime la versión instalada, por ejemplo nrgrd 0.1.0.
Primera ejecución
Abre una terminal en el proyecto con el que quieres trabajar e inicia nrgrd:
cd mi-proyecto
nrgrd # interactivo
nrgrd "explica este repositorio" # un solo prompt, y sale
La primera vez, pide la URL del endpoint y la API key de tu deployment, ambas desde tu consola de NeuroGrid. Luego le pregunta al endpoint qué modelos sirve, y si hay solo uno, lo elige por ti.
La API key se guarda en el almacén de credenciales de tu sistema operativo — Keychain, Windows Credential Manager, o Secret Service en Linux — no en un archivo de configuración.
Cambia la conexión más tarde con /config edit. Escribe /help para ver
todos los comandos.
Actualizar y desinstalar
| uv | pipx | pip | |
|---|---|---|---|
| Actualizar | uv tool upgrade nrgrd | pipx upgrade nrgrd | pip install -U nrgrd |
| Desinstalar | uv tool uninstall nrgrd | pipx uninstall nrgrd | pip uninstall nrgrd |
Solución de problemas
Windows: "incompatible hardlinks" (os error 396)
Síntoma. uv tool install nrgrd falla con
The cloud operation cannot be performed on a file with incompatible hardlinks. (os error 396).
Causa. uv instala creando hardlinks de archivos desde su caché. OneDrive, común en laptops de trabajo, no permite hardlinks en las carpetas que administra.
Arreglo. Dile a uv que copie los archivos en lugar de enlazarlos:
uv tool uninstall nrgrd
uv tool install nrgrd --link-mode=copy
Para que copiar sea lo normal en cada instalación de uv, corre esto una vez y abre una terminal nueva:
[Environment]::SetEnvironmentVariable("UV_LINK_MODE", "copy", "User")
No se reconoce el comando nrgrd
Causa. La carpeta donde uv o pipx ponen los comandos todavía no está en tu PATH.
Arreglo. Corre uv tool update-shell (o pipx ensurepath), y abre una
terminal nueva.
error: externally-managed-environment
Causa. En macOS y Linux recientes, pip se niega a instalar en el Python del sistema, para proteger los paquetes propios del sistema operativo.
Arreglo. Usa uv o pipx, o pip dentro de un entorno virtual como se muestra arriba.
El paquete 'nrgrd' requiere un Python diferente
Causa. pip o pipx están corriendo sobre Python 3.10 o más antiguo.
Arreglo. Instala con uv, que descarga un Python adecuado por su cuenta, o instala Python 3.11 o más reciente.
pipx: "pipx needs uv>=…"
Causa. Las versiones recientes de pipx usan uv cuando lo encuentran en tu máquina, y tu uv es más viejo de lo que requiere.
Arreglo. Actualiza uv (uv self update si lo instalaste con el
instalador independiente), o sáltatelo con
pipx install --backend pip nrgrd.