Tipo es un asistente local de IA para apoyar la precatalogación de monografías impresas modernas. A partir de imágenes, PDF, DOCX o textos facilitados por el usuario, extrae datos bibliográficos observables y propone una descripción estructurada para revisión profesional.
Sube uno o varios libros, revisa la propuesta bibliográfica y exporta los resultados en MARCXML, MARC21 texto, ISBD, JSON o CSV, sin enviar los documentos a servicios externos.
Versión actual: 0.3.0-beta.1
Estado: beta, apta para entornos profesionales con supervisión.
Ámbito: monografía moderna impresa.
Modelo de uso: local-first, con Docker y Ollama.
Tipo es una aplicación independiente. Reutiliza componentes técnicos locales y de seguridad desarrollados previamente, pero no es un fork de otro repositorio ni conserva lógica archivística ajena a su finalidad bibliográfica.
- Analizar un libro individual a partir de PDF, imágenes, DOCX o texto.
- Procesar lotes de libros en una sola operación.
- Trabajar con tres modos de subida:
- Un solo libro: varias páginas o imágenes de un mismo título.
- Varios libros — uno por fichero: un PDF o fichero por cada libro.
- Varios libros — uno por ZIP: un ZIP por libro, con varias imágenes o documentos dentro.
- Revisar una propuesta bibliográfica antes de exportarla.
- Consultar una vista ISBD generada automáticamente.
- Exportar registros en:
- MARCXML;
- MARC21 texto;
- ISBD;
- JSON;
- CSV;
- ZIP de lote con los resultados por libro y la colección agregada.
- Usar modelos locales descargados en Ollama.
- Mantener los documentos en el propio equipo del usuario, sin consultas automáticas a servicios externos.
- Funcionamiento local-first mediante Docker y Ollama.
- Publicación por defecto solo en
127.0.0.1/localhost. - Sin envío de documentos a plataformas comerciales en la nube.
- Sin consultas automáticas a catálogos externos.
- Sin creación de puntos de acceso autorizados.
- Sin asignación de materias normalizadas.
- Sin integración ni escritura directa sobre SIGB externos.
- Resultado siempre revisable por un profesional.
- Autenticación local con usuario y contraseña.
- Exportación orientada a reutilización profesional, especialmente mediante MARCXML y MARC21 texto.
Tipo está orientado a la catalogación asistida de monografías impresas modernas. No está optimizado para manuscritos, fondo antiguo, publicaciones seriadas ni recursos electrónicos.
En esta versión, el flujo principal se ha ampliado desde el análisis de un libro individual al tratamiento por lotes. Esto permite subir colecciones completas de libros y obtener resultados separados por cada obra, junto con exportaciones agregadas del conjunto.
La aplicación analiza zonas bibliográficamente relevantes —especialmente preliminares y partes finales— y evita enviar el cuerpo completo del libro al modelo cuando no es necesario. El objetivo es reducir carga, tiempo de procesamiento y ruido documental.
La salida incluye propuesta descriptiva, vista ISBD, JSON, CSV, MARC21 TXT y MARCXML. En 0.3.0-beta.1 se refuerza la calidad estructural de los registros MARC21 mediante la generación de campos y normalizaciones más adecuados para importación en SIGB.
La mejora principal de esta versión es la posibilidad de procesar varios libros en una sola operación.
El usuario puede elegir entre tres modos de subida:
- Un solo libro: útil cuando se aportan varias páginas o imágenes de una misma obra.
- Varios libros — uno por fichero: útil cuando cada PDF o documento corresponde a un libro distinto.
- Varios libros — uno por ZIP: útil cuando cada libro está formado por varias imágenes o documentos agrupados en un ZIP independiente.
Durante el procesamiento, Tipo muestra un navegador de lote con indicadores por libro: pendiente, en curso, listo, error o cancelado. También permite moverse entre libros mediante los chips numerados de la interfaz y con las teclas de dirección izquierda/derecha.
Cuando el primer resultado está disponible, ya se pueden descargar exportaciones del lote. El ZIP completo incluye una carpeta por libro y una colección agregada.
A partir de esta versión, los registros generados incluyen mejoras estructurales relevantes:
- campo
008de 40 caracteres; - campo
041cuando procede; - limpieza de puntuación ISBD dentro de subcampos MARC;
- normalización de la mención de edición a forma RDA;
- indicadores
245y264configurados de forma más adecuada; - subcampos más limpios para facilitar la importación y revisión posterior.
La validación realizada hasta esta beta es estructural. Es decir, se ha comprobado que los registros cumplen requisitos formales más sólidos respecto a la beta anterior. La validación funcional contra instalaciones reales de SIGB queda pendiente para una versión posterior.
Tipo no sustituye el trabajo catalográfico profesional. En particular:
- No crea puntos de acceso autorizados
1XX,6XXo7XX. - No consulta catálogos externos ni ficheros de autoridades.
- No asigna materias normalizadas.
- No valida autoridades personales, corporativas o de materia.
- No escribe directamente en Koha, Aleph, Symphony, Absys NET u otros SIGB.
- No convierte automáticamente una propuesta en un registro definitivo.
El profesional debe revisar, corregir, completar y validar los resultados antes de incorporarlos a cualquier catálogo.
Para usuarios no técnicos, descargue y descomprima el .zip de la release. Después ejecute:
Instalar Tipo.bat
Se abrirá una ventana desde la que se puede:
- instalar o actualizar Tipo;
- iniciar la aplicación;
- detener la aplicación;
- desinstalar contenedores y volúmenes;
- abrir Tipo en el navegador;
- consultar estado y logs;
- recuperar el acceso de administrador si se pierde la contraseña.
El instalador comprueba Docker Desktop. Si Docker no está instalado o no está arrancado, muestra instrucciones y detiene la instalación. También comprueba si hay Ollama nativo en localhost:11434. Si lo detecta, utiliza ese Ollama; si no lo detecta, usa Ollama dentro de Docker como instalación autocontenida.
chmod +x instalar.sh detener.sh desinstalar.sh
./instalar.shLa aplicación se abre por defecto en:
http://localhost:8082
En macOS, Docker Desktop debe estar instalado y en ejecución. Ollama nativo es opcional; si no existe, Tipo puede usar Ollama dentro de Docker.
Si ya se utilizaba la versión 0.2.0-beta.7, puede actualizarse sin migración manual de datos.
- Detenga el servicio:
docker compose down- Sustituya el código por la nueva release o ejecute de nuevo el instalador.
- Arranque la aplicación:
docker compose up -d- En el primer arranque deberían aparecer mensajes similares a estos en los logs:
INFO app.lotes: Recuperación de arranque: 0 items pendientes reencolados
INFO app.lotes: Worker de lotes iniciado
- Refresque el navegador con Ctrl + F5 en Windows/Linux o Cmd + Shift + R en macOS.
No hace falta migrar datos. Las tablas de lote se crean en el mismo SQLite y los result.json antiguos siguen siendo válidos.
En el primer acceso, Tipo solicita crear un usuario administrador local. La contraseña no se guarda en claro: se almacena como hash PBKDF2-HMAC-SHA256 en el volumen local tipo-data.
La autenticación está pensada como capa adicional para instalaciones personales o locales. No convierte Tipo en una aplicación multiusuario institucional lista para exposición en red. Para exponerla fuera de localhost habría que añadir controles adicionales: TLS, reverse proxy, política de usuarios, copias de seguridad, registros de auditoría, endurecimiento de infraestructura y revisión de riesgos.
La configuración local se crea desde .env.example y queda en .env. El fichero .env está excluido del repositorio y no debe publicarse.
Variables principales:
PUERTO=8082
MODELO_BASE=gemma4:e4b
MODELO_NOMBRE=gemma4:e4b
TIPO_CREAR_MODELO_DERIVADO=false
TIPO_AUTH_DISABLED=false
ALLOW_REMOTE_OLLAMA=false
ALLOW_NETWORK_EXPOSURE=false
PERMITIR_APAGADO_UI=true
Variables opcionales para procesamiento por lotes:
TIPO_MAX_LIBROS_LOTE=50
TIPO_MAX_BYTES_LOTE=2147483648
TIPO_LOTE_REINTENTOS_MAX=1
TIPO_LOTE_DIR=/app/data/batches
TIPO_LOTE_ZIP_MAX_ENTRADAS=60
TIPO_LOTE_ZIP_MAX_DESCOMPRIMIDO=209715200
TIPO_LOTE_ZIP_MAX_RATIO=100La lista desplegable de modelos muestra los modelos ya descargados en Ollama. La imagen Docker de Ollama está fijada por digest en .env.example y docker-compose.yml. En Windows, el instalador resuelve automáticamente la imagen base python:3.12-slim a digest y la guarda en .env antes de construir la imagen, sin intervención del usuario final.
| Componente | Estado en 0.3.0-beta.1 |
|---|---|
| Ollama | Sin cambios. Compatible con gemma4:e4b y modelos equivalentes con visión. |
| Docker Compose | Sin cambios estructurales. El volumen tipo-data cubre /app/data/batches. |
| Esquemas | Sin cambios. marc21-monografias sigue siendo el perfil principal. |
| API existente | /api/describir y el resto de endpoints anteriores siguen funcionando. |
| Auditoría | Idéntica por libro; el lote no añade todavía eventos agregados propios en security_events. |
Tipo debe ejecutarse como herramienta local. La publicación Docker queda limitada a 127.0.0.1. No active ALLOW_NETWORK_EXPOSURE=true salvo que vaya a añadir controles adicionales de autenticación, red y cifrado.
Antes de subir cambios al repositorio, ejecute:
scripts/comprobar_antes_de_subir.shEn Windows puede ejecutar:
scripts\comprobar_antes_de_subir.bat
El proyecto incorpora medidas de higiene y revisión como .dockerignore, scripts de comprobación, auditoría de dependencias, generación de SBOM y política de actualización de dependencias.
Una prueba básica de 0.3.0-beta.1 consiste en subir dos PDF en modo Varios libros — uno por fichero.
El comportamiento esperado es:
- Tipo crea el lote mediante
POST /api/lote. - La interfaz muestra un navegador con dos chips numerados.
- Cada chip muestra el estado de su libro: pendiente, en curso, listo, error o cancelado.
- Al terminar el primer libro, se renderiza automáticamente su propuesta revisable.
- El segundo libro puede consultarse desde su chip correspondiente.
- El selector de descarga de lote aparece cuando hay al menos un libro listo.
- El ZIP descargado contiene una carpeta por libro y la colección agregada.
- El procesamiento real sigue siendo secuencial en CPU, condicionado por Ollama. Subir diez libros no hace que el proceso sea diez veces más rápido; hace que sea más cómodo y automatizado.
- Si Ollama supera el timeout configurado en
TIPO_TIMEOUT_LLM, ese libro queda en estadoerrory el lote continúa con el siguiente. - Todavía no hay reintento automático completo para errores transitorios de Ollama.
- La caché del navegador puede mantener cargada una versión anterior del frontend. Tras actualizar, conviene forzar recarga con Ctrl + F5 o Cmd + Shift + R.
- La validación MARC21 es estructural. La prueba funcional en SIGB reales debe realizarse antes de usar los registros en producción.
El prompt usado para solicitar la extracción bibliográfica al modelo local puede revisarse en:
docs/PROMPT_MODELO_TIPO.md
0.3.x: reintentos automáticos para errores transitorios de Ollama.0.3.x: eventoslote_inicioylote_finensecurity_events.0.3.x: tests adicionales del worker de lotes, incluyendo cancelación durante un ítem, reentrada tras interrupción y consistencia de agregados.0.4.x: perfiles adicionales, como publicaciones seriadas y recursos electrónicos.0.4.x: exploración de exportación o integración mediante Z39.50 / SRU.
Autoría y desarrollo conceptual: Víctor Villapalos.
© 2026 Víctor Villapalos.