📚 Guía de Usuario & Manual Técnico

Documentación Oficial de EvaGrade Desktop

Aprende a conectar tu Moodle, configurar el motor de inteligencia artificial (gratuito o local), definir rúbricas LOMLOE y automatizar tus correcciones por lotes con 100% de privacidad.

📖 1. Introducción a EvaGrade Desktop

EvaGrade Desktop es una aplicación nativa diseñada para docentes de colegios, institutos, formación profesional y universidades. Su propósito es automatizar la lectura y corrección por lotes de tareas de Moodle mediante rúbricas pedagógicas e Inteligencia Artificial, reduciendo el tiempo de calificación en más de un 90% y garantizando el cumplimiento estricto del RGPD europeo.

Requisitos del Sistema y Hardware

  • Sistemas Operativos: Windows 10 / 11 (64 bits) o distribuciones Linux modernas (Ubuntu 20.04+, Debian 11+, Fedora, Arch Linux).
  • Requisitos de la App (Modo Cloud o Servidor Propio): Muy ligeros: cualquier ordenador docente con 4 GB de RAM y procesador estándar.
  • Requisitos para IA Local (Ollama Offline en tu propio PC):
    • Mínimo: 16 GB de memoria RAM y procesador de 4+ núcleos (para modelos locales ligeros).
    • Aconsejable / Recomendado: 32 GB de memoria RAM o tarjeta gráfica dedicada (GPU) con 8 GB+ VRAM (para modelos locales de alta capacidad y máxima precisión pedagógica).
  • Conexión a Internet: Solo requerida para sincronizar con Moodle y en Modo Cloud. Con Ollama Local, la corrección funciona 100% sin conexión.

💻 2. Instalación Paso a Paso

🪟 Instalación en Windows

1

Descarga el instalador oficial

Descarga el archivo EvaGrade_Setup.exe desde la web oficial de EvaGrade.

2

Ejecuta el Asistente

Haz doble clic en el archivo descargado. Si Windows SmartScreen muestra un aviso preventivo, pulsa en "Más información" y selecciona "Ejecutar de todas formas".

3

Listo para Evaluar

Se creará automáticamente un acceso directo en tu escritorio y menú de inicio.

🐧 Instalación en Linux (.AppImage)

1

Descarga el archivo AppImage

Descarga EvaGrade-x86_64.AppImage.

2

Otorga Permisos de Ejecución

Haz clic derecho en el archivo ➔ Propiedades ➔ Permisos ➔ Permitir ejecutar como programa o ejecuta en terminal:

chmod +x EvaGrade-x86_64.AppImage
3

Ejecución

Haz doble clic sobre el archivo o lánzalo desde terminal: ./EvaGrade-x86_64.AppImage.

🎁 3. Activación de la Prueba Gratuita (15 Días PRO)

Al abrir EvaGrade por primera vez, se te otorgarán 15 días de prueba con todas las funciones PRO desbloqueadas (corrección por lotes ilimitada, extractores ZIP/Excel/PDF y todos los modelos de IA).

💡
Sin tarjeta de crédito: No necesitas introducir ningún método de pago ni datos bancarios. Solo tu correo electrónico docente para vincular tu periodo de prueba.

🏫 4. Conexión con tu Moodle / Aules

EvaGrade se conecta de forma nativa a cualquier plataforma Moodle estándar (v3.9 a v4.5+), incluyendo plataformas autonómicas como Aules (Comunitat Valenciana), Educamadrid, Moodle Centros (Andalucía), universidades y centros privados.

