⏱ 5 min de lectura
Resumen rápido: Guía de instalación de DeepSeek Harness en español, con los comandos sacados de la documentación oficial del proyecto y no de vídeos. Incluye los dos pasos de configuración donde se atasca todo el mundo, cómo funcionan los plugins de la comunidad, y las advertencias que conviene leer antes de instalar nada: la de seguridad y la de tus datos del trabajo.
Qué es y para quién es
DeepSeek Harness es la base sobre la que montas un asistente de inteligencia artificial. No trae casi nada de serie: todo lo que sabe hacer se le añade en piezas sueltas, que ellos llaman plugins. El modelo, las herramientas, la memoria, la interfaz. Cambias la pieza que quieras.
180.000 personas lo han marcado como favorito en GitHub. Eso mide expectación, no que funcione.
Y ahora la parte que conviene leer antes de seguir. Está en fase de pruebas, y lo dicen ellos, no yo. En la portada del proyecto lo avisan en mayúsculas: van a cambiar cosas, y lo que hoy te funciona mañana puede dejar de funcionar sin avisar.
Si no programas, esta guía te sirve para trastear un sábado y entender hacia dónde va esto. No para montar nada de lo que dependa tu trabajo.
Antes de empezar: dos avisos que van primero
- No metas aquí nada del trabajo. Ni expedientes, ni nombres, ni datos de personas. Para que esto funcione hace falta una clave de un servicio externo, y lo que escribes sale de tu ordenador hacia un servidor que no es tuyo.
- En el ordenador de la oficina probablemente ni puedas. Sin permisos de administrador esto no se instala. No pelees con informática por un programa que estás probando: hazlo en tu equipo de casa.
- Los plugins son código de desconocidos. Lo explico más abajo, pero adelanto la idea: instalar un plugin es ejecutar el programa de otra persona en tu ordenador, con acceso a la carpeta que le hayas dado.
La instalación
Hace falta Node.js, y aquí está el primer sitio donde se atasca la gente: no vale cualquier versión. El proyecto pide Node 22.19 o superior, o de la 24 en adelante. Con una versión más antigua el comando falla nada más arrancar con un error que no dice nada útil.
Node.js no es un lenguaje que tengas que aprender: es un programa gratuito que se descarga de nodejs.org. Coge la versión LTS, el botón grande. Si ya lo tenías instalado de hace tiempo, instala encima: no hay que desinstalar nada.
El comando se escribe en la terminal. En Windows: tecla Windows, escribes cmd, Enter. Esa ventana negra de toda la vida. En Mac se llama Terminal.
Antes de nada: comprueba tu versión
Pega esto y pulsa Enter. Si te responde algo por debajo de v22.19, actualiza Node antes de seguir. Y después de instalarlo, cierra la ventana y abre una nueva: si no, sigue viendo la versión antigua.
El comando
Se copia, se pega en esa ventana y se pulsa Enter:
Qué pasa entonces
Arranca y te abre solo el navegador en http://127.0.0.1:3080. Esa dirección es tu propio ordenador, no una página web: la ventana es local y no la ve nadie más. Si prefieres que no te abra el navegador:
Los dos pasos donde se atasca todo el mundo
Instalarlo es la parte fácil. Recién abierto no puedes hacer nada todavía, y aquí es donde la gente cierra la ventana pensando que lo ha hecho mal.
Uno. La clave del modelo
Vas a Settings → Models, pegas una clave de la API de DeepSeek y le das a guardar. En cuanto guardas, queda operativo sin reiniciar nada. La clave se saca registrándose en platform.deepseek.com.
Y aquí está el detalle que desmonta unos cuantos titulares: necesitas esa clave. El programa es libre, pero el modelo que lo mueve es un servicio externo con su propia tarifa. Míratela antes. Los vídeos que dicen «gratis y sin límites» se olvidan de mencionarlo.
Dos. La carpeta de trabajo
Escribes y no pasa nada. No está roto ni lo has instalado mal: te falta esto.
Abre la terminal dentro de la carpeta con la que quieras trabajar y lanza el comando ahí. Luego pulsa Choose workspace, añade esa carpeta y selecciónala. Son tres cosas, no una.
Hasta que no las haces las tres, el cuadro de texto está muerto. Y no lo digo yo: lo dice su documentación.
Y ya le puedes pedir algo
Abres una sesión y le mandas una tarea. Puede leer y editar los ficheros de esa carpeta, ejecutar comandos y organizarse el trabajo solo. Antes de hacer nada que requiera permiso, te pregunta.
Los plugins de la comunidad
Esta es la razón de ser del proyecto: la gente publica piezas y tú montas las que te interesen.
Dónde están
En GitHub, bajo la etiqueta dsh-plugin: github.com/topics/dsh-plugin. El propio proyecto pide a quien publique un plugin que le ponga esa etiqueta para que se encuentre.
Y aquí va el aviso importante. Esa etiqueta se la pone cada autor a su propio repositorio. No hay revisión de nadie, no es una tienda con control de calidad. Instalar un plugin es ejecutar código de un desconocido en tu ordenador, con acceso a la carpeta que le has dado. Mira quién lo firma antes de instalarlo, o no lo instales.
Qué necesitas además
Para los plugins hace falta otra herramienta llamada pnpm, porque el comando se apoya en ella por debajo. Se instala una sola vez:
Cómo se instala un plugin
Sustituye usuario/repositorio por lo que ves en la dirección del proyecto en GitHub, justo después de github.com. Nada más.
Dónde se gestionan
Desde la propia interfaz, en Settings → Plugins.
Por qué no lo he metido en mi trabajo
La idea de fondo me parece la correcta. Llevamos dos años usando la inteligencia artificial como una caja cerrada: entras, escribes, sale. Que puedas cambiar el motor sin cambiar el resto es lo que permitirá que esto se adapte a cómo trabaja cada uno, en vez de al revés.
Pero no lo he metido en mi sistema y no lo voy a hacer todavía. No porque esté mal hecho. Porque cuando un proyecto avisa de que va a romper compatibilidad, la rompe. Y reconstruir lo que ya me funciona cada tres semanas no es trabajar: es hacer de mantenimiento gratis.
Si te apetece trastear un sábado, adelante. Si buscas algo que funcione el lunes en la oficina, espera unos meses.
Resumen
Para tenerlo a mano:
| Qué quieres hacer | Cómo |
|---|---|
| Comprobar tu versión de Node | node -v (hace falta 22.19+ o 24+) |
| Instalar y abrir | npx @deepseek-ai/dsh web |
| Abrir sin navegador | npx @deepseek-ai/dsh web –no-open |
| Preparar los plugins | npm install -g pnpm |
| Instalar un plugin | npx @deepseek-ai/dsh plugin –profile web add github:usuario/repositorio |
| Configurar el modelo | Settings → Models (clave de platform.deepseek.com) |
| Elegir carpeta | Choose workspace → añadir → seleccionar |
| Gestionar plugins | Settings → Plugins |
Esta guía tiene fecha de caducidad
Los comandos de aquí están comprobados el 21 de agosto de 2026 contra el repositorio oficial del proyecto, no contra vídeos ni contra artículos de terceros.
Pero DeepSeek Harness está en fase de pruebas y su documentación avisa de que las interfaces y los plugins van a seguir cambiando. Si lees esto dentro de unos meses y algo no te cuadra, fíate del repositorio oficial antes que de mí.
Preguntas frecuentes
Me sale «does not provide an export named ‘parseEnv’». ¿Qué hago?
Tu Node.js es demasiado antiguo. Ese error sale con la versión 20 y anteriores. El proyecto necesita la 22.19 o superior, o la 24 en adelante. Descarga la versión LTS de nodejs.org, instálala encima de la que tienes, cierra la ventana de comandos y abre una nueva. Comprueba con «node -v» que ya te dice la versión nueva y vuelve a lanzar el comando.
¿Necesito saber programar?
Para instalarlo no: es copiar un comando. Para sacarle partido de verdad, sí. El proyecto está pensado para gente que construye asistentes, y su documentación es de programador de principio a fin.
¿Funciona en Windows?
Sí. Necesitas Node.js instalado y escribir el comando en la ventana de cmd. El procedimiento es el mismo en Windows, Mac y Linux.
¿Puedo usar otro modelo que no sea DeepSeek?
La documentación oficial menciona que admite otros proveedores y puntos finales compatibles con OpenAI, pero solo detalla la configuración de la clave de DeepSeek. Si quieres usar otro, tendrás que buscar en su documentación técnica.
¿Por qué no me deja escribirle nada?
Casi seguro que te falta la carpeta de trabajo. Pulsa «Choose workspace», añade la carpeta desde la que arrancaste el programa y selecciónala. Son tres acciones y hay que hacer las tres: el cuadro de texto no se activa hasta la última.
¿Es seguro instalar plugins de la comunidad?
Depende de quién los firme. La etiqueta de GitHub no es un catálogo revisado: se la pone cada autor a su propio repositorio. Instalar uno es ejecutar código ajeno en tu ordenador con acceso a la carpeta que le has dado. Trátalo con el mismo cuidado con el que descargarías un programa de una web desconocida.
¿Merece la pena ahora mismo?
Para trastear y entender por dónde van los tiros, sí. Para montar algo de lo que dependa tu trabajo, no todavía: el propio proyecto avisa de que romperá compatibilidad.
El resumen
Instalar es un comando. Lo que cuesta son los dos pasos de después: la clave de la API y elegir carpeta. Los plugins están en la etiqueta dsh-plugin, si llegas hasta ahí, y con el cuidado de saber quién los firma.
Dentro de un año esta herramienta se llamará de otra manera. La idea se queda: elegir tú las piezas en lugar de tragar con la caja cerrada que te dan hecha.
Un sistema más. Un día más.
Recursos relacionados
- 📩 Newsletter semanal con las mejores herramientas de IA que pruebo cada semana
- 💬 Canal de Telegram con noticias diarias de IA
- 👥 Grupo de Telegram Diario Vida IA
Un sistema más. Un día mejor.
- ✅ Tips de IA práctica cada semana
- ✅ Sistemas de constancia de 500+ días
- ✅ Herramientas probadas (no teoría)