Arma tu propio Jarvis para que maneje tu negocio, en 9 pasos

Hazlo con ayuda de tu IA

No tienes que hacerlo solo. Pásale esta guía a tu asistente de IA y deja que te acompañe paso a paso.

• Lo mejor: un agente que trabaja en tu computadora, como Claude Code o Cowork (en la app de escritorio de Claude) o Codex (de OpenAI). Pueden ejecutar los comandos por ti, leer los errores y arreglarlos.
• Un chat normal también ayuda (Claude, ChatGPT o Gemini en el navegador). No puede ejecutar nada en tu computadora, pero te dice qué hacer y te explica cualquier error si le pegas lo que ves en pantalla.

Cómo pasarle la guía

1. Arriba en esta página toca Guardar PDF (o copia el enlace de la página).
2. Abre tu asistente, adjunta el PDF y pega el prompt de abajo.
3. Si no puedes adjuntar archivos, selecciona toda la guía (Cmd + A), cópialo y pégalo antes del prompt.

Lo que vas a hacer tú, aunque te ayude la IA

• Crear tus cuentas y pagar (Anthropic, Supabase, ElevenLabs, Google Cloud y el chip de WhatsApp).
• Pegar tus claves en la Terminal tú mismo.
• Escanear el código QR de WhatsApp con el celular de Jarvis.
• Aprobar en el navegador los permisos que piden Google y Supabase.

Prompt para que tu IA te acompañe:

Te adjunto la guía "Arma tu propio Jarvis para que maneje tu negocio, en 9 pasos". Quiero instalarlo en mi computadora y soy principiante: nunca usé la Terminal. Acompáñame así:

1. Vamos un paso de la guía a la vez. No pases al siguiente hasta que el "Comprueba que funciona" salga bien.
2. Antes de ejecutar algo o pedirme que lo ejecute, explícame en una frase simple qué hace.
3. Si puedes ejecutar comandos en mi computadora, hazlo tú, pero pídeme confirmación antes de instalar, borrar o cambiar cualquier cosa.
4. Cuando un paso dependa de mí (crear una cuenta, pagar, escanear un código, aprobar un permiso), dime exactamente dónde hacer clic y espera a que te confirme.
5. Nunca me pidas que te escriba claves o contraseñas en el chat. Dame el comando para que yo mismo las pegue en la Terminal.
6. Si algo falla, lee el error, explícame qué pasó en palabras simples y arréglalo antes de seguir.

Empieza preguntándome qué computadora tengo y qué cuentas ya tengo creadas.

Qué vas a armar

Piensa en tu Jarvis como una persona nueva en tu equipo. Necesita:

• Un lugar donde vivir: una computadora que esté siempre prendida (paso 1).
• Un cerebro: un modelo de IA como Claude, GPT o Grok (paso 2).
• Un cuerpo que haga cosas: Hermes Agent, un programa gratuito de Nous Research que convierte ese cerebro en un asistente que usa herramientas (paso 3).
• Saber de tu negocio, tener manos y memoria: tu información, tu correo, tu agenda, un navegador y una base de datos (pasos 4 a 6).
• Habilidades, voz y cara: procesos aprendidos, WhatsApp, voz y una interfaz propia (pasos 7 a 9).

Repositorio: github.com/NousResearch/hermes-agent

Documentación oficial: hermes-agent.nousresearch.com/docs

Antes de empezar

Qué necesitas

• Una Mac con chip de Apple (M1 o más nueva). Es el camino de esta guía porque ahí funciona todo: WhatsApp, voz en vivo, la palabra "Jarvis" y la interfaz. Para ver tu chip: menú de la manzana → Acerca de esta Mac → línea Chip.
• Una cuenta de Google (Gmail) para correo y calendario.
• Una tarjeta de crédito o débito que acepte pagos en dólares, para el modelo de IA.
• Un segundo número de WhatsApp para tu Jarvis (lo explicamos en el paso 8).
• De 2 a 3 horas. Puedes hacerlo en varios días: cada paso queda guardado.

Cuánto cuesta

