Atlas integrado · v4.7 · 23 septiembre 2026

Atlas: terminales, Herdr/Moshi, DSH y OpenCode en ia-lab

Auditoría de solo lectura realizada el 2026-09-23 sobre ia-lab (100.75.152.118). No se reiniciaron servicios, no se ejecutaron instaladores y no se modificaron archivos. Se omitieron valores de Environment=, tokens, claves, cookies, auth state, sesiones y contenido de panes/historial.

Consulta también todos los perfiles y resultados históricos y el índice de archivos del kit.

1. Entrada segura y límites

ssh lab@HOST_IA_LAB

Identidad observada: hostname ia-lab, usuario lab, reloj remoto 2026-09-23T21:51:53+00:00. Antes de cualquier cambio, abrir una terminal separada y conservar la sesión llama como referencia. La auditoría consultó sólo estados, metadatos, nombres de ventanas y ayuda CLI; no hizo tmux capture-pane, history, journalctl, lectura de logs de contenido ni lectura de secretos.

2. Herdr: instalación, servicio y teclado

Estado observado

Instalación oficial de referencia (no ejecutada): el README del proyecto publica curl -fsSL https://herdr.dev/install.sh | sh, compilación desde https://github.com/ogulcancelik/herdr y el flujo de workspaces. Ver herdr-terminal y quick start. Conviene fijar una release y revisar el binario antes de sustituir el 0.9.1 local; no asumir que el instalador actual conserva esa configuración.

Operación prevista:

herdr                         # crea o conecta al servidor persistente
herdr status server            # consulta, no cambia estado
herdr session list             # listar sesiones si se necesita seleccionar
herdr session attach <nombre>  # adjuntar una sesión nombrada

La documentación pública usa Ctrl+B q para salir del cliente Herdr dejando procesos y sesión vivos. En el host, Herdr tiene prefijo Ctrl+B, no Ctrl+A.

3. tmux: la tecla Ctrl+A que sí está configurada

El archivo /home/lab/.tmux.conf contiene set -g prefix C-a, bind C-a send-prefix y un indicador de estado CTRL+A. Por tanto, las operaciones tmux son:

Ctrl-A d       detach del cliente tmux; procesos continúan
Ctrl-A c       nueva ventana
Ctrl-A n/p     siguiente/anterior ventana
Ctrl-A w       selector de ventanas

No confundir Ctrl-A d (tmux) con Ctrl-B q (Herdr). La configuración Herdr y tmux pueden estar anidadas; pulsar el prefijo del multiplexor exterior primero y comprobar el indicador visible.

4. Ventanas tmux observadas

Se consultaron nombres/contadores, no contenido de panes:

harness: General, Log, Check, Test, Monitior (6 panes)
llama:   General, Log, Check, Test, Monitor (6), OpenCode (6), Codex
sglang:  General, Log, Check, Test, Monitor (6), OpenCode (6), Codex
vllm:    General, Log, Check, Test, Monitor (6), OpenCode (6), Codex

Sesiones existentes: harness, llama, sglang, vllm. La ventana harness tiene el typo visible Monitior; no se corrigió. llama es la referencia activa y no debe cerrarse ni reutilizarse para instalar runtimes.

5. Moshi-hook: estado y pasos de activación

Estado observado

Instalación oficial de referencia (no ejecutada): curl -fsSL https://getmoshi.app/install.sh | sh; servicio Linux moshi-hook service install; verificación moshi-hook service status. La documentación oficial explica que el daemon mantiene el socket local, gateway 127.0.0.1:24543 y WebSocket de Moshi: Install moshi-hook. La unidad existente es una instalación manual/gestionada de systemd; no instalar encima sin una decisión explícita.

Comprobaciones sin cambio de estado:

/home/lab/.local/bin/moshi-hook version
/home/lab/.local/bin/moshi-hook status
/home/lab/.local/bin/moshi-hook probe
/home/lab/.local/bin/moshi-hook service status

moshi-hook install, pair, service install, update y uninstall son mutantes; no se ejecutaron.

6. DeepSeek Harness / DSH web profile

