Hola a todos. Hoy quiero contarles en detalle sobre k0lmena, un proyecto que venimos construyendo desde QARMY junto a miembros de la comunidad Underc0de y que ya se convirtió en una suite completa de herramientas para el día a día del QA.
La idea nació de algo que vimos una y otra vez en los cursos y en los proyectos con clientes: cada vez que un equipo quería empezar a automatizar, tenía que armar un framework desde cero, elegir librerías, pelearse con la configuración y recién después escribir la primera prueba. Y cuando querían ordenar sus casos de prueba, se encontraban con herramientas pagas que cobran por usuario. k0lmena es nuestra respuesta: herramientas gratuitas, open source y pensadas por QAs para QAs.
¿Qué es k0lmena?
k0lmena empezó como un framework de automatización y con el tiempo creció hasta convertirse en una suite de tres herramientas que se complementan:
- k0lmena Automation Framework: para automatizar pruebas de interfaz, APIs, mobile y performance desde un solo proyecto.
- k0lmenaTMT: un gestor de casos de prueba (Test Management Tool) que instalás en tu propia máquina o servidor.
- k0lmenIA: un equipo de agentes de IA que acelera las tareas del QA manual, desde analizar historias de usuario hasta armar el informe de cierre.
Podés usar cada una por separado, pero donde más rinden es juntas, porque cubren distintas etapas del trabajo de calidad:
k0lmena Automation Framework
Es el corazón de la suite: un framework de automatización listo para usar que reúne en un mismo repositorio las herramientas más usadas del mercado, ya integradas y configuradas. Clonás el proyecto, instalás dependencias y empezás a escribir pruebas el mismo día.
Qué podés probar
| Tipo de prueba | Tecnología | Dónde vive |
|---|---|---|
| Interfaz / E2E | Playwright + Cucumber (BDD) | src/front-test/ |
| APIs | Axios + Cucumber | src/api-test/ |
| Mobile | WebdriverIO + Appium | src/mobile-test/ |
| Carga y performance | Artillery + k6 | src/performance-test/ |
Todo está escrito en TypeScript sobre Node.js, y los escenarios se escriben en Gherkin, así que cualquier persona del equipo (incluso alguien de negocio) puede leer qué se está probando. Un escenario se ve así:
@Smoke
Feature: Login
Scenario: Ingreso con credenciales válidas
Given que estoy en la página de login
When ingreso el usuario "[email protected]" y la contraseña correcta
Then veo el dashboard con mi nombre de usuarioLos comandos que más vas a usar
| Comando | Qué hace |
|---|---|
npm run test | Corre los escenarios marcados con @Smoke. |
npm run allTests | Ejecuta todas las suites de UI. |
npm run report | Genera el reporte HTML completo. |
npm run apiTest | Corre los escenarios de APIs (@API). |
npm run mobile | Ejecuta la suite mobile con WebdriverIO. |
npm run load | Lanza una prueba de carga con Artillery. |
npm run k6:stress | Escenarios de k6: también hay smoke, soak y spike. |
Si te interesa la parte de carga, en el artículo de pruebas de performance y stress explico qué es cada uno de esos tipos de prueba y qué métricas mirar.
Herramientas extra que te ahorran tiempo
- Crawler (
npm run crawler): recorre la aplicación y genera los localizadores para tus Page Objects. - Link tester (
npm run link-tester): detecta links e imágenes rotas. - Grabador (
npm run record): abre el codegen de Playwright para grabar acciones y convertirlas en código. - Auto-healing: cuando un selector deja de funcionar porque cambió el HTML, el framework puede usar alternativas que aprendió en ejecuciones anteriores. Se activa con la variable
K0LMENA_AUTO_HEALING.
Configuración por entorno
La configuración vive en un archivo .env, así podés apuntar las mismas pruebas a desarrollo, QA o staging sin tocar el código:
BASEURL=https://staging.miapp.com
BROWSER=chromium # chromium, firefox o webkit (vacío = los tres)
HEADLESS=true
PARALLEL=on # ejecución en paralelo
TRACE=on-failure # guarda trazas solo cuando algo fallaEsto es lo que permite integrarlo fácilmente en un pipeline de CI/CD: cada entorno define sus variables y el framework hace el resto.
Cómo empezar
- Instalá Node.js (y VS Code, recomendado).
- Cloná o descargá el repositorio de k0lmena.
- Corré
npm instally despuésnpx playwright install. - Configurá tu
.envy ejecutánpm run test.
La documentación completa está en k0lmena.com/automation.
k0lmenaTMT: gestión de casos de prueba
En el artículo de la plantilla de casos de prueba les contaba que, cuando no hay una herramienta de gestión, una planilla alcanza. Pero cuando el proyecto crece, la planilla se queda corta: varias personas editando, versiones que se pisan, sin historial y sin métricas. Ahí entra k0lmenaTMT.
Es un gestor de casos de prueba gratuito que se levanta con Docker, en tu máquina o en tu propia infraestructura. Con él podés:
- Crear, organizar e importar casos de prueba.
- Agruparlos en suites y planes por módulo, flujo o release.
- Ver métricas, historial y el estado general del proyecto de un vistazo.
- Manejar varios proyectos desde una sola instalación.
- Sumar usuarios ilimitados, sin costo extra.
Y lo más importante: es gratis de verdad. No hay versión premium ni funciones bloqueadas. Es ideal para equipos chicos que no quieren pagar licencias por usuario, para consultoras que manejan varios clientes y para empresas que prefieren tener sus datos en su propia infraestructura.
Para instalarlo, descargá k0lmenaTMT y levantalo con Docker. Más información en k0lmena.com/tmt.
k0lmenIA: agentes de IA para QA
La pieza más nueva de la suite. k0lmenIA es un equipo de agentes de IA para Claude Code que automatiza buena parte del trabajo repetitivo del QA manual. Si leyeron el artículo sobre QA agéntico, esta es la forma práctica de empezar a usarlo.
El funcionamiento es simple: dejás tu material (historias de usuario, contratos de API, notas de un bug) en la carpeta input/, le pedís en español lo que necesitás y el agente indicado deja el entregable en output/. No hace falta saber programar.
Estos son los agentes que incluye:
| Agente | Qué hace |
|---|---|
| Analista de historias | Detecta ambigüedades en las historias de usuario y propone preguntas para el refinamiento. |
| Planificador de estrategia | Arma el plan de pruebas como un dashboard HTML. |
| Casos de prueba manuales | Genera casos en Excel y Markdown, con reporte de cobertura. |
| Escenarios BDD | Escribe escenarios Gherkin en español. |
| Reporte de bugs | Convierte tus notas en reportes de bugs profesionales con tu plantilla. |
| Datos de prueba | Crea datos realistas en Markdown o CSV. |
| Casos de prueba de APIs | Genera casos a partir del contrato de la API. |
| Ejecución E2E | Corre las pruebas en un navegador real con Playwright y genera un reporte HTML. |
| Ejecución de APIs | Ejecuta colecciones de Postman con Newman y reporta los resultados. |
| Reporte de resultados | Arma un dashboard HTML con los resultados de la ejecución. |
| Informe de cierre | Resume la ronda de pruebas con una recomendación go / no-go. |
Un detalle clave: vos seguís a cargo. Los agentes proponen y vos revisás y decidís en cada paso. La IA acelera, pero el criterio sigue siendo del QA.
Qué necesitás
- Claude Code con una cuenta Pro, Max, Team o Enterprise.
- VS Code (recomendado), Python 3 y Node.js 18 o superior.
- Opcional: Playwright y Newman, si querés que los agentes ejecuten pruebas.
La instalación, los ejemplos y la documentación de cada agente están en el repositorio de k0lmenIA, con licencia MIT.
Cómo combinarlas en un proyecto real
Para que se entienda cómo encajan, imaginemos el recorrido de una historia de usuario nueva:
- Refinamiento: el analista de historias de k0lmenIA revisa la HU y te devuelve las ambigüedades y preguntas para llevar a la reunión.
- Diseño: con la HU ya clara, el agente de casos manuales genera los casos en Excel y el de BDD escribe los escenarios en Gherkin.
- Gestión: importás esos casos en k0lmenaTMT y los agrupás en la suite del release.
- Automatización: los escenarios Gherkin pasan al framework k0lmena, donde se implementan los pasos y se suman a la regresión.
- Ejecución: la regresión corre en el pipeline en cada despliegue; si encontrás un bug, el agente de reportes lo documenta con tu plantilla.
- Cierre: el informe de cierre resume la ronda y da una recomendación go / no-go, mientras k0lmenaTMT guarda el historial y las métricas.
Nada de esto es obligatorio: hay equipos que solo usan el framework, y otros que arrancan por el TMT porque todavía no automatizan. La suite está pensada para que tomes lo que te sirva.
Preguntas frecuentes
¿Es realmente gratis?
Sí. Las tres herramientas son gratuitas y el código es abierto. No hay planes pagos ni funciones bloqueadas.
¿Necesito saber programar?
Depende de la herramienta. k0lmenIA y k0lmenaTMT no requieren programar. El framework sí requiere conocimientos básicos de TypeScript para implementar los pasos, aunque Gherkin, el grabador y el crawler bajan mucho la barrera de entrada.
¿Puedo usarlo en mi empresa?
Sí. Podés usarlo en proyectos personales o comerciales, modificarlo y adaptarlo a tus necesidades. Y si en tu empresa necesitan ayuda para implementarlo, desde QARMY ofrecemos servicios de QA.
¿Cómo puedo colaborar?
Probándolo, reportando errores, proponiendo mejoras o mandando pull requests en GitHub. k0lmena crece gracias a la comunidad.
Sumate a la comunidad
k0lmena es un proyecto hecho por y para la comunidad. Si lo probás, nos encantaría saber qué te pareció, qué le falta y cómo lo estás usando. Podés sumarte al grupo de WhatsApp de k0lmena para hacer consultas y enterarte antes que nadie de las novedades, o ver todo en un solo lugar en la página de k0lmena.
¡Nos vemos en el próximo artículo!