Alumnium

基于 AI 的端到端测试
安装 · 快速入门 · 文档

Alumnium 是一个用于端到端测试的 AI 原生库和 MCP。它基于现有的测试自动化生态系统，简化了与应用程序的交互，并提供了更强大的断言验证机制。它支持 Appium、Playwright 或 Selenium，并为您提供最先进的功能。

https://github.com/user-attachments/assets/b1a548c0-f1e1-4ffe-bec9-d814770ba2ae

安装

Python

pip install alumnium

TypeScript

npm install alumnium

MCP

# Using npx:
claude mcp add alumnium --env OPENAI_API_KEY=... -- npx alumnium mcp

# Using uvx:
claude mcp add alumnium --env OPENAI_API_KEY=... -- uvx alumnium mcp

有关其他 MCP 客户端的安装详情，请参阅 documentation。

快速开始

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

al.quit()

TypeScript

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

process.env.OPENAI_API_KEY = "...";

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.assert((await al.get("atomic number")) === 34);

await al.quit();

Java

import ai.alumnium.Alumni;
import org.openqa.selenium.chrome.ChromeDriver;

class AlumniumTest {
    public static void main(String...args) {
        ChromeDriver driver = new ChromeDriver();
        Alumni alumni = new Alumni(driver);
        driver.get("https://search.brave.com");
        alumni.act("type 'selenium' into the search field, then press 'Enter'");
        alumni.check("page title contains selenium");
        alumni.check("search results contain selenium.dev");
        alumni.quit();
    }
}

查看文档以及更多Python和TypeScript示例！

MCP

1. 运行你的 agent（Claude Code）。
2. 告诉它打开 URL 并测试你的应用程序。

贡献

请参阅贡献指南了解如何参与该项目并在本地进行开发。

致谢

Alumnium 是 TestMu AI 开源计划的成员，该计划通过提供必要的工具来支持项目社区和开发。感谢！💚