Instalar DeepSeek Harness (dsh)

Requisitos previos

Necesitas Node.js. El repositorio declara un rango de engines de ^22.19 || >=24, así que un runtime más antiguo se negará a instalar o fallará después de formas que parecen un fallo del harness. Comprueba qué tienes antes de empezar:

node -v

Para la vía de npx, esa es toda la lista de requisitos. Si quieres compilar desde el código fuente también necesitas git y pnpm, el gestor de paquetes para el que está preparado el repositorio. En ninguna parte de esta página se te pide instalar dsh a nivel de sistema, y mientras la vista previa se mueva tan rápido, una versión fijada a un proyecto es más fácil de razonar que un binario global que instalaste y olvidaste.

Inicio rápido con npx

Un solo comando te deja un harness en marcha con su interfaz web:

npx @deepseek-ai/dsh web

npm descarga el paquete y el harness sirve su interfaz web en http://127.0.0.1:3080. Esa dirección es de bucle local: responde en tu máquina y en ningún otro sitio, que es el valor por defecto correcto para una herramienta capaz de leer tus archivos y ejecutar comandos.

La CLI también acepta una opción --profile —dsh --profile <profile>— que selecciona el conjunto de plugins que se carga al arrancar. Entre los perfiles incluidos está headless. Ejecuta dsh --help contra tu propia versión en lugar de fiarte de una lista escrita un día después del lanzamiento: los perfiles y conjuntos disponibles son exactamente el tipo de cosa que una vista previa reorganiza entre versiones.

Ejecutar desde el código fuente

Compilar desde el repositorio merece los minutos extra si piensas escribir un plugin, porque puedes leer las API reales de los paquetes en lugar de deducirlas de un README:

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

Ejecuta la compilación antes del primer pnpm dsh web: la secuencia documentada lo da por hecho. Llegas a la misma interfaz web en el puerto 3080, pero ahora contra el árbol de trabajo, así que puedes parchear un paquete, recompilar y ver el resultado. También es la forma más rápida de averiguar qué cambió realmente en una versión, ya que una vista previa que se mueve tan deprisa tiende a adelantar a su propia documentación.

Dónde encaja cordis.yml

La idea organizadora de dsh es que todo es un plugin. Modelos, herramientas, skills, sesiones, sandboxes, sistemas de archivos, el bucle del agente, la orquestación y la interfaz de usuario son todos plugins cargados en un runtime compartido. Ese runtime es Cordis, el metaframework sobre el que se construye el harness; @deepseek-ai/cordis es una peer dependency de todos los paquetes del harness.

Qué plugins se cargan, y con qué opciones, lo decide una configuración de loader cordis.yml:

# cordis.yml
plugins:
  dsh-example-plugin:

Cada clave bajo plugins: nombra un plugin; el bloque de debajo es su configuración, o nada en absoluto si los valores por defecto sirven. Los paquetes oficiales se publican como @deepseek-ai/dsh-<name>, y la clave del loader suele ser el nombre del paquete sin el scope de npm. A veces los autores de plugins eligen otra clave, así que el README del plugin que vayas a añadir manda sobre cualquier regla general, incluida esta.

Añadir un plugin de la comunidad

Añadir un plugin son dos pasos: instalar el paquete y luego registrarlo en tu configuración de loader.

npm install dsh-example-plugin

# cordis.yml
plugins:
  dsh-example-plugin:

Reinicia el harness y el plugin se carga junto con todo lo demás. Para encontrar algo que merezca la pena instalar, explora los 7900 repositorios indexados o acota por categoría. De ellos, 3942 están verificados: significa que encontramos una dependencia del runtime de Cordis o un cordis.yml en el repositorio, así que se cargarán de verdad. El resto lleva un topic dsh-plugin en GitHub sin nada detrás, lo cual importa porque ese topic es también el mecanismo de descubrimiento: si publicas un plugin, ponerle el topic es la forma de que el ecosistema te encuentre.

Resolución de problemas

