Instalación

Theus CLI se instala con una línea. En macOS y Linux, el instalador oficial prefiere el binario nativo, que incluye su runtime y no requiere Bun. Descarga la versión de tu plataforma, verifica su SHA-256 e instala el comando theus en tu PATH.

Theus Desktop

Los instaladores de Desktop para macOS y Windows incluyen Ñaupa para explorar e indexar tu proyecto. También puedes instalar Ñaupa de forma independiente para conectarlo a otros agentes mediante MCP.

Descarga la aplicación desde theus.pe/desktop. Hay instaladores para macOS 13 o posterior en Apple Silicon e Intel, y para Windows x64. La aplicación para macOS está firmada y notarizada. Consulta allí la versión vigente y sus huellas. Desktop permite conversar o trabajar con un proyecto y terminales.

El agente coordina herramientas y subagentes desde la conversación, puede pedirte información y entrega enlaces a los archivos creados. El navegador integrado y las acciones sobre tus archivos conservan los permisos de la sesión. Las tareas muestran sus límites de contexto y presupuesto estimado; si no cabe otra solicitud, se detienen conservando lo terminado. La estimación no representa un importe facturado.

En Windows, el instalador incluye Visual C++, necesario para el motor local de Crea tu LLM. Si el componente no está disponible o cancelas el permiso de instalación, la aplicación lo explica y permite volver a intentarlo. Si Windows solicita reiniciar, hazlo antes de usar ese motor. El instalador de Theus para Windows continúa sin firma y el sistema puede mostrar un aviso de editor desconocido.

Crea tu LLM requiere MAX 10x. El Afinador 0.1.0 se descarga desde Desktop 0.3.2 o posterior para adaptar un modelo de texto compatible con tus datos.

Crea y usa tu modelo local

En Desktop, abre Crea tu LLM y sigue sus siete pasos: tu equipo, privacidad, modelo, datos, reglas, nombre y auditoría. La guía comprueba los recursos disponibles y te ayuda a elegir un modelo compatible. Las opciones avanzadas se pueden desplegar cuando las necesites.

1. Revisa tu equipo y completa la instalación del motor local si falta. Acepta las condiciones de privacidad antes de continuar.
2. Elige el modelo y revisa su licencia. Durante la descarga verás su preparación, el progreso y la verificación. Espera a que indique que está listo antes de continuar; si aparece un error, la guía permite reintentarlo.
3. Añade tus datos, define cómo debe comportarse y ponle un nombre. Los datos y el modelo permanecen en tu equipo.
4. Revisa qué respuestas se enviarán para la auditoría de seguridad y autoriza ese envío expresamente. La auditoría está incluida en MAX 10x y consume el cupo del plan, sin cobro adicional. Si el cupo no alcanza, espera a que se renueve; no se utiliza tu saldo de recargas para completarla.
5. Consulta el resultado en Mis LLM. La auditoría debe aprobarse antes de usar el modelo dentro de Theus. Desde su ficha puedes revisar el informe, editar sus datos y reglas o eliminar el modelo mediante una confirmación.

La comprobación del cupo no inicia la auditoría ni envía tus respuestas. Consulta el detalle del tratamiento de datos en la política de privacidad.

Afina un modelo con tus datos

Necesitas un Mac con Apple Silicon o Windows de 64 bits con GPU NVIDIA compatible con CUDA y su controlador correspondiente. La memoria y el espacio necesarios dependen del modelo y los datos; Desktop los muestra antes de iniciar.

1. Actualiza a Desktop 0.3.2 o posterior e inicia sesión con tu cuenta MAX 10x.
2. Abre Crea tu LLM. En Tu equipo, abre Afinar con tus datos y descarga el Motor de afinado.
3. Elige un modelo de texto compatible del catálogo y añade los datos con los que quieres adaptarlo.
4. En Mis LLM, abre Afinar, revisa los recursos necesarios y comienza. Puedes seguir el progreso, pausar el trabajo y retomarlo desde el último punto guardado.

