Nada de magia: datos, modelos y oficio
Qué hay debajo de cada audioguía, sin humo.
Detrás de cada audioguía hay un catálogo cuidado, un buscador que encuentra el dato exacto y un modelo al que se le dice qué puede decir. Esto es lo que hay debajo: cómo está montado, de dónde salen los datos y qué nota quien lleva el móvil en la mano.
Arquitectura: dos cerebros que se hablan
La web y la inteligencia artificial no viven en el mismo sitio, y es a propósito. Un modelo pensando durante medio minuto no puede dejar colgada la página que alguien está leyendo, así que cada uno tiene su servidor y su ritmo.
El panel y las webs
PHP 8.2 sobre MySQL 8. Es donde se mantiene el catálogo, se publican las webs de cada cliente y se sirve la guía. Sin frameworks pesados: código directo, que se lee y se arregla rápido.
El cerebro de IA
Un servicio aparte en Python con FastAPI. Recibe la pregunta, busca el contexto y habla con el modelo. Va separado a propósito: si la IA se atasca, la web sigue en pie.
Dos memorias
MySQL guarda los hechos —qué monumento, qué horario, qué feria—. PostgreSQL con pgvector guarda el significado: los documentos del gestor troceados y convertidos en vectores para que el guía los encuentre.
Todo en contenedores
Docker por delante de nginx, con el modelo local corriendo en la misma máquina. Un despliegue es reconstruir y levantar; lo que se toca a mano va montado desde fuera para no tener que reconstruir por un cambio de configuración.
Inteligencia: un guía que no se inventa las cosas
El problema de un modelo de lenguaje suelto es que rellena los huecos con lo que le suena bien. Aquí no se le deja: antes de escribir nada, se busca el dato en el catálogo y en los documentos que ha subido el gestor, y se le entrega junto a la pregunta. Si no hay contexto, no hay respuesta inventada.
Las instrucciones tampoco están enterradas en el código. Viven en base de datos y se editan desde el panel, con un probador al lado que enseña el resultado con un punto de interés real antes de publicar el cambio.
Motores en servicio ahora mismo
- DeepSeek V4 Flash (nube) En la nube del proveedor
- Kimi K3 · NVIDIA NIM (nube) En la nube del proveedor
- Qwen 2.5 14B (local) En nuestro servidor
- Qwen 2.5 VL 7B (local, visión) En nuestro servidor
Lo que se escribe a un motor en la nube sale de nuestros servidores. Está contado en la política de protección de datos.
Cómo nace una audioguía
Los datos: de dónde sale lo que se cuenta
El catálogo no se escribe a mano ni se lo inventa un modelo: se importa de fuentes abiertas, se cruza y se comprueba. La IA llega después, para contarlo bien.
Wikidata
Consultas SPARQL para sacar monumentos, iglesias y museos con sus coordenadas e identidad estable.
OpenStreetMap
Overpass para lo que Wikidata no tiene: miradores, fuentes, comercios y servicios.
Google Places
Horarios y datos de contacto, fusionados con lo anterior por cercanía y nombre.
Commons y Europeana
Fotografías con licencia comprobada y material histórico de archivo.
INE
El censo completo de municipios y entidades de población, que es el esqueleto de la prospección.
Fiestas y ferias
Programas de fiestas rastreados, y programas en PDF leídos y troceados en actos.
Cada fuente conserva su licencia y se cita en el aviso legal.
En el móvil: lo que el visitante nota
Toda la tecnología de arriba sólo sirve si al final alguien pasea por una ciudad y entiende lo que está viendo. Esto es lo que llega a su mano.
Aplicación web instalable
Se entra desde el navegador y se puede dejar en la pantalla de inicio. Sin tienda de aplicaciones, sin descarga y con un service worker que guarda lo básico para cuando la cobertura falla.
Cámara que reconoce
Apuntas a un monumento y un modelo de visión dice cuál es. La posición acota los candidatos, así que no tiene que acertar entre miles sino entre los que tienes delante.
Preguntar hablando
La pregunta se dicta en vez de escribirse: si el navegador sabe transcribir lo hace él, y si no, se manda el audio al servidor.
Llegar y que suene
Cada punto tiene su geovalla. Al entrar en ella la audioguía arranca sola, sin sacar el móvil del bolsillo.
En su idioma
El guion se traduce y se guarda por idioma, con un control que sabe si el original ha cambiado. En las salas de grupo cada uno lee en el suyo.
Visitas en grupo
Una sala reparte la orden, no el audio: cada móvil reproduce lo suyo, sincronizado y con corrección de reloj.
Mapas: caminar por calles, no por líneas rectas
El mapa se dibuja con MapLibre sobre teselas de OpenFreeMap, que a su vez vienen de OpenStreetMap. Un solo dibujo para todo: el portal, la guía y las webs de cada cliente encienden y apagan capas, pero el código del mapa es el mismo.
Para ir de un punto a otro no vale la línea recta: un motor de rutas devuelve el camino a pie de verdad, con sus calles y sus cuestas. Y como el camino más corto no siempre es el mejor, los tours pueden llevar puntos de paso que obligan a pasar por donde merece la pena. Los tramos ya calculados se guardan y se heredan entre paradas.
MapLibre
Mapa vectorial, sin licencia por vista
Capas
Turismo, feria, transporte y hostelería
Rutas a pie
Tramos reales, cacheados y reutilizados
Geovallas
Llegar a un punto dispara su audioguía
¿Lo vemos con tu destino?
La forma más rápida de entenderlo es probarlo: abre la guía y camina, o escríbenos y lo montamos con los puntos de tu municipio o tu feria.