• Hermes Agent: gratis.
• Modelo de IA (Claude por API): pagas por uso. Carga 5 o 10 dólares para empezar y mira cuánto gastas la primera semana. Si ya pagas ChatGPT, SuperGrok o Claude Max, también sirven (paso 2).
• Supabase (memoria): gratis para empezar.
• Google (correo y calendario): gratis.
• ElevenLabs (voz): tiene plan gratis para probar; para usar las mejores voces de su biblioteca necesitas su plan de pago más barato.
• Chip prepago para WhatsApp: un pago único, normalmente entre 5 y 15 dólares.
• Claude Code (paso 9): necesitas un plan de pago de Claude (Pro o superior).
• Palabra "Jarvis" con Picovoice (bonus): tiene nivel gratuito.

Lo básico que vas a usar en toda la guía

Abrir la Terminal: la Terminal es una ventana donde le escribes órdenes a tu Mac. Presiona Cmd + Espacio, escribe Terminal y presiona Enter.

Pegar un comando: copia el texto del recuadro gris, haz clic en la Terminal, pega con Cmd + V y presiona Enter. Espera a que termine: sabrás que terminó cuando vuelva a aparecer la línea con tu nombre y el signo % al final.

Si te pide una contraseña: es la misma con la que entras a tu Mac. Mientras la escribes no se ve nada en pantalla, ni siquiera puntos. Es normal: escríbela y presiona Enter.

Detener algo que está corriendo: Ctrl + C.

Ver carpetas ocultas: Hermes guarda todo en una carpeta llamada .hermes dentro de tu carpeta personal. Las carpetas que empiezan con punto están ocultas. En Finder, presiona Cmd + Shift + . (punto) para verlas u ocultarlas.

Saber la ruta de un archivo: arrastra el archivo desde Finder hasta la ventana de la Terminal o del chat y aparece escrita su ruta completa.

Guardar tus claves: en esta guía vas a crear varias claves (API keys). Una API key es como una contraseña que conecta dos programas. Muchas se muestran una sola vez: guárdalas en tu gestor de contraseñas o en una nota con candado de tu Mac. Nunca las publiques ni las mandes por chat a nadie.

Paso 01Dale una casa

Tu Jarvis vive en tu Mac. Para que conteste a cualquier hora, la Mac no debe dormirse.

1. Abre Ajustes del Sistema → Energía (en MacBook: Batería → Opciones).
2. Activa Evitar el reposo automático cuando la pantalla esté apagada (en MacBook: la misma opción, "cuando esté conectado al adaptador de corriente").
3. Si aparece, activa también Encender automáticamente tras un corte de luz.
4. Deja la Mac conectada a la corriente y a internet. La pantalla sí puede apagarse.

Lo ideal: una Mac mini dedicada solo a tu Jarvis. Es pequeña, silenciosa y gasta poca luz. Si usas tu Mac de trabajo, también sirve: solo no la apagues.

Comprueba que funciona: deja la Mac sola 30 minutos con la pantalla apagada. Al volver, debe seguir encendida y conectada a internet, sin haberse dormido.

Paso 02Elige el modelo

El modelo es el cerebro. Hermes no trae uno propio: tú eliges cuál usa y lo puedes cambiar cuando quieras sin perder nada.

• Claude (Anthropic): el que recomendamos para manejar correo y contratos. Se conecta con una API key (abajo te explicamos cómo) o con tu plan Claude Max.
• GPT (OpenAI): con tu suscripción de ChatGPT o Codex.
• Grok (xAI): con una API key de xAI o con tu suscripción SuperGrok.
• OpenRouter: una sola API key para probar casi cualquier modelo.

Cómo sacar tu API key de Claude

1. Entra a console.anthropic.com y crea tu cuenta (puedes usar tu cuenta de Google).
2. Ve a Billing (o Plans & Billing) y carga saldo con Buy credits. Con 5 o 10 dólares alcanza para empezar.
3. Ve a API Keys → Create Key, ponle de nombre jarvis y confirma.
4. Copia la clave (empieza con sk-ant-) y guárdala ya. No la vas a poder ver otra vez.

Comprueba que funciona: tienes la clave guardada y en Billing aparece saldo disponible.

