Documentación de Theus

Theus es un agente de código local-first y multimodelo: indexa tu proyecto en tu propia máquina, mantiene memoria y un grafo del código, y con tu suscripción te da acceso a los 20 mejores modelos de código y razonamiento — sin traer tus propias API keys. Hecho en Perú.

Una suscripción, 20 modelos, un cerebro. Theus configura de forma central las API keys de cada proveedor; tú usas los mejores modelos (Claude, GPT, Gemini, DeepSeek, Grok, Qwen y más) a través de tu suscripción con una sola API key de Theus. TITAN, el orquestador propio de Theus, analiza cada petición y elige uno o varios modelos, orquesta y sintetiza — o fijas el que quieras con /model. Ver Modelos incluidos.

THEUS HECHO EN PERU · AD ASTRA PER ASPERA. Local-first por defecto: cada usuario controla su modelo y su llave, sin depender de un proveedor único.

Qué es Theus

Theus abre una sesión interactiva desde cualquier proyecto con el comando theus. Al arrancar dentro de un repositorio:

Indexa el proyecto localmente para reducir contexto repetido y mejorar la memoria de la sesión.
Levanta una API local en 127.0.0.1 con estado, grafo y esquema de base de datos.
Abre un dashboard visual con mapa neuronal, archivos, símbolos, entidades, base de datos y memoria.
Conecta el modelo que tú elijas: un modelo local, un endpoint OpenAI-compatible o un proveedor propio (BYOK).

Toda la configuración vive bajo ~/.theus/, las variables de entorno usan el prefijo THEUS_* y el índice y la memoria se persisten en ~/.theus/knowledge/.

Instalación

Requisito de runtime: Bun. El instalador oficial lo instala por ti si falta, verificando su checksum SHA-256.

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

El instalador detecta tu plataforma (macOS/Linux, x64/arm64), instala Theus en ~/.theus/app y enlaza el comando theus en tu PATH. Es idempotente: para actualizar, vuelve a ejecutarlo.

Primer uso

cd /ruta/de/tu/proyecto
theus

Para una ejecución no interactiva, usa theus -p "tu prompt". Dentro de la sesión, escribe /help para ver la ayuda.

Conectar un modelo

Theus lee primero las variables THEUS_*. Puedes apuntar a un servidor local o a cualquier endpoint OpenAI-compatible:

export THEUS_BASE_URL="http://127.0.0.1:11434/v1"
export THEUS_MODEL="llama3.1"
export THEUS_API_KEY="local"
theus

Alternativamente, define tus proveedores en ~/.theus/providers.json. Consulta Proveedores y Modelos para el detalle.

Cuenta Theus

Para usar una cuenta remota, el comando theus login abre el flujo OAuth propio en theus.pe, intercambia el código por token con PKCE y deja instalado el proveedor theus-official en ~/.theus/providers.json. Así puedes entrar con theus y enviar prompts sin exportar variables manualmente.

Secciones de la documentación

Sección	Qué cubre
MCP	Servidores MCP y cómo ampliar las capacidades del agente.
Sandboxing	Aislamiento de ejecución y control de lo que el agente puede tocar.
Hooks	Ganchos para automatizar comportamiento alrededor de la sesión.
Chrome	Integración con el navegador para tareas web.
Seguridad	Permisos de herramientas, límites y buenas prácticas.
Costos	Cómo se consume el modelo y cómo controlar el gasto.
Modelos	Selección de modelo con `/model` y variables de entorno.
Proveedores	Configuración de `providers.json` y endpoints OpenAI-compatible.

Comandos principales

Comando	Propósito
`theus`	Inicia la sesión interactiva.
`theus -p "prompt"`	Ejecuta en modo no interactivo.
`theus --help`	Muestra la ayuda.
`/help`	Ayuda dentro del REPL.
`/model`	Selección de modelo.
`/mcp`	Servidores MCP.
`/permissions`	Permisos de herramientas.
`/init`	Inicializa la documentación del proyecto.

El copy visible de Theus se mantiene en español primero y sin marcas externas. Los identificadores técnicos que aparezcan en ejemplos de configuración son solo el dato que necesitas para conectarte.

Theus — agente de código local-first y multimodelo · Hecho en Perú