GitHub - alumnium-hq/alumnium: End-to-end testing with AI

End-to-end testing with AI
Installation · Quick Start · Documentation

Alumnium is an AI-native library and MCP for end-to-end testing. It builds upon the existing test automation ecosystem and simplifies interactions with applications, providing more robust mechanisms for verifying assertions. It works with Appium, Playwright, or Selenium and gives you state-of-the-art capabilities.

overview.mp4

Installation

Python

TypeScript

MCP

claude mcp add alumnium --env OPENAI_API_KEY=... -- uvx --from alumnium alumnium-mcp

Refer to documentation for installation details on other MCP clients.

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

Run Alumnium server:

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

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!

MCP

Run your agent (Claude Code).
Tell it to open URL and test your application.

Contributing

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

Acknowledgments

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