Alumnium

Pave the way towards AI-powered test automation.
Installation · Quick Start · Documentation

Alumnium is an experimental project that builds upon the existing test automation ecosystem, offering a higher-level abstraction for testing. It simplifies interactions with applications and provide more robust mechanisms for verifying assertions. It works with Appium, Playwright, or Selenium.

overview.mp4

Currently in the very early stages of development and not recommended for production use.

Installation

Python

pip install alumnium

TypeScript

npm install alumnium

Quick Start

Python

import os
from alumnium import Alumni
from selenium.webdriver import Chrome

os.environ["OPENAI_API_KEY"] = "..."

driver = Chrome()
driver.get("https://search.brave.com")

al = Alumni(driver)
al.do("type 'selenium' into the search field, then press 'Enter'")
al.check("page title contains selenium")
al.check("search results contain selenium.dev")
assert al.get("atomic number") == 34

TypeScript

1. Run Alumnium server:

docker run --rm -p 8013:8013 -e OPENAI_API_KEY=... alumnium/alumnium

2. Run your tests:

import { Alumni } from "alumnium";
import { Builder } from "selenium-webdriver";

const driver = await new Builder().forBrowser("chrome").build();
const al = new Alumni(driver);

await driver.get("https://search.brave.com");
await al.do("type 'selenium' into the search field, then press 'Enter'");
await al.check("page title contains selenium");
await al.check("search results contain selenium.dev");
console.log("Atomic number:", await al.get("atomic number")); // 34

await al.quit();

Check out documentation and more Python and TypeScript examples!

Contributing

See the contributing guidelines for information on how to get involved in the project and develop locally.

Acknowledgments

Alumnium is a member of LambdaTest Open Source Program, which supports the project community and development with the necessary tools. Thank you! 💚