Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

🤖 J.A.R.V.I.S. para macOS — el asistente de Tony Stark, en tu Mac

Un asistente con inteligencia artificial que vive en tu Mac, está siempre encendido, tiene memoria propia, te avisa de tus cosas importantes (notificación + voz + email) y controla tu Mac por voz: abre apps, pone música, sube el volumen o enciende las luces de casa con tus Atajos.

  • ✅ Instalación con doble clic, sin saber programar.
  • ✅ Gratis: usa por defecto una IA que funciona dentro de tu Mac (Ollama). Si quieres más inteligencia, puedes usar Claude (de pago).
  • ✅ Control por voz manos libres: di «Jarvis, …» y te responde hablando.
  • ✅ 100 % código abierto (MIT): todo el programa es un archivo de unas 200 líneas (jarvis.py) más el HUD (index.html).

HUD de Jarvis en el Mac   Jarvis en el móvil

Esta es la versión para Mac de Jarvis. Si quieres ponerlo en un servidor Linux, en Windows o con Docker, usa esa.


🧠 ¿Qué sabe hacer?

Le dices… Jarvis…
🎙 «Jarvis, ¿qué tengo hoy?» Te responde hablando y sigue escuchando unos segundos.
«Jarvis, avísame a las 17:00 de que llame a Pepper» A las 17:00 el Mac muestra una notificación, te lo dice en voz alta y te llega un email o un Telegram si los configuraste.
«Recuérdame cada lunes a las 8 que saque la basura» Recordatorio repetitivo (diario o semanal).
«Recuerda que mi mujer se llama Pepper» Lo guarda en su memoria permanente.
«Abre Safari», «Abre youtube.com», «Abre Notas» Abre apps, webs o archivos en tu Mac.
«Pon música», «Siguiente canción», «¿Qué suena?» Controla Spotify o Apple Música.
«Baja el volumen al 20», «Silencia el Mac» Controla el volumen.
«¿Cuánta batería me queda?» Te dice la batería.
«Apaga la pantalla» Apaga la pantalla (y bloquea el Mac si tienes contraseña).
«Enciende las luces del salón» Ejecuta tu Atajo de Apple con ese nombre (HomeKit, mensajes, calendario, modos de concentración…).
«Manda un email a Happy diciendo que llego tarde» Escribe y envía el email.
(nada, cada mañana) Te da el informe del día con notificación y voz.

🚀 Instalación (5 minutos)

1. Descarga Jarvis

Pulsa el botón verde Code → Download ZIP de esta página y descomprímelo. Mueve la carpeta donde quieras tenerlo para siempre (por ejemplo, a tu carpeta de usuario).

