— Instalacion

De la key a tu primer agente, en 5 minutos

Esta guia está pensada para que no te pierdas. Vas a hacer 3 cosas: descargar el cliente, abrir una terminal, y conectar tu key. Si algo no sale como esperas, mas abajo hay una seccion de problemas comunes con la solucion.

i
Antes de empezar, ten a mano:
  • Tu license key — formato DARK-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX. Llego al email o al chat de Telegram que diste al pagar.
  • Una terminal (te enseñamos a abrirla abajo).
  • Conexion a internet — el cliente valida la key contra el servidor al conectarla.
★
¿Ya tienes dark-agents? Esto es lo nuevo en v1.0.1 (2026-06-22):
  • Hotfix post-deploy: 6 bugs críticos corregidos en landing (releases roto, URL API obsoleta, bundle v0.1.0 stale, Apple App Store 404, conteos 88/37/12 vs 92/40/8)
  • Localización completa de voseo Argentino a Español neutro colombiano (30+ strings)
  • TDD verification: 141 tests pasan al 96.6% en producción

Para actualizar: reemplazá el binario viejo con el nuevo (mismo path), y ejecuta dark-agents /connect DARK-XXXX-... para re-validar. Tu license key sigue siendo la misma. Ver changelog completo →

0Como abrir la terminal

Si nunca has usado la terminal, no te preocupes. Es una ventana de texto donde escribes comandos. El cliente dark-agents se usa desde ahi.

Windows

  1. Presiona la tecla Windows (la banderita) en tu teclado.
  2. Escribe PowerShell.
  3. Presiona Enter. Se abre una ventana azul con texto blanco.

Tambien funciona cmd (el simbolo del sistema clasico), pero PowerShell es mas moderno.

macOS

  1. Presiona Cmd + Espacio para abrir Spotlight.
  2. Escribe Terminal.
  3. Presiona Enter. Se abre una ventana con fondo blanco o negro.

Tambien la encontras en Aplicaciones > Utilidades > Terminal.

Linux

  1. Presiona Ctrl + Alt + T en la mayoria de las distros.
  2. Si no funciona, busca "Terminal" en tu menu de aplicaciones.

Cualquier terminal (gnome-terminal, konsole, xterm, alacritty) sirve.

1Descarga el cliente para tu sistema operativo

Haz click en el boton que coincida con tu equipo. Cada archivo pesa entre 30 y 70 MB.

Windows
dark-agents-windows-x64.zip
Windows 10 / 11 (64 bits)
macOS
dark-agents-darwin-arm64.zip
Apple Silicon (M1, M2, M3, M4)
macOS
dark-agents-darwin-x64.zip
Intel
Linux
dark-agents-linux-x64.tar.gz
Ubuntu, Debian, Fedora, Arch (x86_64)
!
Cómo se cual es mi sistema?
  • Windows: clic derecho en "Este equipo" o "Mi PC" → Propiedades → dice "Windows 10" o "Windows 11" y "64 bits".
  • macOS: click en el logo de Apple (arriba a la izquierda) → "Acerca de está Mac" → si dice "Chip M1/M2/M3/M4" es Apple Silicon, si dice "Intel" es Intel.
  • Linux: abre la terminal y escribí uname -m → si dice x86_64 es el de 64 bits.

2Extraé el archivo descargado

Descomprimi el archivo en una carpeta que recuerdes. Te recomendamos el Escritorio.

Windows

  1. Ve a la carpeta donde se descargo (normalmente Descargas).
  2. Clic derecho en el archivo .zip → "Extraer todo...".
  3. Elige como destino el Escritorio y da "Extraer".
  4. Se crea una carpeta nueva en el Escritorio con los archivos adentro.

macOS

  1. Andá a Descargas en Finder.
  2. Doble click en el archivo .zip. Se extrae solo.
  3. Aparece una carpeta con el mismo nombre al lado.

Linux

  1. Abre la terminal.
  2. Ve a la carpeta de descargas: cd ~/Descargas (o cd ~/Downloads).
  3. Ejecuta: tar -xzf dark-agents-linux-x64.tar.gz
  4. Se crea una carpeta dark-agents en la misma ubicacion.

3Abre la terminal EN LA CARPETA donde extrajiste el cliente

Este paso es clave. La terminal tiene que estar "adentro" de la carpeta que se creo al extraer. Si no, los comandos de abajo no van a funcionar.

Windows

  1. Ve a la carpeta extraida en el Explorador de archivos.
  2. Click en la barra de direccion de arriba (donde dice la ruta).
  3. Escribe powershell y presiona Enter.
  4. Se abre PowerShell ya parado en esa carpeta.