Desktop descarga y comprueba la integridad de los archivos necesarios. La duración del trabajo depende del tamaño del modelo, la cantidad de datos y tu equipo.

Desde Desktop 0.3.6, si falta el motor, Revisar motor de afinado abre su instalación. Si la base aún no está preparada, primero completa su descarga y vuelve a comprobarla. Las órdenes de pausar, reanudar y cancelar muestran que están pendientes hasta que el motor las confirma.

Requisitos

• Sistema: macOS o Linux, en x64 o arm64. En Windows, mira más abajo.
• Binario nativo: no necesita Bun instalado. El paquete npm usa un lanzador con Node.js 18 o posterior para seleccionar el binario de tu plataforma.
• Portable o código fuente: requieren una versión estable de Bun 1.4.3 o posterior. El instalador de macOS/Linux lo descarga y comprueba si falta; si encuentra una versión anterior, se detiene y pide actualizarla.
• Herramientas base: curl y tar (presentes en casi cualquier sistema). El modo source requiere además git.

Instalador oficial (recomendado)

curl -fsSL https://theus.pe/install.sh | bash
theus --version

Qué hace el instalador, paso a paso:

• Detecta tu plataforma (macOS/Linux, x64/arm64) y busca el binario nativo correspondiente en theus.pe/dl.
• Verifica el SHA-256 del archivo descargado contra SHA256SUMS. Si no coincide, la instalación se aborta. En macOS comprueba también la firma del binario nativo.
• Si no hay binario nativo disponible, el modo auto intenta el paquete portable y, si tampoco puede descargarlo, el código fuente. Estas dos rutas comprueban Bun 1.4.3 o posterior. El portable dispone de un origen de descarga de respaldo.
• Instala Theus en ~/.theus/app y enlaza el comando theus en el primer directorio escribible de tu PATH (~/.local/bin, /usr/local/bin o ~/.bun/bin; si ninguno existe, crea ~/.local/bin). Si ese directorio no está en tu PATH, te lo advierte con la línea exacta que debes añadir a tu shell.

Arranca con theus. En portable y source, el instalador crea un lanzador que evita cargar automáticamente .env, bunfig.toml y los aliases de tsconfig.json del proyecto abierto. Ejecutar directamente bun cli.js omite esas protecciones. Si instalaste una versión anterior, vuelve a ejecutar el instalador para renovar el lanzador.

Variables del instalador

Todas son opcionales; se exportan antes de ejecutar el script:

Instalación desde el código fuente

Con THEUS_INSTALL_MODE=source el instalador necesita acceso al repositorio, comprueba Bun 1.4.3 o posterior, instala dependencias con bun install y compila el bundle con bun run build. Para instalaciones reproducibles, fija el commit exacto:

THEUS_INSTALL_MODE=source THEUS_COMMIT=<sha> \
  bash -c "$(curl -fsSL https://theus.pe/install.sh)"

Usa después el comando instalado theus. Si trabajas directamente sobre un checkout del código fuente, usa ./bin/theus para iniciar la aplicación con su lanzador.

Instalación vía npm

El paquete theus-cli contiene un lanzador que selecciona el binario nativo de tu plataforma. Requiere Node.js 18 o posterior para el lanzador; no necesita Bun. Hay paquetes para macOS y Linux x64/arm64 y para Windows x64:

npm install -g theus-cli
theus --version

También puedes probarlo sin instalar globalmente:

npx theus-cli

Windows

En Windows también se instala con un solo comando. Tienes dos caminos y conviene saber qué esperar de cada uno.

Instalador PowerShell (paquete portable)

powershell -c "irm https://theus.pe/install.ps1 | iex"

Esta ruta instala el paquete portable y requiere Bun estable 1.4.3 o posterior. Descarga Bun si falta, verifica los checksums de las descargas, deja el comando theus en tu PATH de usuario y añade Ñaupa cuando hay un binario compatible. Si ya tienes un Bun anterior, pide actualizarlo antes de continuar. Es idempotente: relánzalo cuando quieras para actualizar.

