> ## Documentation Index
> Fetch the complete documentation index at: https://nekzus-32.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# LIOP Agent (CLI)
> Pasarela de seguridad Zero-Config para aplicaciones de IA de escritorio
El **LIOP Agent** es una utilidad de línea de comandos lista para producción incluida en el paquete `@nekzus/liop`. Actúa como un puente entre las interfaces de IA estándar (como **Claude Desktop** o **Cursor**) y el protocolo descentralizado **Logic-Injection-on-Origin Protocol**.
En lugar de programar un servidor personalizado, los usuarios pueden simplemente ejecutar el agente para obtener instantáneamente capacidades de "Logic-Injection-on-Origin".
## Instalación
El agente se distribuye a través del paquete principal del SDK. Puedes ejecutarlo directamente usando `npx`:
```bash theme={null}
npx -y @nekzus/liop@latest
```
O instalarlo globalmente para tener el comando `liop` disponible en todo el sistema:
```bash theme={null}
npm install -g @nekzus/liop@latest
liop
```
## 🤖 Integración con Claude Desktop
LIOP está diseñado para ser un reemplazo directo de los servidores MCP. Para añadir las herramientas de la red LIOP a tu experiencia en Claude Desktop, actualiza tu archivo de configuración:
```json Windows (%APPDATA%\Claude\claude_desktop_config.json) theme={null}
{
"mcpServers": {
"liop": {
"command": "npx",
"args": ["-y", "@nekzus/liop@latest"],
"env": {
"LIOP_NEXUS_URL": "http://tu-nexus-host:3000",
"LIOP_TOKEN_BANK": "tu-token-banco-aqui",
"LIOP_TOKEN_VAULT": "tu-token-boveda-aqui",
"LIOP_LOG_LEVEL": "info",
"NODE_OPTIONS": "--use-system-ca"
}
}
}
}
```
```json macOS (~/Library/Application Support/Claude/claude_desktop_config.json) theme={null}
{
"mcpServers": {
"liop": {
"command": "npx",
"args": ["-y", "@nekzus/liop@latest"],
"env": {
"LIOP_NEXUS_URL": "http://tu-nexus-host:3000",
"LIOP_TOKEN_BANK": "tu-token-banco-aqui",
"LIOP_TOKEN_VAULT": "tu-token-boveda-aqui",
"LIOP_LOG_LEVEL": "info",
"NODE_OPTIONS": "--use-system-ca"
}
}
}
}
```
Una vez configurado, reinicia Claude Desktop. Verás el estado 🛡️ **LIOP Guard** en tus logs de error indicando que la malla está activa.
## Características Principales
### 1. Persistencia de Identidad
El agente genera un **PeerID** único (par de claves Ed25519) la primera vez que se ejecuta. Esta identidad se almacena en:
`~/.liop/identity.json`
> \[!IMPORTANT]
> Si cambias de máquina, copiar esta carpeta te permitirá mantener tu reputación y accesos verificados en la red.
### 2. Enrutamiento Autónomo
El agente utiliza el `LiopMcpRouter` internamente. Cuando recibe una llamada de herramienta desde Claude:
1. Consulta la red P2P descentralizada para encontrar nodos que provean esa herramienta.
2. Establece un túnel seguro **Kyber768 + AES-256-GCM**.
3. Inyecta la lógica en el servidor remoto y devuelve el resultado verificado binariamente.
### 3. Descubrimiento de Bootstrap
Por defecto, el agente se conecta al **LIOP Alpha Nexus** oficial. Namun, puedes apuntarlo a cualquier nodo bootstrap de la red:
```bash theme={null}
npx @nekzus/liop@latest /ip4/1.2.3.4/tcp/4001/p2p/PEER_ID
```
## Seguridad y Diagnóstico
El agente solo se comunica a través de **STDIO**. Imprime logs de estado y eventos de descubrimiento estrictamente en `stderr`, asegurando que el canal `stdout` permanezca limpio para los mensajes JSON-RPC 2.0 requeridos por el cliente LLM.
### Diagnóstico Local de Malla (`LiopMeshStatus`)
El agente expone automáticamente una herramienta de diagnóstico local llamada **`LiopMeshStatus`**. Cuando un LLM invoca esta herramienta, el agente la intercepta localmente en lugar de enrutarla por la red P2P. Retorna instantáneamente un reporte legible por humanos detallando:
* Bootstrappers conectados y Peer IDs
* Nodos activos (Vault, Bank, Oracle)
* Tablas de enrutamiento de herramientas y estado de la Kademlia DHT
* Consumo de tokens y estimaciones de telemetría
Esto permite a los clientes de IA autodiagnosticar caídas de conexión o verificar qué herramientas están disponibles sin quemar ancho de banda ni duplicar peticiones de diagnóstico a través de múltiples nodos.
### Variables de Entorno
El comportamiento del agente se puede personalizar mediante las siguientes variables de entorno:
| Variable | Por defecto | Descripción |
| :----------------------------------- | :---------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `LIOP_NEXUS_URL` | *(ninguno)* | URL del nodo Nexus para Auto-Discovery. El agente resuelve el PeerID y el multiaddr desde el endpoint `/health` automáticamente |
| `LIOP_LOG_LEVEL` | `info` | Controla la verbosidad de los logs (`silent`, `info`, `debug`). Establecer en `silent` para suprimir toda la salida stderr |
| `LIOP_EXPECTED_PROVIDERS` | `1` | Número de proveedores de la malla a esperar durante el warm-up inicial. El polling adaptativo DHT continúa descubriendo proveedores adicionales en segundo plano |
| `LIOP_INITIAL_DISCOVERY_TIMEOUT_MS` | `8000` | Tiempo máximo (ms) a esperar durante la fase inicial de descubrimiento de la malla antes de continuar |
| `LIOP_MCP_COMPACT_TOOL_DESCRIPTIONS` | `true` | Elimina metadatos verbosos del protocolo en las descripciones de herramientas, reduciendo el consumo de tokens en \~500 por herramienta. Establecer en `0` para desactivar |
| `LIOP_GRPC_PORT` | `50051` | Sobreescribe el puerto gRPC por defecto del servidor RPC interno |
| `LIOP_WORKER_MAX_HEAP_MB` | `64` | Tamaño máximo del heap V8 por thread worker (defensa contra Heap Bomb) |
| `LIOP_DOCKER_MAP` | `false` | Fuerza la traducción de IPs internas de contenedores Docker (`172.x.x.x`) a la dirección loopback del host (`127.0.0.1`), mapeando los servicios gRPC de los nodos a los puertos publicados en el host para poder ejecutar demos locales con contenedores aislados |
| `LIOP_DEV_MODE` | `false` | Activa heurísticas de desarrollo que automatizan el mapeo de puertos Docker si la URL de Nexus apunta a puertos típicos de la demo local (`13000`/`13001`) |
| `LIOP_DATASET_SCALE` | `1` | Factor de escala utilizado por los nodos de prueba y demo para escalar dinámicamente el tamaño de generación de registros sintéticos (ej. transacciones bancarias, registros médicos) |
`LIOP_BOOTSTRAP_FILE` está **deprecada** desde v2.0.0-alpha. Usa `LIOP_NEXUS_URL` en su lugar. El agente emitirá un warning si detecta esta variable.
Si encuentras problemas de conexión, busca el icono 🛡️ en la consola o pídele al LLM que ejecute `LiopMeshStatus`.