(Si sabes usar la Terminal: git clone https://github.com/ConguitoXD/Jarvis-MACOS.git)

2. Elige el cerebro

🆓 Gratis (Ollama, recomendado en Mac) 💳 De pago (Claude)
Coste 0 € Unos euros al mes según uso
Inteligencia Buena para el día a día La mejor
Buscar en internet ❌ ✅
Privacidad Todo se queda en tu Mac Los mensajes pasan por la API de Claude
Necesitas Mac con chip Apple (M1 o posterior) y 8 GB de RAM o más Cualquier Mac
  • Gratis: instala Ollama (arrástralo a Aplicaciones y ábrelo una vez). No tienes que tocar nada más: la configuración ya viene preparada para él, y el instalador descarga el modelo.
  • De pago: crea una clave en console.anthropic.com (API Keys → Create Key). En el paso 3 pondrás "api_key": "sk-ant-…", "base_url": "" y "model": "claude-opus-5".

3. Instala con doble clic

Abre la carpeta y haz doble clic en Instalar Jarvis.command.

⚠️ Si macOS dice que "no se puede abrir porque es de un desarrollador no identificado": haz clic derecho → Abrir → Abrir. Solo la primera vez.

El instalador:

  1. Prepara Python (si no lo tienes, te ayuda a instalarlo).
  2. Abre config.json en TextEdit: pon tu nombre, tu email y una contraseña para la web (sin tildes ni ñ). Guarda con ⌘S y vuelve a la Terminal.
  3. Descarga el modelo de IA gratuito (si usas Ollama).
  4. Deja Jarvis encendido para siempre: arranca solo al encender el Mac, se reinicia si falla y evita que el Mac se duerma.
  5. Crea Jarvis.app en tu carpeta Aplicaciones (la de tu usuario) y lo abre.

4. Háblale

  • Abre Jarvis desde Aplicaciones o Spotlight (⌘ + espacio → "Jarvis"). Usuario: jarvis, contraseña: la de config.json. Consejo: arrástralo al Dock.
  • Pulsa 🎙 MANOS LIBRES, acepta el permiso del micrófono y di «Jarvis, …».
  • La primera vez que Jarvis controle Música, Spotify o el sistema, macOS te preguntará si lo permites: pulsa Aceptar.

🎙️ Control por voz

  1. Pulsa 🎙 MANOS LIBRES. El reactor muestra un anillo verde: espera su nombre.
  2. Di «Jarvis» seguido de tu orden: «Jarvis, pon música». También puedes decir solo «Jarvis»: te contesta «¿Sí, señor?» y te escucha 8 segundos.
  3. Te responde en voz alta y sigue escuchando 8 segundos por si quieres añadir algo.
Di… Qué pasa
«Para», «Silencio» Se calla al momento.
«Deja de escuchar» Desactiva el modo manos libres.
  • Mientras el modo manos libres está encendido, la pantalla no se apaga sola, para que Jarvis siga escuchando.
  • Funciona con Chrome, Edge o Safari (Jarvis.app usa Chrome si lo tienes y, si no, Safari). En Safari, activa Siri en Ajustes del Sistema → Apple Intelligence y Siri para el reconocimiento de voz.
  • Los avisos y recordatorios te los dice en voz alta el propio Mac, aunque no tengas la ventana abierta.

El reactor del HUD

Reactor Estado
🔵 Azul, lento EN ESPERA (escríbele o pulsa 🎤)
🟢 Anillo verde ESCUCHA ACTIVA (espera «Jarvis»)
🟠 Naranja ESCUCHANDO (ves en directo lo que entiende)
🔵 Gira rápido PROCESANDO
🔵 Núcleo latiendo HABLANDO

🏠 Atajos: el superpoder de Jarvis en Mac

Todo lo que puedas hacer con la app Atajos de Apple, Jarvis lo puede hacer por voz. Ejemplos:

  1. Abre Atajos y crea uno llamado "Luces salón" con la acción Controlar mi casa → encender luces del salón.
  2. Di: «Jarvis, enciende las luces del salón». Jarvis busca tus atajos y ejecuta el correcto.

Ideas: "Modo cine" (bajar luces + no molestar), "Enviar mensaje a mamá", "Añadir al calendario", "Salgo de casa". Jarvis solo puede ejecutar los atajos que tú hayas creado.


📱 Usarlo desde el móvil

  • Telegram (lo más fácil, funciona fuera de casa sin configurar el router): habla con @BotFather, escribe /newbot y pon el token en config.json → "telegram". La primera vez el bot te dirá tu chat id: ponlo en "allowed_chats" y haz doble clic en Reiniciar Jarvis.command.
  • La web con voz, en tu casa: en el móvil abre http://NOMBRE-DE-TU-MAC.local:8000. El nombre lo ves en Ajustes del Sistema → General → Compartir. Para usar el micrófono desde el móvil hace falta HTTPS: instala Tailscale (gratis) en el Mac y en el móvil y ejecuta tailscale serve 8000.

🎨 Personalización (config.json)

Después de cambiar algo, haz doble clic en Reiniciar Jarvis.command.

Opción Qué hace Ejemplo
name Nombre del asistente "FRIDAY" (pon también "wake_words": ["friday"])
owner / owner_email Tu nombre y tu email "Tony"
language Idioma de las respuestas "español", "English"
timezone Tu zona horaria "Europe/Madrid", "America/Mexico_City"
personality Su forma de ser. {name} y {owner} se sustituyen solos "Eres un mayordomo sarcástico…"
base_url / model Cerebro: "http://localhost:11434" + "qwen3:8b" (gratis) o "" + "claude-opus-5" (de pago)
mac.speak_alerts Que el Mac diga en voz alta los avisos true
mac.voice Voz del Mac para los avisos. Mira las disponibles con say -v '?' en la Terminal "Jorge", "Mónica", "Daniel"
mac.sound Sonido de las notificaciones "Glass", "Hero", "Ping"
voice Voz del HUD: wake_words (palabras que lo activan), lang, rate (velocidad), pitch (tono) y name (voz concreta) {"lang": "es-MX"}
briefing_time Hora del informe diario ("" = desactivado) "08:00"
email Para enviar emails y avisos (Gmail: smtp.gmail.com, puerto 465 y una contraseña de aplicación)
web_password / port Contraseña y puerto del HUD 8000

Modelos gratis según tu Mac (se descargan con ollama pull NOMBRE):

Tu Mac "model"
8 GB de RAM "qwen3:4b"
16 GB (recomendado) "qwen3:8b"
32 GB o más "qwen3:14b" o "qwen3:30b"

Añadir habilidades nuevas: copia en jarvis.py una función con @beta_tool, describe qué hace y añádela a la lista TOOLS. Jarvis aprenderá a usarla solo.


⚙️ Cómo funciona por dentro

 Tú: voz o texto (Jarvis.app / Safari / móvil / Telegram)
                        │
                        ▼
                 ┌─────────────┐      ┌───────────────────────────┐
                 │  jarvis.py  │ ───▶ │ Cerebro: Ollama (gratis,  │
                 │ (servicio   │ ◀─── │ en tu Mac) o Claude (API) │
                 │  24/7 macOS)│      └───────────────────────────┘
                 └─────────────┘
          ┌──────────┼──────────────────────────────┐
          ▼          ▼                              ▼
     memory.db   Control del Mac               ⏰ Vigilante (cada 30 s)
     (memoria,   AppleScript · open · Atajos    notificación + voz del Mac
      avisos,    volumen · música · batería     + email + Telegram
      chat)
  • Siempre encendido: un LaunchAgent de macOS (~/Library/LaunchAgents/com.jarvis.asistente.plist) arranca Jarvis al iniciar sesión, lo reinicia si falla y usa caffeinate para que el Mac no se duerma mientras está enchufado. Si cierras la tapa de un MacBook, se dormirá igualmente (salvo que tenga pantalla externa conectada).
  • Memoria: data/memory.db, en tu Mac. Haz copia de esa carpeta (Time Machine ya lo hace).
  • ¿Por qué Python? Trae de serie base de datos, email y servidor web, y controla el Mac con los comandos que macOS ya incluye (osascript, open, say, shortcuts). Resultado: un solo archivo corto y una sola dependencia (el SDK oficial de Claude, que también sirve para hablar con Ollama).

❓ Problemas frecuentes

  • No abre el HUD / "no se puede conectar" → mira el registro en data/jarvis.log. Suele ser un error en config.json (una coma de más o de menos). Corrígelo y haz doble clic en Reiniciar Jarvis.command.
  • "Connection refused" con el modo gratis → abre la app Ollama (aparece una llamita en la barra de menús).
  • "model not found" → descárgalo: ollama pull qwen3:8b (el nombre debe coincidir con "model").
  • No controla la música o el volumen → Ajustes del Sistema → Privacidad y seguridad → Automatización: permite que Python controle Música, Spotify y System Events.
  • No oigo los avisos → revisa mac.speak_alerts y el volumen. Para ver las notificaciones: Ajustes del Sistema → Notificaciones → Editor de Scripts → Permitir.
  • No reacciona a «Jarvis» → comprueba que pone MANOS LIBRES: ON y mira debajo del reactor qué entiende. Añade esa palabra a wake_words.
  • Desinstalar → doble clic en Desinstalar Jarvis.command (tu memoria y tu configuración se conservan).

🔐 Privacidad y seguridad

  • Tu memoria, tus recordatorios y tus conversaciones se guardan solo en tu Mac. En modo gratis, nada sale de tu Mac (salvo los emails y mensajes de Telegram que tú actives).
  • El reconocimiento de voz lo hace el navegador: Chrome envía el audio a Google, y Safari usa el reconocimiento de Apple. La voz de Jarvis y los avisos hablados se generan en tu Mac.
  • Jarvis solo puede hacer lo que permiten sus herramientas: abrir cosas, música, volumen, batería, apagar la pantalla, tus Atajos, emails y recordatorios. No puede borrar archivos ni ejecutar comandos arbitrarios.
  • El HUD está protegido con contraseña. config.json guarda tus claves: no lo compartas.

🌍 English (short version)

Tony-Stark-style AI assistant for macOS in one ~200-line Python file. Double-click Instalar Jarvis.command to install: it sets up Python, runs Jarvis 24/7 as a LaunchAgent (with caffeinate) and adds Jarvis.app to your Applications. Free by default with Ollama running on your Mac, or Claude via API. Hands-free voice control ("Jarvis, …"), persistent memory, reminders with native notifications and spoken alerts, email/Telegram, and Mac control: open apps and websites, music (Spotify/Apple Music), volume, battery, display sleep, and your Apple Shortcuts (HomeKit and more). Set "language": "English" and "voice": {"lang": "en-GB"} in config.json. MIT licensed.

Licencia: MIT — libre para todo el mundo.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages