k0lmenaAutomation Framework

Automatizá web, APIs, mobile y performance con un solo framework.

k0lmena es un framework de automatización open source basado en Playwright. Escribís los escenarios en Gherkin, los implementás en TypeScript y obtenés reportes HTML listos para compartir.

  • open source · ISC
  • TypeScript
  • Playwright
  • Cucumber / BDD
  • Appium
  • k6 · Artillery
4tipos de prueba
3navegadores
1sintaxis para todo
$0en licencias
qué incluye

Cuatro tipos de prueba en el mismo repositorio

Misma estructura, misma sintaxis y mismos reportes, cambie lo que cambie el motor por debajo.

TipoMotorQué cubre
Front / E2EPlaywright + CucumberInterfaz sobre Chromium, Firefox y WebKit.
APIAxios + CucumberEndpoints HTTP con validación de respuestas.
MobileWebdriverIO + AppiumApps móviles en local, emulador o BrowserStack.
PerformanceArtillery + k6Carga, estrés, soak y picos, por HTTP o navegador.
features

Lo que te ahorra en el día a día

Auto-healing de locators

Aprende selectores alternativos cuando una acción funciona y los usa cuando el original se rompe. Cada curación queda en el reporte.

Reportes HTML por tipo

Front, API, mobile y performance generan su propio reporte, incluido el de Artillery en la nube.

Evidencia ante fallos

Screenshot, logs de consola del navegador y trace de Playwright adjuntos automáticamente.

Ejecución en paralelo

Corré las suites de front y API con N workers o uno por CPU con una sola variable.

Herramientas de apoyo

Generador de locators, tester de links rotos, grabador con Playwright codegen y modo debug.

Listo para CI/CD

Workflow de GitHub Actions sobre el contenedor oficial de Playwright, con reportes como artifacts.

cómo se escribe un test

Escenarios legibles para todo el equipo

El escenario se escribe en Gherkin y los steps usan funciones reutilizables que ya traen auto-healing integrado.

src/front-test/features/login.feature
Feature: Login
  @Smoke
  Scenario: Ingreso con usuario válido
    Given que estoy en la página de login
    When completo el usuario con "[email protected]"
    And hago clic en "Ingresar"
    Then veo el panel principal
src/front-test/steps/login.tests.ts
When("completo el usuario con {string}",
  async (user) => {
    await getByPlaceholderAndFillIt(
      page, "Usuario", user);
  });

When("hago clic en {string}",
  async (name) => {
    await getElementByRoleAndClickIt(
      page, "button", name);
  });

Ver cómo agregar un test nuevo

video

Miralo funcionando

Un recorrido por la instalación, la estructura del proyecto y la ejecución de pruebas, en el canal de QARMY.

Video tutorial de k0lmena Automation Framework
para empresas

Lo implementamos con tu equipo

Instalamos el framework en tu repositorio, automatizamos tus flujos críticos, lo dejamos corriendo en tu CI/CD y capacitamos a tu gente. Todo a medida.

Puesta en marcha

Estructura del proyecto, configuración por ambiente, perfiles de Cucumber y convenciones para tu equipo.

Automatización de flujos críticos

Smoke y regresión de web, API y mobile, más pruebas de performance con los umbrales que defina tu negocio.

CI/CD

Pipeline con ejecución en paralelo, reportes como artifacts y evidencias ante cada fallo.

Capacitación

Formación práctica para que tu equipo escriba y mantenga sus propias pruebas.

faq

Preguntas frecuentes

¿Qué es k0lmena Automation Framework?
Es un framework open source de automatización de pruebas basado en Playwright y TypeScript que reúne pruebas de interfaz, APIs, mobile y performance en un mismo repositorio, con escenarios en Gherkin (BDD) y reportes HTML.
¿Es gratis?
Sí. Es open source con licencia ISC y se descarga desde GitHub.
¿Qué necesito para usarlo?
Node.js (versión LTS recomendada) y, opcionalmente, Visual Studio Code. Para mobile, Appium y un emulador o dispositivo (o una cuenta de BrowserStack). Para k6, el binario se instala con un script incluido.
¿Qué es el auto-healing?
Es la capacidad de recuperar locators rotos. En modo learn el framework guarda selectores alternativos de cada elemento; en modo heal, si el selector original falla, prueba los candidatos hasta encontrar uno que funcione y lo informa en el reporte.
¿Se puede correr en CI/CD?
Sí. Incluye un workflow de GitHub Actions que corre front, API y performance dentro del contenedor oficial de Playwright y publica los reportes como artifacts.
¿Cómo se relaciona con K0lmenIA?
K0lmenIA trae k0lmena integrado: sus agentes mapper recorren tu aplicación y escriben los .feature, steps y locators por vos. Después la suite corre con npm, sin IA y sin tokens.
hablemos

¿Querés automatizar tus pruebas con k0lmena?

Contanos qué querés automatizar y te ayudamos a dejarlo andando en tu equipo.