La instalación falla con un error de engine o de sintaxis

Casi siempre es un Node.js antiguo. El repositorio requiere ^22.19 || >=24; por debajo de eso la instalación puede fallar o lanzar un error de análisis en lo profundo de una dependencia, lo que parece un paquete roto pero no lo es. Comprueba node -v y actualiza: un gestor de versiones como nvm o fnm es la vía menos disruptiva si otros proyectos de la máquina necesitan runtimes más antiguos.

El puerto 3080 ya está en uso

Algo más está ocupando el puerto, a menudo una ejecución previa de dsh que nunca terminó. En macOS o Linux, localízala con:

lsof -i :3080

Detén ese proceso y vuelve a arrancar. Si prefieres mover el harness en lugar del otro servicio, consulta dsh --help y las opciones del plugin web en tu cordis.yml en vez de adivinar el nombre de una opción: la superficie de opciones de la vista previa todavía está cambiando, y una opción que funcionaba en una entrada de blog la semana pasada puede no existir en tu compilación.

La semana pasada funcionaba y ahora no

Este es el modo de fallo esperable de una vista previa para desarrolladores, no un misterio. El README dice sin rodeos que vienen cambios que rompen la compatibilidad, y un plugin construido sobre un formato de loader antiguo puede dejar de cargarse en silencio tras actualizar el harness. Ayudan dos hábitos: fijar la versión con la que probaste y comprobar cuándo fue el último push de un plugin antes de culpar a tu propia configuración; nuestras fichas muestran esa fecha en cada página de plugin.

npx @deepseek-ai/dsh@<version> web

Cuando algo está realmente roto y no solo renombrado, el proyecto mantiene GitHub Discussions y un Discord, y ambos están más al día de lo que puede estarlo cualquier guía de terceros en una semana como esta.

Preguntas frecuentes

¿Tengo que instalar dsh globalmente?

No. El inicio rápido con npx descarga y ejecuta el paquete bajo demanda, y la vía desde el código fuente ejecuta la CLI a través de pnpm dentro del repositorio clonado. Como la vista previa publica cambios que rompen la compatibilidad, una versión fijada por proyecto envejece mejor que un binario global que instalaste y olvidaste.

¿DeepSeek Harness es gratuito?

El harness en sí es código abierto bajo licencia MIT, así que puedes ejecutarlo, modificarlo y redistribuirlo sin coste. El modelo al que lo apuntes es otro asunto, y lo que cobre ese proveedor no lo cubre la licencia del harness.

¿Por qué la interfaz web escucha en 127.0.0.1 y no en mi dirección de red?

Esa dirección es de bucle local, es decir, la interfaz solo responde en la máquina que la arrancó. Nada de tu red local puede llegar a http://127.0.0.1:3080 salvo que pongas deliberadamente un proxy o un túnel delante, lo cual es un valor por defecto sensato para una herramienta que puede ejecutar comandos en tu máquina.

¿Puedo usar dsh hoy para trabajo en producción?

No de forma segura. DeepSeek Harness es una vista previa para desarrolladores publicada el 13 de agosto de 2026, y su README advierte en mayúsculas de que habrá cambios que rompan la compatibilidad. Trátalo como algo con lo que experimentar y para lo que escribir plugins, no como infraestructura que pondrías en una guardia de incidencias.

¿Qué es exactamente cordis.yml?

Es la configuración de loader que decide con qué plugins arranca tu harness y cómo se configura cada uno. Como dsh trata modelos, herramientas, skills, sesiones, sandboxes e incluso la interfaz como plugins, cordis.yml es en la práctica la definición de lo que tu instalación puede hacer.

Qué leer después

Si el modelo de plugins te resulta nuevo, empieza por qué es realmente un harness de agente: explica por qué dsh pone tantas cosas detrás de una configuración de loader. Si estás sopesando dsh frente a una herramienta que ya usas, lo comparamos con Claude Code, incluidas las partes en las que dsh claramente todavía no está listo.