https://github.com/alumnium-hq/alumnium
End-to-End Testing with AI for Agents and Engineers
https://github.com/alumnium-hq/alumnium
ai appium java javascript llm playwright python selenium test-automation testing typescript webdriverio
Last synced: 6 days ago
JSON representation
End-to-End Testing with AI for Agents and Engineers
- Host: GitHub
- URL: https://github.com/alumnium-hq/alumnium
- Owner: alumnium-hq
- License: mit
- Created: 2024-10-28T14:53:36.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2026-08-15T06:13:25.000Z (19 days ago)
- Last Synced: 2026-08-15T07:28:46.909Z (18 days ago)
- Topics: ai, appium, java, javascript, llm, playwright, python, selenium, test-automation, testing, typescript, webdriverio
- Language: TypeScript
- Homepage: https://alumnium.ai
- Size: 64.3 MB
- Stars: 991
- Watchers: 11
- Forks: 96
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
- Agents: AGENTS.md
- Claude: CLAUDE.md
Awesome Lists containing this project
- awesome-github-projects - alumnium - End-to-End Testing with AI for Agents and Engineers ⭐1,003 `TypeScript` 🔥 (🛠️ Developer Tools)
- awesome - alumnium-hq/alumnium - Pave the way towards AI-powered test automation. (<a name="Python"></a>Python)
README
Alumnium
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][7] capabilities.
https://github.com/user-attachments/assets/b1a548c0-f1e1-4ffe-bec9-d814770ba2ae
## Installation
### Python
```bash
pip install alumnium
```
### TypeScript
```bash
npm install alumnium
```
### MCP
```bash
# 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
```
Refer to [documentation][8] for installation details on other MCP clients.
## Quick Start
### Python
```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
```ts
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
```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();
}
}
```
Check out [documentation][1] and more [Python][2] and [TypeScript][6] examples!
### MCP
1. Run your agent (Claude Code).
2. Tell it to open the URL and test your application.
## Contributing
See the [contributing guidelines][4] for information on how to get involved in the project and develop locally.
## Acknowledgments
[
][5]
Alumnium is a member of the [TestMu AI][5] Open Source Program, which supports the project community and development with the necessary tools. Thank you! 💚
[1]: https://alumnium.ai/docs/
[2]: packages/python/examples/
[3]: https://alumnium.ai/docs/getting-started/configuration/
[4]: ./CONTRIBUTING.md
[5]: https://www.testmuai.com/
[6]: packages/typescript/examples/
[7]: https://alumnium.ai/blog/webvoyager-benchmark/
[8]: https://alumnium.ai/docs/guides/mcp/