Alternativa: con la carpeta abierta, mantén presionada la tecla Shift y haz clic derecho en un espacio vacío → "Abrir ventana de PowerShell aquí".

macOS

  1. Ve a la carpeta extraida en Finder.
  2. Clic derecho en la carpeta → Servicios → "Nueva terminal en la carpeta".

Si no ves esa opción: abre Terminal normalmente (paso 0) y escribe cd y arrastra la carpeta desde Finder a la terminal. Presiona Enter.

Linux

  1. Abre la terminal.
  2. Escribe: cd y arrastra la carpeta desde tu explorador de archivos a la terminal.
  3. Presiona Enter.
?
Cómo se si estoy en la carpeta correcta?

En la terminal escribe este comando y mira el resultado:

ls      (macOS / Linux)
dir     (Windows PowerShell)

Deberias ver dos archivos: dark-agents (o dark-agents.bat en Windows) y el binario. Si ves eeres dos, estás en el lugar correcto.

4Activá tu licencia con la key

Este es el paso principal. El cliente valida tu key contra el servidor y te da un JWT (un token temporal) que se guarda en tu maquina.

En la terminal, escribe exactamente esto (cambiando DARK-XXXX-... por tu key real):

./dark-agents /connect DARK-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX

En Windows: el archivo se llama dark-agents.bat, asi que el comando es dark-agents.bat /connect ... (sin el ./).

v
Si todo sale bien, verás esto en la terminal: 
Conectando con el servidor...
  Server: https://emrc7gup7b.execute-api.us-east-1.amazonaws.com
  HW ID:  a1b2c3d4e5f6g7h8...

Conexión exitosa.

  Tier:      pro
  Bundle:    v1.0.0
  JWT expira: 2026-06-22T22:30:00.000Z

Listo. Ejecuta `dark-agents /list` para ver los agentes disponibles.

Si ves ese mensaje, ya estás conectado. Pasa al paso 5.

!
Posibles errores y como resolverlos:

1. "Falta DARK_AGENTS_SERVER": estás llamando al binario directo, no al launcher. Solución:

  • En Windows: usa dark-agents.bat /connect ... en vez de dark-agents-windows-x64.exe.
  • En macOS / Linux: usa ./dark-agents /connect ... en vez de ./dark-agents-darwin-arm64.

2. "Key rechazada: INVALID_KEY / License key not found": la key no está registrada o está mal copiada. Soluciones:

  • Verifica que la key este completa: DARK-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX (6 grupos de 4 caracteres).
  • Respeta las mayusculas exactamente como vienen en el email / chat de Telegram.
  • Si acabas de pagar, espera 5 minutos y volve a intentar (puede haber un delay en el registro).
  • Si pasaron mas de 10 minutos, escríbenos a owner@opitacode.com.

3. "Key rechazada: EXPIRED" — tu licencia vencio. Renova en tu cuenta o escríbenos.

4. "Key rechazada: HW_MISMATCH" — la licencia está atada a otra maquina. Si cambiaste de equipo, contactanos.

5. "No se pudo contactar al servidor" — sin conexion a internet o firewall corporativo bloqueando la salida a https://emrc7gup7b.execute-api.us-east-1.amazonaws.com. Prueba abrir esa URL en un navegador; si no carga, es un problema de red.

5Verificá que todo funciona

Ahora vamos a confirmar que el cliente reconoce tu sesión y lista los 92 agentes.

Comando 1: tu sesión

./dark-agents /whoami

Deberías ver:

Sesión activa:

  Tier:       pro
  Bundle:     v1.0.0
  Conectado:  2026-06-22T22:15:00.000Z
  JWT expira: 2026-06-22T22:30:00.000Z
  HW ID:      a1b2c3d4e5f6g7h8...
  License ID: lic_test_e2e

Comando 2: los agentes disponibles

./dark-agents /list

Verás una lista de 92 agentes agrupados por categoría (pentester, carder, fuzzer, reverser, osint, scrapper, llm-sec, markitdown, db2md).

Comando 3: prueba uno

./dark-agents dark-osint-domain example.com
./dark-agents dark-fuzzer-corpus ./samples
./dark-agents dark-pentester-recon target.com
v
Si los 3 comandos funcionan sin error, la instalacion está completa. Ya puedes usar todos los agentes desde la terminal. Ante cualquier duda, mira la seccion de problemas comunes abajo.

Problemas comunes y como resolverlos

Las preguntas que mas recibimos, con la solucion paso a paso.

Windows: "SmartScreen impidio el inicio de una aplicacion no identificada"

Windows a veces bloquea binarios que no estan firmados con un certificado de Microsoft. Es solo una advertencia, no un virus.

  1. Click en "Mas informacion".
  2. Aparece un boton que dice "Ejecutar de todas formas". Haz click ahi.