Paso 03Instala Hermes Agent

1. Abre la Terminal.
2. Copia y pega este comando y presiona Enter:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

1. Espera. Descarga todo lo que necesita y puede tardar varios minutos. Si te pide la contraseña de tu Mac, escríbela (no se ve) y presiona Enter.
2. Al terminar, el instalador te hace unas preguntas de configuración. Cuando pregunte por el proveedor del modelo, elige Anthropic, pega tu API key con Cmd + V y elige un modelo de Claude de la lista (con las flechas del teclado y Enter). Si te pregunta por mensajería u otras herramientas, puedes saltarlo: lo haremos en los siguientes pasos.
3. Cierra la Terminal por completo (Cmd + Q) y vuelve a abrirla.
4. Abre el chat con tu Jarvis:

hermes --tui

Para salir del chat escribe /quit. Para volver a entrar, el mismo comando de arriba.

Comprueba que funciona: dentro del chat pega este mensaje (cambiando los corchetes) y presiona Enter.

Busca en internet los tres negocios más parecidos al mío en mi ciudad y resúmeme qué venden y a qué precio. Mi negocio es [describe tu negocio] en [tu ciudad].

Si responde con información real de internet, la base funciona. Si sale un error, sal del chat y corre hermes doctor: te dice qué falta.

Paso 04Enséñale cómo funciona tu negocio

Hermes lee un archivo llamado SOUL.md (su "alma") al empezar cada conversación, ya sea en la Terminal o en WhatsApp. Ahí le dices quién es, cómo habla y cómo funciona tu negocio. Además, guarda solo lo que aprende de ti en su memoria.

1. En la Terminal (fuera del chat), abre el archivo con el comando de abajo. Se abre en TextEdit.
2. Selecciona todo (Cmd + A) y bórralo.
3. Copia la plantilla, pégala y cambia todo lo que está entre [corchetes] por tus datos.
4. Guarda con Cmd + S y cierra TextEdit.
5. Si tenías el chat abierto, sal con /quit y vuelve a entrar con hermes --tui. Los cambios se leen al empezar cada conversación.

open -e ~/.hermes/SOUL.md

Plantilla de SOUL.md:

# Quién eres
Eres Jarvis, el asistente personal de [tu nombre] y su mano derecha en [nombre del negocio]. Hablas en español, eres directo, breve y proactivo. Si algo es urgente, lo dices primero.

# El negocio
- Qué vendemos: [productos o servicios y precios]
- A quién: [cliente ideal]
- Canales: [Instagram, WhatsApp, web, tienda física]
- Herramientas: [Gmail, Google Calendar, Sheets, sistema de facturación]
- Horario y zona horaria: [ej. lunes a viernes, 9 a 18, hora de Ecuador]

# Cómo trabajas
- Antes de enviar un correo, agendar algo con otra persona o borrar cualquier cosa, me muestras el borrador y esperas mi "sí".
- Nunca compartes datos de clientes con terceros.
- Si no sabes algo del negocio, me preguntas y lo guardas en tu memoria.
- Al terminar una tarea, me dices en una línea qué hiciste.

# Reglas fijas
- [ej. Nunca ofrezcas descuentos mayores al 10 %.]
- [ej. Las reuniones con clientes van solo martes y jueves.]

Prompt para que te entreviste y complete lo que falte:

Entrevístame para conocer mi negocio. Hazme preguntas de a cinco y espera mis respuestas. Quiero que al final sepas qué vendo, a quién, mis precios, mis procesos del día a día, mis clientes más importantes, cómo me gusta que me escriban y qué tareas te voy a delegar. Guarda en tu memoria todo lo importante y, al terminar, muéstrame un resumen de lo que aprendiste para corregirlo.

Comprueba que funciona: abre un chat nuevo y pregúntale "¿Quién eres y qué sabes de mi negocio?". Debe presentarse como Jarvis y contarte lo que le enseñaste.

Paso 05Conéctalo con tu correo, calendario y navegador

