TUTOR OKIRYS
============

Tu tutor de estudio: lecciones, ejercicios que se corrigen al instante y
fichas de repaso, hechos a partir de los PDF de TUS materias.


PARA INSTALARLO (5 minutos)
---------------------------

Hay un instalador por sistema. Abre SOLO el tuyo; los otros dos ignóralos.
Ninguno pide permisos de administrador.


·· WINDOWS ··

0. Si lo bajaste de la página, primero desbloquea el .zip. Windows marca
   todo lo que viene de internet y después lo bloquea:

      Clic derecho en  tutor-okirys.zip  >  Propiedades
      Abajo del todo, marca  "Desbloquear"  >  Aceptar

   Y AHORA SÍ descomprímelo (clic derecho > "Extraer todo"). En ese orden:
   si extraes primero, la marca pasa a todos los archivos de dentro y el
   instalador te saldrá con un aviso de seguridad. Si ya te pasó: desbloquea
   el .zip, borra la carpeta que sacaste y vuelve a extraer.
   (Si te lo dieron en una USB, sáltate este paso.)

1. Doble clic en  INSTALAR.bat

2. Te pregunta dónde instalar. Pulsa Enter.

3. Al terminar aparece en el escritorio  "Tutor Okirys".


·· macOS ··

1. Doble clic en  INSTALAR.command

   La primera vez macOS dirá que es "de un desarrollador no identificado".
   Es lo que dice de todo lo que no viene de su tienda. Para abrirlo:

      Clic derecho (o Control + clic) en INSTALAR.command  >  Abrir
      y en el aviso, otra vez  "Abrir"

   Si no te aparece ese botón "Abrir" (pasa en las versiones nuevas de
   macOS), es por el otro camino:

      Ajustes del sistema  >  Privacidad y seguridad
      baja hasta "Seguridad": dirá que se bloqueó INSTALAR.command
      pulsa  "Abrir de todos modos"

   Se hace una sola vez. El acceso del escritorio ya no lo pregunta.

2. Te pregunta dónde instalar. Pulsa Enter.

3. Al terminar aparece en el escritorio  "Tutor Okirys".


·· LINUX ··

1. Abre una terminal en esta carpeta y escribe:

      bash INSTALAR.sh

2. Te pregunta dónde instalar. Pulsa Enter.

3. Al terminar aparece en el escritorio  "Tutor Okirys". La primera vez tu
   escritorio puede pedir "Permitir ejecutar": acepta.


(En los tres: no abras nada de la carpeta "programa". La usa el instalador.)


LA PRIMERA VEZ QUE LO ABRES
---------------------------

Paso 1 · Tu licencia
   Escribe la licencia que te entregaron. Tiene esta forma:

        TUTOR-XXXX-XXXX

   Da igual si la escribes en minúsculas o con espacios.
   Necesita internet SOLO en este momento. Después funciona sin conexión.

   Si dice que la licencia "ya está usada": es para un número fijo de
   computadores (normalmente uno). Escríbele a quien te la vendió y te la
   libera.
   Si dice "no es válida": revísala letra por letra. Las licencias nunca
   llevan O ni 0, ni I ni 1, justo para que no se confundan. Si sigue sin
   entrar, pídesela de nuevo a quien te la vendió.

Paso 2 · La inteligencia artificial
   Hay dos caminos y los dos pueden salir gratis. Elige uno.

   a) CON UNA CLAVE EN INTERNET  (lo más fácil, y va en cualquier equipo)

      Groq, Google Gemini y Cerebras tienen plan gratuito y NO piden
      tarjeta. El tutor ya trae su dirección: solo eliges el proveedor en
      la lista y pegas la clave.

      Cómo sacar la clave de Groq, que es la más rápida de conseguir:
         1. Entra a console.groq.com con tu cuenta de Google.
         2. API Keys  >  Create API Key.
         3. Copia la clave (empieza por "gsk_") y pégala en el tutor.

      Gemini:    aistudio.google.com/apikey
      Cerebras:  cloud.cerebras.ai  >  API Keys

      Tu clave se guarda SOLO en tu computador. No pasa por ningún
      servidor nuestro: va de tu navegador al proveedor y ya.

   b) EN TU PROPIO COMPUTADOR  (LM Studio)

      Gratis y para siempre, y tu temario no sale de tu equipo. A cambio
      son unos 2 GB de descarga y pide un computador con algo de fuerza:
      en uno justo va lento. Instálalo de lmstudio.ai, descarga el modelo
      gemma-3-4b y enciende el servidor así:

            lms server start --cors

      Sin el "--cors" el tutor no lo encuentra.

Paso 3 · Tus PDF
   Carga los PDF de tus materias (temarios, presentaciones, apuntes) y pulsa
   Generar. Es el paso largo: 10 a 20 minutos por materia.
   Al terminar, el tutor se abre con tus lecciones.


TUS TRABAJOS
------------

En la columna de la izquierda, al final: "+ Nuevo trabajo".
Carga el PDF con las instrucciones de la actividad (o pega el enunciado) y
el tutor arma la estructura: cada parte con lo que pide el profesor y por
dónde empezar. Tú escribes cada parte; con "Revisar lo que llevo" la IA te
dice qué le falta. Al terminar, "Ver documento y exportar" lo baja en PDF o
Word con portada APA. Todo se guarda solo mientras escribes.


SI ALGO NO VA
-------------

· La IA no responde  ->  cierra LM Studio y vuelve a arrancarlo con
                         lms server start --cors
· Cambió algo y se ve igual  ->  pulsa Ctrl+F5 una vez.
· Pantalla en blanco  ->  vuelve a ejecutar el instalador de tu sistema
                         (INSTALAR.bat, INSTALAR.command o INSTALAR.sh).
                         No borra lo que ya cargaste ni gasta otra licencia:
                         reinstalar conserva tu temario y tu activación.
