Este artículo puede contener enlaces de afiliado. Si compras desde estos enlaces, el precio para ti es el mismo y la tienda me paga una pequeña comisión que ayuda a mantener Tecnoyfoto.
Puedes utilizar Home Assistant durante mucho tiempo sin escribir YAML a mano. La interfaz permite instalar integraciones, crear automatizaciones y configurar gran parte de una casa conectada. Sin embargo, tarde o temprano aparece un ejemplo que solo se entiende al abrir la vista YAML, una automatización que necesita un ajuste preciso o un error cuya explicación señala una clave y una línea concreta.
Este curso empieza exactamente ahí. No pretende enseñarte YAML para Docker, Kubernetes o Ansible, ni convertirte en programador. Su objetivo es que aprendas el YAML que realmente aparece en Home Assistant y que termines pudiendo leerlo, modificarlo, organizarlo y encontrar errores sin probar cambios a ciegas.
El recorrido está formado por doce capítulos que avanzan sobre una misma casa virtual. Cada concepto nuevo se apoya en lo que ya has aprendido, los ejemplos se pueden ejecutar y los ejercicios incluyen una solución explicada. No tendrás que reunir fragmentos inconexos ni adaptar desde el primer día sensores que quizá no tienes.
Qué serás capaz de hacer al terminar
El objetivo no es que memorices una colección de claves. Al completar el proyecto final deberías poder abrir una automatización o un script y reconstruir su estructura: reconocer qué lo inicia, qué condiciones comprueba, qué acciones ejecuta y qué entidades utiliza.
También aprenderás a distinguir problemas que a menudo se mezclan. Una indentación incorrecta pertenece a YAML; una acción inexistente pertenece a la configuración de Home Assistant; una expresión dinámica puede fallar en Jinja; y una automatización perfectamente válida puede tener un error de lógica. Saber en qué capa estás trabajando evita muchas correcciones al azar.
Durante el curso pasarás de leer bloques pequeños a construir automatizaciones con condiciones, decisiones, esperas y scripts reutilizables. Después añadirás plantillas y variables seguras, organizarás una configuración que ha crecido y utilizarás las herramientas de diagnóstico de Home Assistant para comprobar qué ocurrió realmente.
Una casa virtual para practicar sin comprar dispositivos
Todos los capítulos utilizan el mismo entorno de práctica. El laboratorio crea una puerta, una luz, un sensor de movimiento, una temperatura, un ventilador, presencia en casa y un modo nocturno virtuales. Unos controles internos permiten cambiar sus estados desde Home Assistant, de modo que puedes abrir la puerta, simular movimiento o elevar la temperatura cuando un ejercicio lo necesite.
Esto hace que el resultado sea reproducible. Si una automatización no funciona, sabrás que las entidades del ejemplo existen y podrás concentrarte en su estructura o en su lógica. Si prefieres emplear dispositivos reales, también podrás hacerlo sustituyendo cada entity_id, pero no será un requisito para seguir el curso.
El archivo descargable incluye la guía de instalación en castellano y en inglés. Antes de copiarlo, crea una copia de seguridad, no sustituyas tu configuration.yaml y valida siempre la configuración antes de reiniciar.
Cómo está organizado el curso
Los capítulos no son doce artículos independientes colocados bajo una misma etiqueta. Forman una secuencia. Los primeros te enseñan a leer YAML; los siguientes trasladan esa lectura a entidades, automatizaciones y scripts; después aparecen Jinja, las variables, la organización y el diagnóstico. El último capítulo reúne todo en un proyecto que tendrás que poder probar y explicar.
Se publicará un capítulo nuevo cada viernes a las 17:00. La portada se irá actualizando para enlazar únicamente los capítulos que ya estén disponibles, de manera que nunca te enviará a una página todavía no publicada.
Capítulo 1 — YAML en Home Assistant desde cero: qué necesitas aprender de verdad
Antes de estudiar sintaxis, separarás YAML de Home Assistant y de Jinja. Verás cuándo conviene utilizar la interfaz, cuándo merece la pena leer YAML y qué partes del lenguaje puedes dejar fuera. También instalarás y comprobarás la casa virtual que acompañará todo el recorrido.
Disponible el 4 de septiembre. Ir al capítulo 1.
Capítulo 2 — Aprende a leer YAML sin memorizarlo
Aprenderás a reconocer claves, valores, listas y mapas utilizando la indentación como un mapa visual de la estructura. Trabajarás con cadenas, números, booleanos, valores vacíos y comentarios, y corregirás un bloque roto para entender por qué un espacio puede cambiarlo todo.
Disponible el 11 de septiembre.
Capítulo 3 — Cómo entiende Home Assistant tu casa
YAML ya no aparecerá como una estructura abstracta. Relacionarás dominios, entity_id, estados, atributos y acciones con las entidades de la casa virtual. La finalidad es que puedas leer un ejemplo y saber qué partes debes adaptar antes de ejecutarlo.
Disponible el 18 de septiembre.
Capítulo 4 — Tu primera automatización en YAML, línea por línea
Construirás desde la interfaz una automatización que enciende la luz al abrir la puerta y después leerás su YAML completo. Verás qué función cumplen triggers, conditions, actions, target, mode y cada nivel de la estructura sin convertir la explicación en una enumeración de campos.
Disponible el 25 de septiembre.
Capítulo 5 — Condiciones y choose: consigue que la automatización decida
La automatización dejará de responder siempre de la misma manera. Comprobará si es de noche, si hay alguien en casa y cuánto tiempo lleva cumpliéndose un estado. Después utilizará choose para seleccionar comportamientos distintos sin duplicar automatizaciones enteras.
Disponible el 2 de octubre.
Capítulo 6 — Retrasos, esperas y modos de ejecución
Aprenderás la diferencia entre retrasar una acción, esperar a que cambie un estado y limitar esa espera con un tiempo máximo. También provocarás ejecuciones solapadas para entender por qué single, restart, queued y parallel pueden cambiar el resultado aunque las acciones sean las mismas.
Disponible el 9 de octubre.
Capítulo 7 — Scripts: reutiliza acciones sin duplicar YAML
Extraerás una secuencia repetida y la convertirás en una rutina reutilizable para preparar el salón. Compararás una llamada directa con script.turn_on, añadirás campos de entrada y decidirás cuándo un script aclara la configuración y cuándo solo la fragmenta.
Disponible el 16 de octubre.
Capítulo 8 — YAML y Jinja no son lo mismo
Llegados a este punto podrás añadir valores dinámicos sin confundir las capas. Aprenderás a reconocer {{ }} y {% %}, leer estados y atributos, probar una plantilla y utilizar filtros sencillos. YAML seguirá definiendo la estructura; Jinja calculará el valor que Home Assistant necesita.
Disponible el 23 de octubre.
Capítulo 9 — Variables y plantillas que no se rompen
Trabajarás con estados como unknown y unavailable, conversiones numéricas y valores predeterminados. Guardarás una lectura y la reutilizarás de forma coherente, controlarás el alcance de las variables y evitarás que una temperatura todavía no disponible produzca una decisión incorrecta.
Disponible el 30 de octubre.
Capítulo 10 — Ordena Home Assistant antes de que el YAML se vuelva inmanejable
Abrirás configuration.yaml, automations.yaml, scripts.yaml, los distintos tipos de !include, packages y secrets.yaml con una pregunta práctica: qué estructura espera cada lugar. Reorganizarás la configuración manual del curso sin presentar la división de archivos como un objetivo por sí mismo.
Disponible el 6 de noviembre.
Capítulo 11 — Cuando el YAML no funciona
Resolverás una clínica de errores preparada para separar sintaxis YAML, esquema de Home Assistant, referencias, lógica y plantillas frágiles. Utilizarás la comprobación de configuración, las trazas, los registros, los estados y el editor de plantillas para reunir pruebas antes de modificar nada.
Disponible el 13 de noviembre.
Capítulo 12 — Proyecto final: construye y explica la automatización completa de la casa
El curso terminará con una automatización de bienvenida que combina presencia, puerta, modo nocturno, temperatura, variables, decisiones y un script reutilizable. No bastará con que funcione: prepararás un plan de pruebas y tendrás que poder explicar por qué se ejecuta cada camino.
Disponible el 20 de noviembre.
Qué necesitas antes de empezar
Necesitas una instalación funcional de Home Assistant y acceso suficiente para crear una copia de seguridad, copiar el package del laboratorio y validar la configuración. No necesitas saber programar, haber editado configuration.yaml ni disponer de los dispositivos utilizados en los ejemplos.
Trabajaremos con la interfaz y con YAML como dos vistas complementarias. Cuando la interfaz reduzca el riesgo o ayude a descubrir opciones, empezaremos allí. Cuando necesitemos comparar estructuras, trasladar un ejemplo o diagnosticar una línea concreta, abriremos YAML.
Si partes de cero, comienza por el primer capítulo y respeta el orden. Si ya has utilizado YAML, los primeros ejercicios te servirán para comprobar si reconoces realmente la estructura o si hasta ahora dependías de copiar bloques completos.
Continúa leyendo
Siguiente guía relacionada · 15 min de lectura
YAML en Home Assistant desde cero: qué necesitas aprender de verdad
Es posible utilizar Home Assistant durante mucho tiempo sin abrir configuration.yaml. Puedes añadir integraciones, crear áreas, preparar un panel e incluso construir automatizaciones desde…
Continuar con este artículo