/home/lab/.dsh/profiles/web/package.json existe (1361 bytes), con nombre dsh-profile-web. No declara scripts, packageManager ni devDependencies; las dependencias reales están fijadas por el lockfile pnpm /home/lab/.dsh/profiles/web/pnpm-lock.yaml (lockfileVersion: '9.0', autoInstallPeers: false). Entre las versiones/specs observadas están dsh-hooks-plugin@0.2.15, dsh-opencode-provider@0.1.0, dsh-plugin@1.4.4, dsh-context@0.53.3, además de paquetes fijados a tarballs GitHub por commit (dsh-mcp-ui, dsh-see-image, dsh-single-terminal, sidebar y token-usage). No se imprimieron valores potencialmente sensibles.

La primera shell no cargaba NVM y por eso no encontraba Node. La verificación ampliada sí encontró NVM 0.40.3, Node 24.21.0, pnpm 12.4.2 y DSH 0.1.5-rc.2. Están bajo /home/lab/.nvm/versions/node/v24.21.0/bin. dsh --help respondió y documenta dsh --profile web o dsh web. La ausencia en el PATH de una conexión SSH no equivalía a que no estuvieran instalados.

En una máquina nueva, recupera esas versiones (no se reinstalaron en el host activo). Descarga e inspecciona primero el instalador de NVM:

mkdir -p /home/lab/installers
curl -fL https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh -o /home/lab/installers/nvm-install.sh
less /home/lab/installers/nvm-install.sh
bash /home/lab/installers/nvm-install.sh
source /home/lab/.nvm/nvm.sh
nvm install 24.21.0
nvm use 24.21.0
npm install -g pnpm@12.4.2 @deepseek-ai/dsh@0.1.5-rc.2 \
  @opencode/cli@2.0.5 @openai/codex@0.154.0
node --version
pnpm --version
dsh --version
dsh --help

La documentación NVM explica que se carga por shell. En una conexión no interactiva, carga nvm.sh o exporta el PATH versionado antes de diagnosticar paquetes inexistentes. No uses sudo npm con este NVM del usuario.

Instalación reproducible en una máquina nueva (no ejecutada en ia-lab):

mkdir -p /home/lab/.dsh/profiles/web
# Sólo en un perfil nuevo; no reemplazar un perfil con configuración propia.
test ! -e /home/lab/.dsh/profiles/web/package.json
cp /RUTA/AL/KIT/evidence/terminal/dsh-package.json /home/lab/.dsh/profiles/web/package.json
cp /RUTA/AL/KIT/evidence/terminal/dsh-pnpm-lock.yaml /home/lab/.dsh/profiles/web/pnpm-lock.yaml
cd /home/lab/.dsh/profiles/web
python3 - <<'PY'
import json
p = json.load(open("package.json"))
print(p["name"], sorted(p.get("dependencies", {})))
PY
pnpm install --frozen-lockfile
pnpm list --depth 0
dsh --profile web --help
# Arranque de la réplica; comprueba primero que su puerto esté libre:
dsh --profile web

Primero instala una versión de Node/pnpm compatible con la distribución DSH que se vaya a usar y conserva ambos archivos (package.json y pnpm-lock.yaml). --frozen-lockfile evita resolver versiones nuevas. Si pnpm informa scripts nativos bloqueados (por ejemplo node-pty), revisar el diff y ejecutar la aprobación de builds sólo de forma explícita; no convertir pnpm approve-builds en un paso automático. La presencia de un paquete en el lockfile no prueba que su binario nativo haya compilado.

7. OpenCode: configuración real frente a la documentación

/home/lab/bench/ornith/opencode-lab/env.sh apunta a un perfil aislado:

OPENCODE_CONFIG=/home/lab/bench/ornith/opencode-lab/config/opencode.json
OPENCODE_CONFIG_DIR=/home/lab/bench/ornith/opencode-lab/opencode.d
XDG_CONFIG_HOME=/home/lab/bench/ornith/opencode-lab/xdg-config
XDG_DATA_HOME=/home/lab/bench/ornith/opencode-lab/xdg-data
XDG_CACHE_HOME=/home/lab/bench/ornith/opencode-lab/xdg-cache
workspace=/home/lab/bench/ornith/opencode-lab/workspace

