{"id":21201797,"url":"https://github.com/alumnium-hq/alumnium","last_synced_at":"2026-05-13T15:03:48.167Z","repository":{"id":260918826,"uuid":"879790282","full_name":"alumnium-hq/alumnium","owner":"alumnium-hq","description":"Pave the way towards AI-powered test automation.","archived":false,"fork":false,"pushed_at":"2024-11-20T06:00:51.000Z","size":363,"stargazers_count":7,"open_issues_count":1,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-11-20T06:27:36.796Z","etag":null,"topics":["ai","llm","selenium","test-automation","testing"],"latest_commit_sha":null,"homepage":"https://alumnium.ai","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alumnium-hq.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-28T14:53:36.000Z","updated_at":"2024-11-20T05:59:53.000Z","dependencies_parsed_at":"2024-11-20T06:23:37.204Z","dependency_job_id":"897f68ac-5750-421d-a5be-0f54d1274e28","html_url":"https://github.com/alumnium-hq/alumnium","commit_stats":null,"previous_names":["alumnium-hq/alumnium"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alumnium-hq%2Falumnium","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alumnium-hq%2Falumnium/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alumnium-hq%2Falumnium/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alumnium-hq%2Falumnium/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alumnium-hq","download_url":"https://codeload.github.com/alumnium-hq/alumnium/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225482454,"owners_count":17481211,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","llm","selenium","test-automation","testing"],"created_at":"2024-11-20T20:11:09.916Z","updated_at":"2026-05-13T15:03:48.162Z","avatar_url":"https://github.com/alumnium-hq.png","language":"Python","funding_links":[],"categories":["🛠️ Developer Tools","\u003ca name=\"Python\"\u003e\u003c/a\u003ePython"],"sub_categories":[],"readme":"\u003ch1\u003e\n    \u003cp align=\"center\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/alumnium-hq/alumnium.github.io/efb2afaf0ced7ec07c241445e7b381914281edaf/src/assets/logo.svg\" height=\"128\" alt=\"Logo\" /\u003e\n        \u003cbr /\u003e\n        Alumnium\n    \u003c/p\u003e\n\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\n    End-to-end testing with AI\n    \u003cbr /\u003e\n    \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e\n    ·\n    \u003ca href=\"#quick-start\"\u003eQuick Start\u003c/a\u003e\n    ·\n    \u003ca href=\"https://alumnium.ai/docs/\"\u003eDocumentation\u003c/a\u003e\n\u003c/p\u003e\n\nAlumnium 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.\n\nhttps://github.com/user-attachments/assets/b1a548c0-f1e1-4ffe-bec9-d814770ba2ae\n\n## Installation\n\n### Python\n\n```bash\npip install alumnium\n```\n\n### TypeScript\n\n```bash\nnpm install alumnium\n```\n\n### MCP\n\n```bash\n# Using npx:\nclaude mcp add alumnium --env OPENAI_API_KEY=... -- npx alumnium mcp\n\n# Using uvx:\nclaude mcp add alumnium --env OPENAI_API_KEY=... -- uvx alumnium mcp\n```\n\nRefer to [documentation][8] for installation details on other MCP clients.\n\n## Quick Start\n\n### Python\n\n```python\nimport os\nfrom alumnium import Alumni\nfrom selenium.webdriver import Chrome\n\nos.environ[\"OPENAI_API_KEY\"] = \"...\"\n\ndriver = Chrome()\ndriver.get(\"https://search.brave.com\")\n\nal = Alumni(driver)\nal.do(\"type 'selenium' into the search field, then press 'Enter'\")\nal.check(\"page title contains selenium\")\nal.check(\"search results contain selenium.dev\")\nassert al.get(\"atomic number\") == 34\n\nal.quit()\n```\n\n### TypeScript\n\n```ts\nimport { Alumni } from \"alumnium\";\nimport { Builder } from \"selenium-webdriver\";\n\nprocess.env.OPENAI_API_KEY = \"...\";\n\nconst driver = await new Builder().forBrowser(\"chrome\").build();\nconst al = new Alumni(driver);\n\nawait driver.get(\"https://search.brave.com\");\nawait al.do(\"type 'selenium' into the search field, then press 'Enter'\");\nawait al.check(\"page title contains selenium\");\nawait al.check(\"search results contain selenium.dev\");\nconsole.assert((await al.get(\"atomic number\")) === 34);\n\nawait al.quit();\n```\n\nCheck out [documentation][1] and more [Python][2] and [TypeScript][6] examples!\n\n### MCP\n\n1. Run your agent (Claude Code).\n2. Tell it to open the URL and test your application.\n\n## Contributing\n\nSee the [contributing guidelines][4] for information on how to get involved in the project and develop locally.\n\n## Acknowledgments\n\n[\u003cimg alt=\"TestMu AI\" src=\"https://assets.testmuai.com/resources/images/testmu-ai/footer/footerLogo.svg\" width=\"150\"\u003e][5]\n\nAlumnium is a member of the [TestMu AI][5] Open Source Program, which supports the project community and development with the necessary tools. Thank you! 💚\n\n[1]: https://alumnium.ai/docs/\n[2]: packages/python/examples/\n[3]: https://alumnium.ai/docs/getting-started/configuration/\n[4]: ./CONTRIBUTING.md\n[5]: https://www.testmuai.com/\n[6]: packages/typescript/examples/\n[7]: https://alumnium.ai/blog/webvoyager-benchmark/\n[8]: https://alumnium.ai/docs/guides/mcp/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falumnium-hq%2Falumnium","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falumnium-hq%2Falumnium","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falumnium-hq%2Falumnium/lists"}