Recorrido

Cómo funciona

Primero dejas Teacher listo en tu ordenador. Luego le das el temario de la asignatura y pides el material del tema. El orden importa: sin temario leído no puede citar el PDF.

Instalar y comprobar

Necesitas Node.js 22.x. Tras instalar, abre una terminal nueva si teacher no aparece en el PATH.

Comprobación rápida

teacher --version
teacher doctor
teacher status

doctor valida binarios nativos (SQLite), el proveedor y la escritura de la configuración global.

Setup de proveedor

Escribe el perfil global en ~/.config/teacher-cli/profile.yml y, si aceptas, las claves en credentials.env (permisos 600).

Modo no interactivo

export NAN_API_KEY=tu_clave
teacher setup --proveedor nan --modelo qwen3.6

Detalle de perfiles y variables en Configuración.

Onboard de asignatura

Crea la carpeta de trabajo y course.config.yml. El perfil de la asignatura se infiere del setup global si no pasas --perfil.

Crear asignatura

mkdir -p ~/cursos/ia && cd ~/cursos/ia
teacher onboard \
  --asignatura-id ia-101 \
  --asignatura-nombre "Inteligencia Artificial" \
  --institucion "Universidad Demo" \
  --docente "Dra. Ada Lovelace"

Importante Nunca pongas claves de API dentro de course.config.yml. Teacher lo rechaza.

Ingest del temario

Lee PDFs, Markdown, HTML, notebooks, código y más. Construye el store.db local bajo data/asignaturas/<id>/.

Ingesta de temario

teacher ingest --origen ~/Temario-IA --asignatura-id ia-101

Se omiten carpetas ocultas (.git, .claude) y basura tipo node_modules.
Las figuras de PDF se inventarían; sin clave de visión no hay descripciones automáticos.
La primera ingesta de un temario grande puede tardar varios minutos.

Reindex / vectores

Calcula embeddings locales (por defecto MiniLM multilingüe 384-d) para búsqueda semántica. No borra el temario.

Vectorización

teacher reindex --asignatura-id ia-101
teacher status --asignatura-id ia-101

En status debes ver algo como Vectorización: N/N fragmentos.

Taxonomía de temas

Propón temas a partir del corpus (determinista por PDF/tema, o con --llm true) y revísalos.

Taxonomía de temas

teacher propose-topics --asignatura-id ia-101
teacher review-topics

Generar materiales

Elige un tema y un artefacto. Usa --require-llm si no quieres plantilla de respaldo. Usa --output-dir o --salida para guardar ficheros.

Generar materiales

teacher preparar-tema "Tema 2. Busqueda" --output-dir out --require-llm
teacher diapositivas "Tema 2. Busqueda" --output-dir out --html
teacher generar-laboratorio "Tema 6. Aprendizaje supervisado" --output-dir out

Catálogo con nombre de producto y comando: Materiales. Listado completo: Comandos directos. En el menú: escribe configurador.

Revisar y exportar

Abre el HTML, mira la sección de evidencias y la auditoría docente. Exporta a otros formatos si hace falta.

Revisar y exportar

teacher visor-rag --asignatura-id ia-101
teacher export-html out --output-path out/index.html
teacher cost

Menú guiado y comandos directos

Si prefieres no memorizar flags: ejecuta teacher sin argumentos en una terminal interactiva (TTY). El menú propone setup, onboard, ingest, reindex y generación por pasos.

En entornos sin TTY (CI, algunos agentes) usa siempre comandos directos (teacher preparar-tema …, teacher diapositivas …, etc.). Tabla completa y flags en Comandos directos.