El JSON tiene $schema=https://opencode.ai/config.json, modelo local-ornith/ornith-local y provider local-ornith con:

name: Ornith 1.5 Local / llama.cpp
package: @opencode/ai/providers/openai-compatible
settings keys: apiKey, baseURL (valores no impresos)
model key: ornith-local

Hay una divergencia entre ejemplos/documentación disponibles y la CLI instalada; la configuración que realmente funciona en este perfil usa providers, package y settings. En una máquina nueva, confirma primero la versión de OpenCode y su esquema local; no mezcles fragmentos de versiones distintas.

Auditoría no destructiva del perfil:

cd /home/lab/bench/ornith/opencode-lab
source ./env.sh
opencode --version
python3 - <<'PY'
import json
p='/home/lab/bench/ornith/opencode-lab/config/opencode.json'; d=json.load(open(p))
print(d.get('$schema'), d.get('model'), list(d.get('providers', {})))
PY

La última línea evita imprimir secretos; no registres el entorno completo. El perfil local recuperado sí fue probado mediante un canario aislado y respondió correctamente; detalles en Agentes y MCP. Las credenciales personales de otros proveedores no forman parte del kit.

8. vLLM/SGLang y lo que realmente existe

Estado observado:

/home/lab/venvs/vllm    Python 3.12.3, vLLM 0.29.0, torch 2.13.0+cu130
/home/lab/venvs/sglang  Python 3.12.3, SGLang 0.5.19

Los binarios existen en /home/lab/venvs/vllm/bin/vllm y /home/lab/venvs/sglang/bin/sglang. El script histórico /home/lab/bench/ornith/vllm/setup.sh y su copia modular/vllm/baseline/setup.sh documentan sólo:

/home/lab/venvs/vllm/bin/pip install vllm-bnb-plugin==0.0.3
/home/lab/venvs/vllm/bin/pip check
# sanity: import torch, vllm, bitsandbytes y contar GPUs

El log correspondiente registra vLLM 0.29.0, torch 2.13.0+cu130, bitsandbytes 0.50.2 y una RTX 3090 visible. Sigue la instalación de la réplica en el manual principal, manteniendo intacto el entorno activo.

Fuentes oficiales actuales: instalación GPU de vLLM y instalación SGLang. Ambas cambian con CUDA/Python; para una máquina nueva fijar versión, GPU, driver y wheel antes de instalar. La guía actual de SGLang menciona CUDA 13 y que 0.5.19 fue la última rama CUDA 12; esto hace que el venv observado sea especialmente importante de preservar.

9. llama.cpp / FAALL

/opt/llama.cpp existe y su commit es exactamente:

82490b9d43954a82d659890a2d6c74dd68cf5653

Binaries observados:

/opt/llama.cpp/build/bin/{llama-cli,llama-server,llama-bench}
/opt/llama.cpp/build-faall-native/bin/{llama-cli,llama-server,llama-bench}

El historial APT está disponible en /var/log/apt/history.log. La instalación observada registra cuda-toolkit-13-0, libnccl2=2.28.9-1+cuda13.0 y libnccl-dev=2.28.9-1+cuda13.0; el inventario recuperado del operador también registra nvidia-driver-580. Son prerrequisitos del host auditado, no una receta universal: validar driver, GPU y repositorio antes de repetirlos. No apareció llama-cuda-faall.Dockerfile en /home/lab, /opt/llama.cpp ni /tmp. Sí existen:

/home/lab/bench/ornith/bench-faall-matrix.sh
/home/lab/bench/ornith/bench-faall-phase1b.sh
/home/lab/bench/ornith/LAST_FAALL_BUILD

El marcador contiene faall-build-20260917T145112Z. Los scripts refieren a la imagen lomelidev/llama.cpp:cu130-nccl-sse-faall-10974, usan Docker, GGML_CUDA_GRAPH_OPT=1 y crean salidas bajo $HOME/bench/ornith/...; no se iniciaron ni se inspeccionaron logs de contenedor.