El binario NO está firmado todavia (cert code signing v0.2). Si te preocupa, puedes escanearlo con tu antivirus antes de ejecutarlo.

macOS: "dark-agents no se puede abrir porque proviene de un desarrollador no identificado"

macOS Gatekeeper bloquea binarios no firmados por defecto. Soluciones, de la mas facil a la mas tecnica:

  1. Clic derecho → Abrir (en vez de doble click). macOS te pregunta si estás seguro. Di que sí.
  2. Si eso no funciona, abre la terminal y ejecuta: xattr -d com.apple.quarantine dark-agents
  3. Si tampoco, ve a Preferencias del sistema → Seguridad y privacidad y da "Abrir de todas formas" en el mensaje que aparece.
macOS / Linux: "Permission denied" al ejecutar ./dark-agents

El binario necesita permiso de ejecucion. En la terminal, dentro de la carpeta del cliente:

chmod +x dark-agents
chmod +x dark-agents-darwin-arm64    (o el nombre del binario de tu plataforma)

Despues de esto, volve a correr el comando de activacion.

Windows: "dark-agents no se reconoce como un comando interno o externo"

PowerShell no encuentra el archivo. Posibles causas:

  1. No estás en la carpeta correcta. Vuelve al paso 3 y asegurate de haber abierto PowerShell "adentro" de la carpeta extraida.
  2. Escribiste el nombre mal. En Windows el archivo es dark-agents.bat (con .bat al final), no dark-agents.
  3. Estas en la carpeta equivocada. Ejecuta dir y mira si ves dark-agents.bat en la lista.
macOS / Linux: "No such file or directory"

El archivo no está donde pensabas. Verificaciones:

  1. Ejecuta ls en la terminal. Tienes que ver dark-agents y un archivo dark-agents-darwin-* o dark-agents-linux-x64.
  2. Si no los ves, no estás en la carpeta correcta. Vuelve al paso 3.
  3. Si los ves pero el error persiste, escribiste mal el nombre. Recordá: es ./dark-agents (con el ./ adelante).
El antivirus (Avast, Kaspersky, Windows Defender) bloqueo o elimino el binario

Algunos antivirus son agresivos con binarios nuevos que no tienen firma digital. El binario de dark-agents no es malware, pero el antivirus no lo sabe.

  1. Windows Defender: ve a "Proteccion contra virus y amenazas" → "Historial de proteccion" → busca el binario bloqueado → "Permitir en el dispositivo".
  2. Avast / AVG: Menu → Configuracion → Excepciones → Agregar el archivo a la lista de excepciones.
  3. Kaspersky / ESET: Configuracion → Amenazas y exclusiones → agregar el archivo.

Despues de la excepcion, volve a descargar el zip y extraerlo.

"Sin permieres de red" o "Connection refused"

El cliente no logra conectarse al servidor. El servidor está en https://emrc7gup7b.execute-api.us-east-1.amazonaws.com.

  1. Prueba abrir esa URL en un navegador. Si no carga, es un problema de tu red.
  2. Si estás en una red corporativa o educativa, el firewall puede estar bloqueando las llamadas HTTPS. Pedile al admin que permita el dominio.
  3. Si usas VPN, proba desconectarla.
  4. Proba con datos moviles (compartir desde el celular) para descartar que sea tu WiFi.

Si nada funciona, mandanos el resultado de ./dark-agents /diagnose a owner@opitacode.com y lo vemos.

Como desinstalo el cliente?

El cliente no se "instala" en el sentido tradicional: es solo un ejecutable en una carpeta. Para desinstalar:

  1. Borra la carpeta que se creo al extraer el zip.
  2. (Opcional) Tambien borra la carpeta de configuracion: ~/.dark-agents/ (Linux / macOS) o %USERPROFILE%\.dark-agents\ (Windows). Esto borra la sesion local.

La licencia en el servidor NO se cancela con esto. Si queres desvincular una maquina, contactanos.

Como cambio de maquina?

Tu licencia está atada a un maximo de maquinas segun tu tier. Para cambiar:

  1. En la maquina vieja: ejecuta ./dark-agents /disconnect.
  2. En la maquina nueva: seguí está guia desde el paso 4.

Si ya alcanzaste el maximo de maquinas y necesitas liberar un slot, contactanos a owner@opitacode.com.

Nada funciono?

Escríbenos y lo vemos juntos. Mientras mas info nos mandes, mas rapido te ayudamos.

1. Corré este comando y copiá el resultado:

./dark-agents /diagnose

2. Mandanos un email a owner@opitacode.com con:

Respondemos en menos de 24 horas habiles.