Operativa

Tu configuración

Teacher separa quién genera (proveedor / perfil global) de cómo se comporta la asignatura (course.config.yml). Los secretos no van en el YAML del curso.

Global (profesor)

~/.config/teacher-cli/profile.yml
~/.config/teacher-cli/credentials.env (modo 600)

Por asignatura

course.config.yml en la carpeta del curso
data/asignaturas/<id>/store.db

1. Setup

Configura proveedor, modelo y, opcionalmente, guarda credenciales cifradas o en fichero local según el wizard.

setup

# Interactivo (requiere TTY)
teacher setup

# No interactivo: la clave se lee de la variable de entorno del proveedor
export NAN_API_KEY=...
teacher setup --proveedor nan --modelo qwen3.6

export ANTHROPIC_API_KEY=...
teacher setup --proveedor anthropic --modelo claude-opus-4-7

2. Perfiles de asignatura

El campo perfil de course.config.yml agrupa qué claves se consideran “completas” en teacher status.

Perfil	Cuándo	Claves habituales
`nan`	Solo NaN (OpenAI-compatible)	`NAN_API_KEY`
`frontier`	Proveedores de pago por token	`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `GOOGLE_API_KEY`, `VOYAGE_API_KEY`
`ollama`	Ollama Cloud principal	`OLLAMA_API_KEY`
`hybrid`	Mezcla frontier + Ollama	Depende de la mezcla; status exige al menos Anthropic + Voyage en la comprobación actual

cambiar perfil del curso

teacher config --clave perfil --valor nan
teacher config --check
teacher status

3. Proveedores y variables

Proveedor	Variable	Notas de producto
NaN	`NAN_API_KEY`	Base `https://api.nan.builders/v1`. Lista multimodales `qwen3.6`, `gemma4`.
Anthropic	`ANTHROPIC_API_KEY`	Modelos Claude de la cuenta.
OpenAI	`OPENAI_API_KEY`	Modelos GPT disponibles.
Google Gemini	`GOOGLE_API_KEY`	Canónica; no uses solo `GEMINI_API_KEY` en config de curso.
Ollama Cloud	`OLLAMA_API_KEY`	Modelos cloud del proveedor.
OpenRouter	`OPENROUTER_API_KEY`	Enrutado multi-modelo.
Voyage (embeddings)	`VOYAGE_API_KEY`	Opcional si no usas embeddings locales.

4. `course.config.yml` mínimo

ejemplo válido

schemaVersion: "1"
asignatura:
  id: ia-101
  nombre: Inteligencia Artificial
idioma: es-ES
idiomaSalida: es
perfil: nan
calidad:
  evaluar: true
presentacion:
  institucion: Universidad Demo
  docente: Dra. Ada Lovelace
  materia: Inteligencia Artificial

idioma es el administrativo del curso (es-ES).
idiomaSalida es es o en para materiales nuevos.
calidad.evaluar activa rúbrica post-generación (side-car .calidad.json).
Validar sin tocar nada: teacher config --check.

edición validada

teacher config --clave institucion --valor "Universidad Demo"
teacher config --clave idioma-salida --valor en
teacher config --clave perfil --valor nan

5. Perfil global (`profile.yml`)

Generado por setup. Ejemplo con NaN activo:

~/.config/teacher-cli/profile.yml

version: 1
profesor:
  nombre: Docente
  idioma: es-ES
proveedores:
  nan:
    activo: true
    modelo_default: qwen3.6
    base_url: https://api.nan.builders/v1
    env_var_clave: NAN_API_KEY
cifrado_reposo:
  activado: false

6. Comprobaciones diarias

`teacher status`

Paquetes, claves (presencia, nunca valor), índice, vectorización, temas.

exit ≠ 0 si el perfil actual no tiene claves completas

`teacher doctor`

Nativos SQLite, handshake al proveedor, herramientas de export, TTY, permisos de config.

avisos no bloqueantes (LibreOffice, no-TTY)

7. Herramientas opcionales de export

Formato	Dependencia externa
Markdown / HTML / JSON	Ninguna
PDF / DOCX / LaTeX	Pandoc, LaTeX o LibreOffice según ruta
Ingesta PPTX	LibreOffice (`soffice`)

Privacidad Las claves no deben ir a git ni a capturas. Resumen práctico en Privacidad.