abdallahmagdy15/mudriknow

abdallahmagdy15/mudriknow has 43 GitHub stars and 10 forks. GitHot measured 0 stars in 24 hours and 0 in 7 days. Last checked 2026-11-12 07:27 UTC. Last push 2026-10-10.

Cómo se miden estas cifras

Open-source desktop AI agent that sees what you see — one hotkey over any window, it answers, acts, or guides you step-by-step.

43 estrellas 10 forks

What you can do

🦉 Auto-Guide - MudrikNow becomes a teacher: an owl cursor appears on screen, points to each target with a speech bubble, and walks you step‑by‑step through multi‑step UI tasks. Toggle in ⚙ settings.
💬 Quick chat mode - Alt+X opens the panel without capturing context — for questions that don't need screen awareness. MudrikNow is always one keystroke away, even when you just need a quick answer.
🔌 Any LLM - 140+ providers via OpenCode + models.dev — NVIDIA, Anthropic, OpenAI, Google, DeepSeek, OpenRouter, and more. Pick a provider, paste your key, and Verify it works before you trust it. Vision (multimodal) models recommended — MudrikNow auto-screenshots every activation; Google Gemini Flash-Lite is a great free pick.
🔒 Sandboxed - Read-only shell for diagnostics — writes, deletes, and piping are blocked (violations kill the session). No filesystem writes. The AI reads files in your working directory and dispatches an allow-listed set of UI actions. That's the whole capability surface.

Crecimiento de estrellas medido

in 24h: 0
in 7 days: 0
in 15 days: Recopilando historial
in 1 month: Recopilando historial

Cambios netos en períodos que se solapan, no totales diarios. Los datos no disponibles se dejan en blanco. Las estrellas indican interés, no calidad.

README.es-ES.md

Original

MudrikNow · مدرك

Deja de explicar tu pantalla a la IA. MudrikNow es un agente de IA de escritorio de código abierto que ve lo que tú ves — y responde, actúa o te guía paso a paso en cualquier tarea.

Sitio web · Instalación · Atajos de teclado · Acerca de

🎬 Demo

Ver la demostración →

Alt+Space → preguntar → MudrikNow actúa en tu escritorio

✨ Qué hace

Presiona Alt+Space sobre cualquier ventana. MudrikNow escanea la interfaz de tu ventana activa — cada botón, campo, etiqueta y valor — y abre un panel flotante en el lado opuesto de tu pantalla para que nada quede oculto. El elemento en el que apuntas se convierte en el punto de referencia. MudrikNow también captura una captura de pantalla completa con cuadrícula de coordenadas en cada activación, para que vea los píxeles además del árbol de interfaz.

A partir de ahí: pregunta, traduce, corrige o resume. O dale la orden de actuar: escribir, pegar, hacer clic, invocar o presionar atajos de teclado. Activa Auto-Guide y MudrikNow se convierte en un instructor — aparece un cursor con forma de búho en la pantalla que te guía paso a paso en cualquier tarea compleja.

🚀 Instalación

Instala Node.js ≥ 20.
Instala OpenCode (autenticación opcional — las claves pueden almacenarse dentro de la app):
```
npm i -g opencode-ai
```
Descarga el último archivo .exe desde Lanzamientos y ejecútalo.
Conecta tu modelo de IA. En el primer inicio, MudrikNow abre la configuración y resalta Add a model para ti. Elige un proveedor — NVIDIA es recomendado (capa gratuita generosa; build.nvidia.com → claves API) — pega tu clave, haz clic en Verify y luego selecciona un modelo. En cualquier momento: ⚙ → Model → Add a model.

El instalador está sin firmar — SmartScreen mostrará una advertencia en el primer inicio. Más información → Ejecutar de todos modos.

Desde el código fuente: git clone https://github.com/abdallahmagdy15/mudriknow && cd mudriknow && npm install && npm start

Prerrequisito de compilación para Windows: npm install requiere Visual Studio con la carga de trabajo "Desktop development with C++" (para la compilación nativa de robotjs y koffi). Se recomienda Node.js ≥ 20 LTS. Consulta AGENTS.md para obtener todos los detalles.

⌨️ Atajos de teclado

Dos atajos globales ponen a MudrikNow frente a ti. Ambos se pueden reasignar desde el menú ⚙.

Atajo	Qué ocurre
`Alt+Space`	Lee la interfaz completa de tu ventana activa y se ancla en lo que estás señalando. MudrikNow se abre en el lado opuesto de la pantalla, listo para ayudar.
`Alt+X`	Chat rápido — abre el panel al instante sin capturar el contexto. Para preguntas que no requieren conciencia de la pantalla.
`Esc`	Cancelar: detiene la transmisión o cierra el panel.
`Enter`	Enviar el mensaje. `Shift+Enter` para nueva línea.

🛠 Características