Configurar la Conexión

  1. En EvaGrade, abre la pestaña ⚙️ Configuración ➔ Moodle.
  2. URL del Servidor: Pega la dirección raíz de tu Moodle (por ejemplo: https://aules.edu.gva.es/fp/).
  3. Método de Autenticación:
    • Credenciales Directas (Usuario y Contraseña): Recomendado para inicio de sesión rápido. Tus contraseñas se almacenan cifradas localmente en tu equipo.
    • Token de Servicios Web (Webservices Token): Si tu centro tiene habilitada la API para docentes (Perfil ➔ Claves de Seguridad).
  4. Pulsa el botón «Probar Conexión». Al recibir confirmación, tus cursos se cargarán automáticamente.
ℹ️
Soporte Multicentro: Si trabajas en más de un centro educativo a la vez, puedes guardar diferentes perfiles de conexión y alternar entre ellos con un solo clic.

🔄 5. Sincronización de Cursos y Tareas

Desde la pestaña 📚 Cursos, verás el listado actualizado de todas tus materias.

  • Haz clic en un curso para desplegar sus tareas activas.
  • Cada tarea muestra el número de entregas enviadas vs. pendientes de calificar.
  • Al hacer clic en una tarea, EvaGrade descargará automáticamente las entregas y la rúbrica asociada para que puedas iniciar la corrección.

🧠 6. Arquitectura y Modos de IA en EvaGrade

EvaGrade integra un sistema de Inteligencia Artificial flexible y modular. Desde la pestaña ⚙️ Configuración ➔ 🧠 Inteligencia Artificial (LLM) dispones de un selector segmentado para alternar entre dos grandes modos según tus necesidades de privacidad y velocidad:

🏠

Modo 1: IA Local (Ollama Offline - 100% Privado)

Ejecuta modelos abiertos directamente en el hardware de tu ordenador. Los datos y entregas de los alumnos jamás salen de tu equipo ni se transmiten por Internet.

☁️

Modo 2: APIs Online (Cloud)

• OpenRouter Hub: Conecta a más de 300 modelos globales (Gemini 2.5 Flash, DeepSeek R1/V3, Claude 3.5, GPT-4o o modelos 100% gratuitos) con una única clave de API.
• Servidor Propio / Red Centro: Conecta a servidores locales de tu instituto o universidad (vLLM, LM Studio o endpoints OpenAI compatibles).

💡
Banner de Motor Activo: En la parte superior de la configuración verás en todo momento el distintivo ● ACTIVO con el modelo seleccionado, nivel de privacidad y estado de la conexión.

🏠 7. Guía: IA Local (Ollama Offline & 100% RGPD)

La opción recomendada para centros educativos con estrictas políticas de protección de datos o aulas sin acceso a Internet.

⚠️
Aviso Importante sobre Memoria para IA Local: Ejecutar modelos de inteligencia artificial en tu propio ordenador con calidad pedagógica profesional requiere una máquina apta. Se necesita como mínimo 16 GB de memoria RAM para modelos locales ligeros y es aconsejable contar con 32 GB de RAM o tarjeta gráfica dedicada (GPU) para modelos de alta capacidad y razonamiento profundo.
💡 ¿Tu ordenador tiene 8 GB de RAM o es un portátil docente estándar? Te recomendamos utilizar el Modo Cloud con OpenRouter Hub: la inferencia se procesa en servidores de alta potencia sin consumir recursos de tu equipo y manteniendo la privacidad mediante la anonimización local RGPD previa en tu PC.

1. Instalación de Ollama

Descarga e instala Ollama gratis desde ollama.com en tu equipo (Windows o Linux).

2. Detección Inteligente y Familias de Modelos

EvaGrade analiza automáticamente la memoria RAM y la GPU/CPU de tu equipo para recomendarte la opción idónea según tu máquina:

  • Familias Multimodales y Generales: Diseñadas para lectura de redacciones, comprensión de documentos y análisis visual de exámenes o esquemas.
  • Familias de Razonamiento Lógico: Especializadas en pensamiento reflexivo paso a paso, ejercicios de ciencias, matemáticas y aplicación minuciosa de rúbricas analíticas.
  • Familias Técnicas y de Código: Optimizadas para la inspección y corrección sintáctica de código fuente en ciclos formativos y grados técnicos.

3. Descarga en 1 Clic desde la App

No necesitas recordar comandos de consola: pulsa el botón «Descargar Modelo» dentro de EvaGrade y la aplicación descargará y configurará automáticamente el modelo recomendado para tu hardware con seguimiento de progreso en tiempo real.

4. Ajustes Avanzados

Puedes ajustar la URL del servicio (por defecto http://localhost:11434), el límite seguro de memoria RAM y la concurrencia de peticiones paralelas.

🚀 8. Guía: APIs Cloud con OpenRouter Hub (+300 Modelos)

OpenRouter Hub es la pasarela universal recomendada para el modo Cloud en EvaGrade: con una única cuenta y clave accedes a todos los proveedores del mercado sin configurar cuentas separadas en Google, Anthropic u OpenAI.

1

Obtén tu API Key en OpenRouter

Crea tu cuenta en openrouter.ai/keys y genera una clave de API.

2

Pega tu clave en EvaGrade

En Configuración ➔ IA ➔ APIs Online (Cloud), selecciona OpenRouter Hub y pega tu clave.

3

Elige un Preset Inteligente o Explora el Catálogo

EvaGrade calcula en tiempo real métricas de coste por clase y potencia para ofrecerte 3 presets de 1 clic:

  • 🥇 Top 1 Calidad/Precio: Selección automática del modelo más equilibrado (ej. google/gemini-2.5-flash o DeepSeek V3). Coste típico: < 0,005 € por clase.
  • 🆓 100% Gratuito: Modelos con etiqueta :free que puedes usar sin recargar saldo.
  • ⚡ Máxima Potencia / Razonamiento: Modelos con razonamiento profundo como DeepSeek R1, Claude 3.5 Sonnet o GPT-4o.
4

Pulsa «Probar y Activar Motor de IA»

EvaGrade verificará la comunicación con el modelo y lo dejará listo para evaluar.

🔌 9. Servidor Propio / Red del Centro Educativo

Si tu centro educativo, instituto o universidad dispone de un servidor propio con vLLM, LM Studio, Ollama en red de aula o cualquier endpoint compatible con la API de OpenAI:

  1. En Configuración ➔ IA ➔ APIs Online, selecciona la tarjeta 🔌 Servidor Propio / Red Centro.
  2. Introduce la URL base de tu servidor (ejemplo: http://192.168.1.50:8000/v1).
  3. Si el servidor requiere clave, introdúcela en el campo API Key (o déjala vacía si es una red local abierta).
  4. Haz clic en el botón «🔍 Auto-detectar modelos en servidor». EvaGrade consultará tu servidor y cargará automáticamente la lista de modelos disponibles.
  5. Pulsa en «Probar y Activar Motor de IA» para comenzar a corregir usando la infraestructura de tu centro.

🛡️ 10. Anonimización RGPD en el PC y Privacidad

La privacidad de los menores y estudiantes es la prioridad absoluta en la arquitectura de EvaGrade:

  • En Modo Local (Ollama): El 100% del procesamiento se realiza en los núcleos de tu procesador/tarjeta gráfica. No existe transmisión de datos al exterior.
  • En Modo Cloud (OpenRouter / Servidor Remoto): Antes de enviar cualquier entrega a la nube, el motor local de EvaGrade enmascara y anonimiza nombres y apellidos de los alumnos por etiquetas (ej. [ALUMNO_01]), filtra correos electrónicos y números de identificación (DNI/NIA). Al recibir la nota y el comentario de feedback, el programa reasocia en local la corrección al alumno real.
  • Cifrado Local: Las contraseñas de Moodle y las claves de API se guardan cifradas en la base de datos local SQLite de tu propio ordenador.

📐 11. Configuración de Rúbricas y Formatos Soportados

Formatos de Entrega Soportados

  • Archivos Comprimidos (ZIP, TAR.GZ): Inspección recursiva de carpetas y extracción de código fuente o documentos adjuntos.
  • Hojas de Cálculo (ODS de LibreOffice y XLSX de Excel): Lectura estructurada de celdas, comprobación de fórmulas matemáticas y tablas.
  • Documentos de Texto y PDF: Archivos Word (DOCX), PDF y ficheros de texto plano (TXT, MD).
  • Texto en Línea: Redacciones y respuestas introducidas directamente en el editor web de Moodle.

Rúbricas Pedagógicas (LOMLOE)

Puedes definir criterios con diferentes niveles de logro (0 a 10), ponderación porcentual, bonificaciones por puntos extra (creatividad, formato sobresaliente) y penalizaciones (falta de ortografía, entrega fuera de plazo).

🚀 12. Evaluación Masiva por Lotes (Batch AI)

Para corregir a un grupo completo de 25-35 alumnos:

  1. Entra en la tarea seleccionada.
  2. Haz clic en el botón «🚀 Encolar Entregas Pendientes».
  3. EvaGrade procesará de forma secuencial y paralela cada entrega, mostrando una barra de progreso en tiempo real con el tiempo estimado de finalización.
  4. Puedes pausar o reanudar el proceso en cualquier momento.

🎯 13. Revisión de Borradores y Volcado a Moodle

Tú siempre tienes el control final de la evaluación:

  • Las calificaciones y comentarios generados aparecen en estado Borrador.
  • Puedes hacer clic en cualquier alumno para ajustar la nota numérica o editar el comentario de retroalimentación redactado por la IA.
  • Una vez revisadas, pulsa «Publicar Calificaciones en Moodle» para sincronizar las notas en el libro oficial de calificaciones de tu centro.

🔑 14. Activación de Licencia PRO

Tras adquirir tu licencia en la web oficial:

  1. Recibirás un correo electrónico inmediato de Lemon Squeezy / EvaGrade con tu Clave de Licencia PRO y tu factura con IVA desglosado.
  2. Abre EvaGrade en tu ordenador y dirígete a ⚙️ Configuración ➔ Licencia.
  3. Pega tu clave en el campo correspondiente y pulsa «Activar Licencia».
  4. Tu estado cambiará a PRO Ilimitado de inmediato.
💻
Hasta 3 Equipos Simultáneos: Puedes utilizar la misma clave de licencia en tu ordenador del centro educativo, en tu portátil y en tu ordenador personal de casa.

❓ 15. Preguntas Frecuentes Técnicas

¿Qué ocurre si cambio o formateo mi ordenador?

Puedes desvincular tu licencia desde la pestaña de configuración antes de formatear o volver a introducir tu clave en el nuevo equipo. Nuestro servidor de licencias gestiona la transferencia automáticamente.

¿Es necesario instalar Python en mi sistema?

No. Los paquetes oficiales para Windows (.exe) y Linux (.AppImage) son completamente autónomos e incluyen todos los motores de extracción necesarios empaquetados en el instalador.

¿Dónde puedo solicitar soporte técnico?

Puedes escribirnos a nuestro canal de soporte docente oficial en [email protected]. Los usuarios con Licencia PRO cuentan con soporte prioritario en menos de 24 horas laborables.