Plugins con IA · Medio
Crear plugins de QGIS 4 con IA: QGIS Plugin Generator
Instalación, uso y validación del generador de plugins de Bernabé.
Por Bernabé Hinojosa · Actualizado el 21/10/2026
El QGIS Plugin Generator convierte una descripción en lenguaje natural en un plugin de QGIS 4 instalable. Funciona como skill de un agente de IA (Claude Code, Codex u otro): el agente lee la guía, elige la plantilla, escribe el código, lo valida y lo empaqueta.
Qué necesitas
- QGIS 4.x (probado en 4.0.2), que usa PyQt6.
- Python 3.9+ para el validador, sin instalar paquetes.
- Un agente de IA con acceso a tus archivos.
Instalación
- Clona el repositorio:
git clone [enlace para miembros] - Claude Code: crea
~/.claude/skills/qgis-plugin-generator/SKILL.mdque indique leerskill/GUIA.mddel repositorio. El README trae el texto exacto. - Codex: abre la carpeta del repositorio y ya está. Codex lee
AGENTS.md, que le manda a la guía. - Sin agente:
skill/GUIA.mdestá escrita para que también la lea una persona.
Uso en cuatro pasos
- Describe el plugin: "quiero un plugin que recorra las capas vectoriales, cuente sus entidades y lo exporte a CSV".
- Responde 2 o 3 preguntas: nombre, si crea una capa nueva o edita la existente, si un parámetro es fijo.
- El agente genera y valida en
output/<nombre>/. Si falla, corrige y repite hasta 3 intentos. Si no lo consigue, para y explica el bloqueo. - Instala el .zip: Complementos › Administrar e instalar › Instalar a partir de ZIP.
Los cinco patrones
| Patrón | Cuándo | Dónde aparece |
|---|---|---|
| processing-algorithm | Entrada → cálculo → salida. El preferido. | Caja de herramientas de Procesamiento |
| layer-processor | Botón propio con diálogo | Barra de herramientas y menú |
| map-tool | Clicar, dibujar o medir en el mapa | Barra de herramientas y menú |
| dock-widget | Panel lateral persistente | Ver › Paneles |
| api-caller | Consultar un servicio web | Según el diseño |
Elegir processing-algorithm da gratis el historial, los procesos por lotes, el uso en el Modelador gráfico y la ejecución con qgis_process.
Qué detecta el validador
- Enums sin cualificar y API de PyQt5 que ya no existe.
initGui()que añade cosas queunload()no quita, y señales que nunca se desconectan.- Acceso a la interfaz desde un hilo secundario (
QgsTask.run()). - Bucles en
processAlgorithm()que no compruebanfeedback.isCanceled(). - Algoritmos sin
createInstance(),metadata.txtincompleto y marcadores de plantilla sin sustituir. - Sintaxis, nombres no definidos e imports sin usar.
Está calibrado contra los plugins que trae QGIS (MetaSearch, Processing, DB Manager, GRASS) para evitar falsos positivos. build_zip.py crea el ZIP con una única carpeta raíz, que es lo que QGIS exige.
Para desarrollar más rápido
- Enlaza la carpeta del plugin al perfil de QGIS con un enlace simbólico y usa Plugin Reloader: recargas en segundos sin reiniciar QGIS.
- Añade tus errores nuevos a
skill/reference/common-errors.mdy tus plugins aexamples/: el agente copiará tus convenciones.
Límites conocidos
La lógica de los algoritmos se puede probar fuera de QGIS. La interfaz gráfica no se prueba automáticamente: revisa siempre el plugin dentro de QGIS antes de darlo por bueno.
Licencia MIT. Si publicas un plugin en el repositorio oficial de QGIS, necesitará licencia GPL-2.0-or-later.
El resto de esta guía es para miembros de Giseros. Crear la cuenta es gratis y tarda 5 segundos.
Crear cuenta gratis