🪟 Lee cualquier app de Windows	Usa Windows UI Automation para detectar botones, campos, texto y menús. Funciona en navegadores, Office, IDEs y diálogos nativos — en cualquier lugar donde llegue la accesibilidad. Captura una captura de pantalla en cada Alt+Space; el botón Capturar Contexto también está disponible.
⚡ Actúa por ti	Escribe, pega, haz clic, invoca o presiona atajos de teclado — MudrikNow puede interactuar con cualquier elemento accesible.
🦉 Auto-Guide	MudrikNow se convierte en un instructor: aparece un cursor con forma de búho en la pantalla, señala cada objetivo con un globo de diálogo y te guía paso a paso en tareas de interfaz complejas. Se activa/desactiva en la configuración ⚙.
💬 Modo de chat rápido	`Alt+X` abre el panel sin capturar el contexto — para preguntas que no requieren conciencia de la pantalla. MudrikNow está siempre a una tecla de distancia, incluso cuando solo necesitas una respuesta rápida.
🔌 Cualquier LLM	Más de 140 proveedores mediante OpenCode + models.dev — NVIDIA, Anthropic, OpenAI, Google, DeepSeek, OpenRouter y más. Elige un proveedor, pega tu clave y Verifica que funcione antes de confiar en él.
🔒 Aislado (Sandbox)	Shell de solo lectura para diagnósticos — escrituras, eliminaciones y piping están bloqueados (las violaciones detienen la sesión). Sin escritura en el sistema de archivos. La IA lee archivos en tu directorio de trabajo y ejecuta un conjunto permitido de acciones de UI. Eso es todo el alcance de sus capacidades.

🧠 Cómo funciona

Alt+Space (cursor)
  ↓  el atajo lee la posición del cursor
  ↓  script UIA de PowerShell — árbol JSON de la ventana activa
  ↓  captura de pantalla completa + cuadrícula de coordenadas, siempre
  ↓  MudrikNow se abre en el lado opuesto de la pantalla, listo para chatear

Alt+X (chat rápido)
  ↓  el panel se abre al instante — sin captura de contexto
  ↓  para preguntas que no requieren conciencia de la pantalla

Enviar mensaje
  ↓  transmisión a `opencode run --agent readonly`
  ↓  los tokens se renderizan en vivo; se analizan las marcas <!--ACTION:{...}-->
  ↓  las acciones se ejecutan mediante UIA o robotjs

Modo Auto-Guide (opcional mediante ⚙)
  ↓  la IA emite guide_offer → el usuario acepta
  ↓  aparece el cursor de búho con globo de diálogo, el panel se oculta
  ↓  el búho señala → el usuario hace clic → la IA avanza
  ↓  guide_complete → "¡Listo!" → regresa el panel

Arquitectura completa en AGENTS.md.

🔒 Privacidad y Seguridad

MudrikNow ejecuta la IA en un entorno aislado (sandbox) con capacidades deliberadamente limitadas:

Capacidad	¿Expuesta al modelo?
Ejecución de Shell / PowerShell	🟡 Solo lectura (mutación/tuberías bloqueadas)
Escritura en sistema de archivos	❌ No
Lectura de sistema de archivos (`read`/`grep`/`glob`/`list`)	✅ Sí (dentro del directorio de trabajo)
Windows UI Automation	✅ Sí (conjunto de acciones predefinido)
Teclado / ratón	✅ Sí (cuando UIA no puede alcanzar un objetivo)
Píxeles de pantalla	✅ Automático en cada Alt+Space

Modelo de amenazas completo + reporte en SECURITY.md.

👋 Acerca de

Hola, soy Abdullah Magdy.

Un desarrollador senior que se cansó de explicar su pantalla a la IA — así que construí MudrikNow en mis noches y fines de semana. Código abierto para que puedas ver (y mejorar) cada línea.

🐙 GitHub — @abdallahmagdy15
🐦 X / Twitter — @AbdallahMagdyy
💼 LinkedIn — abdallahmagdy15
✉️ [email protected]

Para problemas de seguridad, usa Reporte privado de vulnerabilidades de GitHub (o el correo electrónico como respaldo) — no issues públicos.

🤝 Contribuir

PRs bienvenidos. MudrikNow está hecho en TypeScript de extremo a extremo (main, preload, renderer, tipos compartidos) — la única fuente de verdad para canales IPC, tipos de acción y forma de la configuración se encuentra en src/shared/types.ts.

Configuración, pipeline de compilación y flujo de lanzamiento en CONTRIBUTING.md. Código de conducta en CODE_OF_CONDUCT.md.

🙏 Agradecimientos

OpenCode — se encarga de la transmisión, proveedores y autenticación para que MudrikNow no tenga que hacerlo.
Electron · React · robotjs · Windows UI Automation.

📄 Licencia

MIT — bifúrcalo, modifícalo, distribúyelo, véndelo. Solo mantén el aviso de copyright en el archivo LICENSE.

_{MudrikNow · مدرك · el consciente}