Hermes ya trae instalada la skill google-workspace, que conecta Gmail, Calendar, Drive, Docs y Sheets. Para usarla, Google te pide crear una "llave" propia. Es gratis, se hace una sola vez y toma unos 15 minutos la primera vez. Ve con calma: los nombres de los menús pueden variar un poco, pero el orden es siempre el mismo.

5.1 Crea tu llave en Google Cloud

1. Entra a console.cloud.google.com con tu cuenta de Google y acepta las condiciones si te las pide.
2. Arriba a la izquierda, haz clic en el selector de proyectos → Proyecto nuevo. Nómbralo Jarvis → Crear. Espera unos segundos y asegúrate de que quedó seleccionado arriba.
3. En el buscador de arriba escribe Gmail API, ábrela y haz clic en Habilitar. Repite lo mismo con Google Calendar API.
4. En el buscador escribe Google Auth Platform (o ve a APIs y servicios → Pantalla de consentimiento de OAuth) y haz clic en Comenzar. Llena: nombre de la app Jarvis y tu correo como correo de asistencia → Siguiente. En Público elige Externo → Siguiente. Pon tu correo de contacto → Siguiente. Acepta la política → Crear.
5. Entra a Público → Usuarios de prueba → Agregar usuarios, escribe tu Gmail y guarda. Sin esto, Google te va a bloquear.
6. Ve a Clientes (o Credenciales) → Crear cliente (o Crear credenciales → ID de cliente de OAuth). En tipo de aplicación elige App de escritorio, nómbrala Jarvis → Crear.
7. En la ventana que aparece, haz clic en Descargar JSON. Se guarda un archivo que empieza con client_secret en tu carpeta Descargas.

5.2 Entrégale la llave a Jarvis

Abre el chat de Hermes y pega este prompt. Antes de enviarlo, arrastra el archivo client_secret desde Descargas hasta la ventana para que se escriba su ruta al final.

Configura la skill de Google Workspace para que puedas leer y responder mi correo y manejar mi calendario. Pide solo los permisos de email y calendar. Ya tengo el archivo de credenciales de escritorio, la ruta es:

5.3 Autoriza el acceso