El lanzador theus.cmd evita la autocarga de .env, la configuración de Bun y los aliases del tsconfig.json del proyecto abierto. Usa theus para conservar esas protecciones.

Cada cambio del instalador se ejecuta en una máquina Windows limpia, en x64 y arm64, comprobando que instala, que theus queda en el PATH, que responde, y que relanzarlo encima funciona.

En Windows x64 también puedes instalar el binario nativo mediante npm, con Node.js 18 o posterior y sin Bun:

npm install -g theus-cli

WSL (el camino más rodado)

Dentro de WSL, Theus es una instalación de Linux normal: el instalador oficial prefiere el binario nativo y añade Ñaupa si hay un binario compatible.

curl -fsSL https://theus.pe/install.sh | bash

El binario nativo incluye su runtime. Si se necesita la ruta portable, el instalador comprueba Bun antes de continuar.

Primer arranque

cd /ruta/de/tu/proyecto
theus                    # sesión interactiva
theus -p "tu prompt"     # modo no interactivo
theus --help             # ayuda del CLI

El motor de código actual es Ñaupa, que Theus conecta como servidor MCP cuando está disponible para consultar archivos, símbolos y relaciones del proyecto. Su mapa se sirve localmente. La inteligencia de proyecto clásica permanece como alternativa heredada; estas variables controlan cada superficie:

Interfaz terminal y accesibilidad

Desde v0.2.62, el splash, el menú y las pantallas de configuración cambian de densidad según el ancho y la altura disponibles. Las acciones principales siguen accesibles incluso en una terminal de 40×14; cualquier tecla omite el splash.

El CLI público requiere iniciar sesión con Theus y usa su servicio para la inferencia; no admite claves de otros proveedores ni modelos locales. El índice del proyecto y la memoria permanecen en ~/.theus/knowledge/; el contexto necesario para la petición gestionada se envía al servicio. Crea tu LLM de Desktop es un flujo separado.

Conectar tu cuenta: theus login

theus login conecta el CLI a tu suscripción de theus.pe con OAuth y PKCE. El flujo completo:

• El CLI levanta un callback local en 127.0.0.1 y abre el navegador en la página de autorización de theus.pe.
• Inicias sesión en la web — por magic link a tu correo, o con los proveedores de identidad que la web tenga habilitados — y autorizas al CLI.
• El CLI intercambia el código por un token (PKCE, /v1/oauth/token), consulta tu perfil y plan, y crea automáticamente una API key de Theus para el CLI.
• Deja instalado el proveedor theus-official (endpoint https://api.theus.pe/v1, con el modelo orquestador por defecto) en ~/.theus/providers.json, y guarda los datos de sesión en ~/.theus/session.json.

Al terminar verás tu plan, la URL de tu consola y el sufijo de la API key activa. A partir de ahí basta con theus: no exportas ninguna variable ni pegas ninguna key.

theus login                      # flujo normal (abre el navegador)
theus login --no-open            # imprime la URL de login en vez de abrir el navegador
theus login --token <api_key>    # instala una API key existente sin pasar por el navegador

Actualizar

# instalación con el instalador oficial (macOS/Linux)
curl -fsSL https://theus.pe/install.sh | bash

# Windows (PowerShell) — el mismo instalador es idempotente
powershell -c "irm https://theus.pe/install.ps1 | iex"

# instalación vía npm
npm update -g theus-cli

Dentro de una sesión, theus update actualiza el CLI y también Ñaupa en un solo paso.

Desinstalar

En macOS/Linux, puedes quitar el enlace theus y la app en ~/.theus/app con estos comandos. La instalación opcional de Ñaupa y, si fue necesario, Bun permanecen disponibles:

rm "$(command -v theus)"    # quita el enlace del PATH
rm -rf ~/.theus/app         # quita la aplicación

Tu configuración, proveedores, sesión y memoria de proyectos viven en el resto de ~/.theus/ (providers.json, session.json, knowledge/…). Consérvala si piensas reinstalar; para borrar todo rastro:

rm -rf ~/.theus

Si instalaste por npm: npm uninstall -g theus-cli.