La documentación oficial de instalación de llama.cpp ofrece binario, Docker y build desde fuente: llama.app Installation. Para este host no sustituye el build verificado: el commit y los binarios locales deben permanecer intactos hasta que exista una comparación funcional.

10. Receta reinstalable de máquina nueva (plan, no ejecutado)

  1. Instalar/validar SSH y entrar con la clave del operador; comprobar hostname, usuario y GPU.
  2. Instalar Herdr desde su fuente oficial, fijando release; validar herdr --version. El servidor debe arrancar como servicio de usuario y el cliente debe conservar un workspace; usar herdr status server, herdr session list y herdr session attach <nombre>.
  3. Instalar moshi-hook desde la guía oficial, instalar el servicio de usuario y comprobar moshi-hook service status, moshi-hook status y moshi-hook probe. El pairing requiere un valor privado: usar moshi-hook pair --token <MOSHI_PAIRING_TOKEN> sólo con el token entregado fuera de documentación; nunca escribir el token real en este manual, historial compartido o captura de panel.
  4. Crear sesiones tmux vacías y separadas con terminales-examples/recreate-tmux-sessions.sh dentro del kit. Usa replica-llama, replica-harness, replica-sglang y replica-vllm; no reutiliza ni cierra llama. El ejemplo crea ventanas, pero no arranca servidores, descarga pesos ni ejecuta benchmarks.
  5. Si se desea el teclado histórico, usar el fragmento mínimo tmux-minimal.conf.example con prefix C-a; probar Ctrl-A d y confirmar que el proceso sigue vivo. Guardar el /home/lab/.tmux.conf histórico como referencia y no reemplazarlo automáticamente.
  6. Crear venv separados para SGLang/vLLM, fijar CUDA/Python y ejecutar pip check/import smoke test antes de descargar pesos. Repetir únicamente paquetes compatibles con la GPU y el driver; el host auditado conserva versiones concretas, no una garantía portable.
  7. Instalar el perfil DSH con pnpm install --frozen-lockfile desde su package.json/pnpm-lock.yaml; revisar builds nativos bloqueados antes de aprobarlos. No asumir que una lista de dependencias equivale a una UI o hook operativo.
  8. Compilar o recuperar llama.cpp en /opt/llama.cpp con commit explícito; registrar hash de binarios y GPU backend. El historial CUDA/NCCL del host sirve como evidencia de prerequisitos, no como comando universal.
  9. Configurar OpenCode con OPENCODE_CONFIG y OPENCODE_CONFIG_DIR absolutos; mantener las claves reales fuera del manual. El endpoint local sin autenticación está documentado en el perfil de ejemplo.
  10. Sólo después hacer pruebas de endpoint, streaming y tool calling con un modelo pequeño; luego Ornith con la matriz de calidad/VRAM/contexto. Un proceso activo o un panel visible no prueba la ruta completa.

Crear sesiones vacías sin lanzar workloads

El script de ejemplo funciona en modo simulación por defecto (DRY_RUN=1). Para crear sólo sesiones tmux vacías, sin ejecutar modelos ni scripts de servicio, revisar su salida y usar DRY_RUN=0. Omite una sesión que ya existe para no modificar la referencia histórica:

DRY_RUN=1 bash terminales-examples/recreate-tmux-sessions.sh
# tras revisar la salida:
DRY_RUN=0 bash terminales-examples/recreate-tmux-sessions.sh
tmux list-sessions
tmux list-windows -a -F '#{session_name}:#{window_name}'

El layout histórico observó ventanas General, Log, Check, Test, Monitor, OpenCode y Codex en las sesiones principales, con varios panes en algunas ventanas. Los nombres no prueban el comando que corría dentro de cada pane; el ejemplo crea una ventana vacía por nombre y deja cualquier layout de panes para una decisión posterior.

Criterio de “instalado”

which/--version sólo prueba un binario. Para declarar una integración operativa hay que probar, en orden: proceso, socket/gateway, attach/detach, evento de hook, endpoint OpenAI-compatible, streaming y una tarea mínima. Separar cada fallo y conservar el estado existente.