Nexus es un asistente virtual de alto rendimiento diseñado para la automatización profunda de Windows con un impacto mínimo en recursos. Esta versión representa la evolución hacia una arquitectura blindada, optimizada para funcionar en segundo plano durante tareas de alta exigencia (Gaming/Rendering) y entornos de multitarea intensiva.
- Escudo de Estabilidad (Nexus Shield): Implementación de decoradores avanzados para la interceptación de excepciones, permitiendo que el sistema permanezca operativo incluso si un módulo individual falla.
- Orquestación de Procesos: Control granular sobre ventanas de Windows (
pygetwindow) y mezclador de audio independiente por aplicación (pycaw). - Monitor de Hardware Sarcástico: Sistema de diagnóstico en tiempo real que analiza el estrés de la CPU y RAM, con una lógica de respuesta basada en umbrales de rendimiento.
- Gestión de Contexto y Notas: Integración de un procesador de texto que limpia, normaliza y almacena información en disco de forma persistente.
- Interfaz de Bandeja (System Tray): Ejecución 100% en segundo plano con acceso rápido mediante iconos de sistema, liberando la consola de comandos.
El proyecto demuestra un dominio avanzado de Python orientado a la integración con el sistema operativo:
- Automatización de SO: Uso de
subprocessypyautoguipara la inyección de comandos en PowerShell y emulación de periféricos. - Programación Concurrente: Gestión de hilos (
threading) para ejecutar temporizadores y procesos de interfaz sin bloquear el bucle principal de escucha. - Asincronía Segura: Comunicación entre hilos síncronos y el motor de voz asíncrono mediante
asyncio.run_coroutine_threadsafe. - Manipulación de Bajo Nivel: Interacción con las interfaces COM de Windows para el control maestro de volumen y sesiones de audio individuales.
Nexus opera sobre una suite de herramientas diversificada y robusta:
| Módulo | Función Principal | Descripción Técnica |
|---|---|---|
| WinTools | Gestión de Entorno | Capturas de pantalla, limpieza de escritorio y reinicio de núcleo. |
| AppManager | Orquestador | Resolución de alias recursivos para abrir apps y sitios web. |
| Volume | Mixer Dinámico | Control de volumen maestro y específico (ej. YouTube Music). |
| Timer | Temporizadores | Cuenta regresiva asíncrona con notificaciones contextuales. |
| Weather | Meteorología | Consumo de API REST con mapeo dinámico de condiciones. |
| Monitor | Diagnóstico | Reporte de telemetría de hardware (CPU/RAM). |
| FileSearch | Explorador | Búsqueda recursiva optimizada en el árbol de directorios. |
El desarrollo de esta versión fue un proceso de iteración crítica donde se priorizó la estabilidad real sobre la acumulación de funciones inestables:
- API No Oficial de YouTube Music: Se intentó implementar un control de música más preciso mediante APIs de terceros. Debido a la alta inestabilidad y cambios constantes en los endpoints no oficiales, la idea fue descartada para mantener la integridad del sistema.
- Escucha Permanente sin Filtro: Se replanteó el modelo de escucha continua para evitar el consumo innecesario de recursos y activaciones falsas, optimizando el umbral de activación por voz.
- Falsos Positivos de Antivirus: Se detectó que algunos software de seguridad pueden eliminar o bloquear el archivo
nexus_start.vbs. Se recomienda añadir la carpeta del proyecto a la lista de exclusiones del antivirus para garantizar el inicio automático. - Contexto Climático: Se corrigió un error en la validación horaria del módulo meteorológico que entregaba datos desfasados; ahora el contexto se sincroniza correctamente con el tiempo real del sistema.
- Blindaje de Funciones Críticas: Anteriormente, un fallo en un comando de bajo nivel podía colapsar el núcleo. Esto se solucionó mediante el Nexus Shield, envolviendo cada función crítica en capas de protección.
- Control de Audio: Ante el descarte de APIs externas, se optó por un control maestro y por sesión mediante interfaces COM de Windows, logrando un manejo de volumen más robusto y universal.
Para garantizar la seguridad de las credenciales y la personalización, Nexus utiliza un sistema híbrido:
- .env: Almacena datos sensibles como
API_KEYS, coordenadas geográficas (LAT,LON) y nombres de usuario. - config.json: Define rutas frecuentes del sistema, alias de aplicaciones y preferencias de carpetas.
-
Clonar el repositorio:
git clone [https://github.com/tu-usuario/nexus-system.git](https://github.com/tu-usuario/nexus-system.git) cd nexus-system -
Instalar dependencias:
pip install -r requirements.txt
-
Configurar entorno: Cree un archivo
.enven la raíz con sus credenciales y configure sus rutas enconfig.json. -
Ejecutar:
python main.py
- Dormir: "Nexus, dormite", "Entrá en espera", "Silencio".
- Despertar: "Nexus, despertate", "Activar sistema", "Despierta".
- Capacidades: "¿Qué podés hacer?", "Nexus, ¿qué funciones tenés?".
- Social: "Nexus, ¿cómo estás?", "¿Todo bien?", "¿Cómo andás?".
- Feedback: "Gracias", "Buenísimo".
- Debug: "Activar modo depuración".
- Consulta: "Nexus, ¿cómo está el clima?", "¿Qué tiempo hace?".
- Hora: "¿Qué hora es?".
- Recursos: "¿Cómo están los recursos?" o "¿Cuánta RAM estamos usando?".
- Energía (PC): "Apagar la pc en [X] minutos", "Cancelar apagado".
- Cierre: "Nexus, apagate", "Chau Nexus".
- Abrir: "Abrí la carpeta de descargas", "Abrí YouTube", "Necesito el correo".
- Enfoque: "Mostrame el navegador", "Traé el Discord".
- Cerrar: "Cerrá esta ventana", "Mata el proceso de [Nombre]".
- Audio: "Pausar", "Siguiente", "Bajá el volumen", "Volumen al [X]%".
- Herramientas: "Nexus, grabá eso" o "Sacá una captura".
A partir de esta versión, todas las funciones críticas están envueltas en el Nexus Shield. Este sistema de registro (nexus_errors.log) no solo evita el cierre inesperado del programa ante fallos de API o permisos, sino que proporciona feedback auditivo al usuario sobre la naturaleza del error, garantizando estabilidad en entornos de producción local.