1. Jarvis te va a dar un enlace largo. Ábrelo (Cmd + clic) y elige tu cuenta de Google.
2. Si sale "Google no verificó esta app", es normal: la app es tuya. Haz clic en Configuración avanzada → Ir a Jarvis y acepta los permisos.
3. Al final el navegador dice que no se puede acceder al sitio o algo parecido. También es normal. Copia la dirección completa de la barra de arriba (empieza con http://localhost) y pégasela a Jarvis en el chat.
4. Jarvis termina la conexión y te confirma. Desde ahora la conexión se renueva sola.

5.4 Navegador

El navegador ya viene incluido: Hermes abre páginas, llena formularios y saca información con un navegador propio, separado de tu Chrome. No tienes que instalar nada.

Comprueba que funciona:

Revisa mi correo de hoy, dime qué necesita respuesta urgente y propón un borrador para cada uno. Después revisa mi calendario de mañana y avísame si hay choques de horario.

Paso 06Dale memoria persistente con Supabase

Hermes ya recuerda cosas en su memoria interna, pero tiene espacio limitado. Supabase le da una base de datos real: una especie de Excel en internet donde guarda clientes, pendientes y notas sin límite, y que tú también puedes abrir para ver qué guardó. Es gratis para empezar.

6.1 Crea tu proyecto

1. Entra a supabase.com → Start your project y crea tu cuenta.
2. Haz clic en New project. Nombre: jarvis. En Database Password haz clic en Generate a password y guárdala. En Region elige la más cercana a tu país → Create new project.
3. Espera uno o dos minutos hasta que el proyecto termine de prepararse.

6.2 Conéctalo a Jarvis

Supabase está en el catálogo oficial de Hermes, así que se conecta con un solo comando. Sal del chat y pega esto en la Terminal:

hermes mcp install supabase

Después abre el chat con hermes --tui y pídele "conéctate a Supabase". La primera vez se abre el navegador para autorizar: elige tu organización y aprueba el acceso. Si el navegador no se abre solo, pega hermes mcp login supabase en la Terminal. Al terminar, sal del chat con /quit y vuelve a entrar para que cargue las herramientas nuevas.

6.3 Crea su memoria

Prompt para crear las tablas:

Usa Supabase, en mi proyecto llamado jarvis, para crear tu memoria del negocio. Crea tres tablas: clientes (nombre, contacto, qué compra, notas), pendientes (tarea, fecha límite, estado) y notas (tema, contenido, fecha). Explícame en palabras simples qué vas a crear y espera mi "sí" antes de hacerlo.

Después abre tu SOUL.md como en el paso 4 (open -e ~/.hermes/SOUL.md), pega estas líneas al final y guarda, para que nunca se le olvide usarla:

# Memoria del negocio
- Tu memoria principal está en Supabase, proyecto jarvis, tablas clientes, pendientes y notas.
- Cada vez que te cuente algo de un cliente o te pida recordar algo, guárdalo ahí.
- Antes de responder sobre un cliente o un pendiente, consulta esas tablas.

Comprueba que funciona: dile "Anota que la clienta María Pérez quiere una cotización el viernes". Abre un chat nuevo y pregúntale "¿Qué pendientes tengo con María?". También puedes verlo tú: en Supabase, entra a tu proyecto → Table Editor → tabla pendientes.

Paso 07Súmale skills para tareas específicas

Una skill es un instructivo que le enseña a Jarvis a hacer un trabajo siempre de la misma forma, como el manual de procedimientos que le darías a un empleado nuevo. Hermes incluso crea skills solo cuando termina una tarea complicada.

Instala las tuyas

No tienes que crear carpetas ni archivos: pégale cada prompt en el chat y él la guarda.

Prompt para guardar la skill de contratos:

Guarda esta skill tal cual en ~/.hermes/skills/negocio/contratos/SKILL.md y confírmame cuando esté lista:

---
name: contratos
description: Redacta contratos de servicios, acuerdos de confidencialidad y propuestas firmables para mi negocio. Úsala cuando pida "hazme un contrato", "arma un acuerdo con este cliente" o "un NDA para X".
---

# Contratos

## Antes de redactar
Pregúntame lo que falte de esta lista: nombre y datos de ambas partes, servicio o producto, precio y forma de pago, plazos de entrega, duración, país y ciudad que rigen el contrato. Busca primero al cliente en la tabla clientes de Supabase.

## Cómo redactar
- Español claro, sin jerga innecesaria, cláusulas numeradas.
- Incluye siempre: objeto, precio y pagos, plazos, confidencialidad, terminación anticipada, qué pasa si alguien incumple y firmas.
- Usa las leyes del país que te indiqué; si no lo sabes, pregúntame.
- Marca en [corchetes] todo dato que no te di. No inventes cifras ni fechas.

## Al terminar
- Guarda el contrato como documento en mi Google Drive, en la carpeta Contratos.
- Resúmeme en 5 viñetas los puntos que más me conviene revisar.
- Recuérdame que es un borrador y que lo revise un abogado antes de firmar.

Prompt para guardar la skill de reportes:

Guarda esta skill tal cual en ~/.hermes/skills/negocio/reporte-semanal/SKILL.md y confírmame cuando esté lista:

---
name: reporte-semanal
description: Arma el reporte semanal de mi negocio con correos, reuniones, pendientes y clientes. Úsala cuando pida "el reporte de la semana", "cómo nos fue esta semana" o cada viernes si está programada.
---

# Reporte semanal

## Junta la información
- Calendario: reuniones de la semana y las de la próxima.
- Correo: conversaciones importantes con clientes y cualquier cosa sin responder hace más de 2 días.
- Supabase: pendientes vencidos, pendientes de la próxima semana y clientes nuevos.

## Escribe el reporte
1. Resumen en 3 líneas: cómo fue la semana.
2. Lo que se logró.
3. Lo que quedó pendiente y por qué.
4. Clientes que necesitan atención.
5. Las 3 prioridades de la próxima semana.

## Reglas
- Máximo una página. Viñetas cortas.
- No inventes números: si un dato no está, dilo.
- Mándamelo por WhatsApp y guarda una copia en Google Drive, en la carpeta Reportes.

Explora las que ya existen

Hermes tiene un catálogo de skills hechas por otros. Dentro del chat, escribe /skills browse para verlas, o /skills search seguido de un tema (por ejemplo /skills search facturas).

Comprueba que funciona: abre un chat nuevo y escribe /skills: deben aparecer contratos y reporte-semanal. Después pídele "Hazme un contrato de prueba para un cliente inventado" y mira cómo te hace las preguntas antes de redactar.

Paso 08Háblale por WhatsApp y dale voz

8.1 Consigue un número para Jarvis

Lo ideal es un número solo para él. Así tiene su propio chat, le escribes desde tu WhatsApp normal y no arriesgas tu cuenta personal.

1. Compra un chip prepago (no hace falta un plan).
2. Pon el chip en un celular viejo, o en tu celular si tiene doble SIM.
3. Instala WhatsApp (o WhatsApp Business, si es en tu mismo celular) y regístralo con ese número.
4. Ese celular debe quedarse con batería e internet: Jarvis se conecta a través de él.

8.2 Vincula WhatsApp con Jarvis

1. En la Terminal (fuera del chat) pega el comando de abajo.
2. Cuando pregunte el modo, elige bot. Aparece un código QR en la Terminal.
3. En el celular de Jarvis abre WhatsApp → Ajustes → Dispositivos vinculados → Vincular un dispositivo y escanea el QR.

hermes whatsapp

8.3 Dile a quién debe obedecer

Jarvis solo responde a los números que tú autorices. Pon tu número personal (no el de Jarvis), con código de país, sin el signo + ni espacios. En el ejemplo, 593 es el código de Ecuador: cámbialo por el tuyo.

hermes config set WHATSAPP_ENABLED true
hermes config set WHATSAPP_MODE bot
hermes config set WHATSAPP_ALLOWED_USERS 593991234567

8.4 Déjalo encendido siempre

Este es el paso que hace que Jarvis trabaje mientras duermes. Con estos comandos queda como un servicio de tu Mac: arranca solo cuando prendes la computadora y sigue funcionando aunque cierres la Terminal.

hermes gateway install
hermes gateway start

Para ver si está funcionando usa hermes gateway status. Cada vez que cambies una configuración (como en 8.3 o 8.6), reinícialo con hermes gateway restart.

8.5 Primer mensaje

1. Desde tu WhatsApp personal, escríbele al número de Jarvis: "Hola Jarvis, ¿estás ahí?".
2. Cuando te responda, escríbele /sethome en ese mismo chat. Así sabe que ahí te manda los reportes y las tareas programadas.
3. Prueba mandarle una nota de voz: la transcribe sola. Ya puedes dictarle tareas mientras manejas.

Comprueba que funciona: mándale "¿Qué tengo en mi agenda mañana?" desde WhatsApp. Si responde con tu calendario real, ya tienes un asistente en el bolsillo.

Ahora programa tu reporte semanal (desde el chat o desde WhatsApp):

Programa la skill reporte-semanal para que se ejecute todos los viernes a las 5 de la tarde y me mande el resultado por este WhatsApp.

8.6 Dale voz con ElevenLabs

1. Crea una cuenta en elevenlabs.io.
2. Abre Voices. En la biblioteca (Explore) escucha voces y elige una, por ejemplo una voz grave y calmada estilo Jarvis. Agrégala a My Voices. Algunas voces de la biblioteca solo funcionan con plan de pago.
3. En My Voices, abre el menú de la voz (los tres puntos) y elige Copy voice ID. Guárdalo.
4. Ve a Developers → API Keys (o tu perfil → API Keys) → Create API Key, ponle de nombre jarvis y copia la clave.
5. Pega estos comandos uno por uno en la Terminal, cambiando lo que está en mayúsculas por tus datos:

hermes config set ELEVENLABS_API_KEY TU_API_KEY
hermes config set tts.provider elevenlabs
hermes config set tts.elevenlabs.voice_id TU_VOICE_ID
hermes config set tts.elevenlabs.model_id eleven_multilingual_v2
hermes gateway restart

El modelo eleven_multilingual_v2 es el que suena natural en español.

Comprueba que funciona: por WhatsApp pídele "Respóndeme con un audio: ¿qué pendientes tengo hoy?". Te llega un audio con la voz que elegiste.

8.7 Háblale en vivo desde la Mac

Para conversar con Jarvis por micrófono, como en las películas, tu Mac necesita unos programas de audio. Se instalan con Homebrew, el "instalador de programas" de la Terminal.

1. Instala Homebrew pegando el primer comando de abajo. Te pedirá tu contraseña y que presiones Enter para confirmar.
2. Al terminar, Homebrew muestra una sección Next steps con dos o tres comandos. Cópialos y pégalos tal cual (sin ellos, la Terminal no reconoce brew). Después cierra y abre la Terminal.
3. Instala los programas de audio con el segundo comando.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

brew install portaudio ffmpeg opus

1. Abre el chat con hermes --tui y escribe estos dos comandos, uno por uno:

/voice on
/voice tts

1. Presiona Ctrl + B y habla. La primera vez tu Mac pregunta si la Terminal puede usar el micrófono: di que sí. Cuando te quedas en silencio 3 segundos, Jarvis responde en voz alta y vuelve a escucharte. Para terminar, di "stop".

Comprueba que funciona: pregúntale en voz alta "¿Cuál es mi primera reunión de mañana?" y escucha la respuesta.

Paso 09El toque Jarvis final: su propia interfaz

Ahora le das cara: una pantalla oscura con una esfera de luz que se mueve cuando habla, que te escucha y responde con la voz de ElevenLabs. La construye Claude Code, un asistente que programa por ti: tú le describes lo que quieres y él escribe todo el código.

9.1 Abre la puerta de Jarvis

Para que otra app pueda hablar con Jarvis, activa su servidor. En la segunda línea, cambia el texto en mayúsculas por una clave larga inventada por ti (por ejemplo, 20 letras y números al azar) y guárdala: la vas a usar en 9.3.

hermes config set API_SERVER_ENABLED true
hermes config set API_SERVER_KEY INVENTA-UNA-CLAVE-LARGA
hermes config set API_SERVER_CORS_ORIGINS http://localhost:3000
hermes gateway restart

9.2 Abre Claude Code

Necesitas un plan de pago de Claude (Pro o superior).

1. Descarga la app de escritorio de Claude desde claude.ai/download e inicia sesión.
2. Entra a la pestaña Code.
3. Crea una carpeta nueva en Documentos llamada jarvis-pantalla y elígela como carpeta de trabajo.

9.3 Pídele la interfaz

Pega este prompt en Claude Code. Cuando te pida las claves, dale la clave que inventaste en 9.1, tu API key de ElevenLabs y tu Voice ID.

Construye una interfaz web estilo Jarvis de Iron Man para hablar con mi asistente. Soy principiante: explícame cada paso en palabras simples y haz tú todo lo técnico. Requisitos:

1. Diseño: fondo oscuro, una esfera central de luz azul animada que respira cuando está en reposo, se mueve con el volumen cuando habla y cambia de color cuando escucha. Debajo, el texto de la conversación en letras finas. Que corra en http://localhost:3000.

2. Cerebro: cada mensaje se envía a mi agente Hermes, que expone una API compatible con OpenAI en http://localhost:8642/v1/chat/completions, modelo "hermes-agent", con el encabezado Authorization: Bearer y la clave que te voy a dar. Usa streaming y, mientras Hermes usa herramientas, muestra en pantalla qué está haciendo.

3. Oído: un botón de micrófono y la barra espaciadora para hablar. Transcribe mi voz en español con la API de voz del navegador.

4. Voz: lee cada respuesta en voz alta con la API de texto a voz de ElevenLabs, modelo eleven_multilingual_v2, con el Voice ID que te voy a dar. Las claves de ElevenLabs y de Hermes van en un archivo .env y nunca deben llegar al navegador: hazlas pasar por un pequeño servidor local.

5. Extra: que cuando diga "Jarvis" al inicio de una frase se active sola la escucha.

Antes de programar, muéstrame el plan en palabras simples. Pídeme las claves cuando las necesites. Al terminar, déjalo funcionando y dime cómo abrirlo de nuevo con un solo comando.

9.4 Ábrela

Cuando Claude Code termine, abre Chrome y entra a http://localhost:3000. Cuando el navegador pida permiso para usar el micrófono, acepta.

Comprueba que funciona: presiona la barra espaciadora y di "Jarvis, ¿qué tengo pendiente esta semana?". La esfera debe cambiar de color mientras escucha y moverse mientras responde con voz.

Si algo no funciona, díselo a Claude Code con tus palabras ("no se escucha la voz", "la esfera no se mueve") y él lo arregla.

9.5 Bonus: que despierte cuando digas "Jarvis"

Hermes puede quedarse escuchando una palabra de activación, como "Oye Siri". Con el motor Porcupine, la palabra que viene de fábrica es justamente "jarvis". Funciona en la Mac mientras el chat de Hermes está abierto.

1. Crea una cuenta gratis en console.picovoice.ai y copia tu AccessKey de la página principal.
2. Pega estos comandos en la Terminal, con tu clave en la primera línea:

hermes config set PORCUPINE_ACCESS_KEY TU_ACCESS_KEY
hermes config set wake_word.provider porcupine
hermes config set wake_word.porcupine.keyword jarvis

1. Abre el chat con hermes --tui y escribe /wake on. Para apagarlo, /wake off.

Comprueba que funciona: di "Jarvis" en voz alta y, cuando se active, pídele algo. La detección ocurre en tu Mac: no se envía audio a internet hasta que le das una orden.

Si algo falla

La Terminal dice "command not found: hermes". Cierra la Terminal con Cmd + Q y vuelve a abrirla. Si sigue igual, vuelve a pegar el comando de instalación del paso 3.

Jarvis responde con un error de clave, de saldo o "401". Revisa que tengas saldo en console.anthropic.com → Billing. Si cambiaste la clave, vuelve a configurarla con hermes model.

WhatsApp no contesta. Revisa en este orden: que el servicio esté encendido (hermes gateway status; si no, hermes gateway start); que en WHATSAPP_ALLOWED_USERS esté tu número y no el de Jarvis; que el celular de Jarvis tenga internet. Si nada funciona, vuelve a vincular con hermes whatsapp.

Google dice "Error 403: access_denied". Te faltó agregarte como usuario de prueba: vuelve al paso 5.1, punto 5.

Google dice "Esta app no está verificada". Es normal porque la app es tuya: Configuración avanzada → Ir a Jarvis.

No aparecen las herramientas de Supabase. Pega hermes mcp login supabase en la Terminal, autoriza en el navegador y abre un chat nuevo.

Jarvis no habla o la voz no es la que elegiste. Revisa que tu API key de ElevenLabs esté bien y que te queden créditos. Si elegiste una voz de la biblioteca, puede que necesite el plan de pago: prueba con una de las voces que vienen por defecto. Después de cualquier cambio, hermes gateway restart.

El modo voz dice que falta algo. Repite el paso 8.7 desde el punto 3. Si sigue fallando, pídele por escrito al propio Jarvis: "instala lo que falta para el modo voz".

Jarvis dejó de contestar de noche. Tu Mac se durmió o se reinició. Revisa el paso 1 y comprueba con hermes gateway status.

Cualquier otro error. Corre hermes doctor: revisa todo y te dice qué falta. Si no entiendes el resultado, cópialo y pégaselo a Claude o a ChatGPT pidiendo que te lo explique paso a paso.

Consejos para que tu Jarvis funcione de verdad

1. Haz un paso a la vez y no sigas hasta que el "Comprueba que funciona" salga bien.
2. Mantén la regla de "muéstrame antes de enviar" desde el primer día. Quítala solo en las tareas que ya viste funcionar bien muchas veces.
3. Cada vez que lo corrijas, dile "guárdalo en tu memoria". Así no te repite el error.
4. Cuando le pidas lo mismo más de dos veces, pídele que lo convierta en skill.
5. Revisa tu gasto del modelo cada semana durante el primer mes.
6. Actualízalo una vez al mes con hermes update.